phrozenbyte / pico-excerpt
这是 Pico 官方的 PicoExcerpt 插件。Pico 是一个非常简单、速度极快、基于平面文件的 CMS。
Requires
- php: >=5.3.0
- phrozenbyte/pico-parse-pages-content: ^1.0
- picocms/pico: ^1.0|^2.0
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),我们引入了 PicoParsePagesContent
和 PicoExcerpt
插件。这两个插件已在 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
本身没有配置选项。