phrozenbyte/pico-excerpt

此包已被废弃,不再维护。未建议替代包。

这是 Pico 官方的 PicoExcerpt 插件。Pico 是一个非常简单、速度极快、基于平面文件的 CMS。

安装: 30

依赖: 0

建议者: 0

安全: 0

星星: 1

关注者: 1

分支: 0

类型:pico-plugin

v1.1.0 2018-06-24 21:28 UTC

This package is auto-updated.

Last update: 2022-02-01 13:13:46 UTC


README

这是 Pico 官方 PicoExcerpt 插件的仓库。

Pico 是一个非常简单、速度极快、基于平面文件的 CMS。更多详情请访问 http://picocms.org/

此插件仅出于历史原因存在,不应使用!

PicoExcerpt 是一个简单的插件,它创建所有页面的摘要并使用 {{ page.excerpt }} 使其可用。强烈不建议安装此插件,因为它依赖于 Pico 的官方 PicoParsePagesContent 插件,该插件会对您网站的性能产生重大负面影响。

Pico 开始解析所有页面的 Markdown 内容(见 PicoParsePagesContent)的主要原因是为了自动生成页面摘要。后来我们意识到这种方法是错误的,并开始寻找替代方案——我们认为我们找到了一个更好的解决方案。我们建议放弃自动生成摘要的概念。相反,您应该使用 Description 元标题来自己编写摘要。从 Pico 1.0 版本开始,您可以在 Markdown 文件中使用 %meta.*% 占位符,因此您无需重复输入——只需将 %meta.description% 添加到页面内容中,Pico 将用您的摘要替换它。

根据用户的要求,我们在 Pico 1.0 中删除了解析所有页面 Markdown 内容的功能。这显著提高了 Pico 的性能。为了保持向后兼容性(BC),我们引入了 PicoParsePagesContentPicoExcerpt 插件。这两个插件已在 Pico 2.0 默认安装中删除,但您仍然可以手动安装它们。

安装

如果您正在使用基于 composer 的 Pico 安装(例如 picocms/pico-composer),只需在您的服务器上打开一个 shell,导航到 Pico 的安装目录(例如 /var/www/html),然后运行 composer require phrozenbyte/pico-excerpt(通过 Packagist.org)。就这样!

如果您正在使用 Pico 的某个预构建发布包,您必须首先安装 PicoParsePagesContent 插件。安装 PicoParsePagesContent 后,在您的服务器上 Pico 的安装目录(例如 /var/www/html)中创建一个空的 plugins/PicoExcerpt 目录。然后下载 PicoExcerpt 的最新源代码包,并将所有包含的文件(特别是 PicoExcerpt.php)上传到该 plugins/PicoExcerpt 目录(结果为 plugins/PicoExcerpt/PicoExcerpt.php)。

PicoExcerpt 需要 Pico 1.0+

配置

由于所需的 PicoParsePagesContent 插件会对性能产生重大负面影响,因此 PicoExcerpt 默认禁用。您可以通过将以下内容添加到您的 config/config.yml 来启用插件

PicoExcerpt.enabled: true

PicoExcerpt 本身没有配置选项。