phrozenbyte / pico-file-prefixes
这是 Pico 官方的文件前缀插件,用于从页面 URL 中删除文件前缀。Pico 是一个极其简单、速度极快、基于平面文件的 CMS。
Requires
- php: >=5.3.0
README
这是 Pico 官方文件前缀插件的仓库。
Pico 是一个极其简单、速度极快、基于平面文件的 CMS。更多信息请访问 http://picocms.org/。
PicoFilePrefixes 从页面 URL 中删除文件前缀(例如日期标识符)。例如,博客文章 content/blog/20160707.visit-us-on-github.md 通常对应页面 URL http://example.com/pico/blog/20160707.visit-us-on-github,但是通过安装此插件,文章可以通过更友好的 URL http://example.com/pico/blog/visit-us-on-github 访问。这使得在文件系统中组织您的网站页面比以往任何时候都要容易。
安装
您可以使用 Composer 安装 PicoFilePrefixes,或者使用单个 PHP 插件文件。我们建议尽可能使用 Composer,因为它可以更容易地保持插件更新。
如果您使用基于 Composer 的 Pico 安装并希望删除或安装 PicoFilePrefixes,只需打开服务器上的 shell 并导航到 Pico 的安装目录(例如 /var/www/html/pico/)。运行 composer remove phrozenbyte/pico-file-prefixes 删除 PicoFilePrefixes,或运行 composer require phrozenbyte/pico-file-prefixes(通过 Packagist.org)安装 PicoFilePrefixes。
如果您确实希望使用单个 PHP 插件文件安装 PicoFilePrefixes,下载最新版本 并将 PicoFilePrefixes.php 文件上传到您的 Pico 安装目录下的 plugins 目录(例如 /var/www/html/pico/plugins/)。
PicoFilePrefixes 需要 Pico 2.0+
配置
默认情况下,该插件递归地删除 content/blog/ 目录中所有文件的文件前缀。您可以通过更改 config/config.php 中的 PicoFilePrefixes.recursiveDirs 和/或 PicoFilePrefixes.dirs 配置变量(两者都期望 YAML 列表)来指定其他目录。前者递归解析目录中的所有文件(即包括所有子文件夹),而后者仅解析此特定目录中的文件。默认配置如下所示
PicoFilePrefixes: recursiveDirs: - blog dirs: []
如果您想为 content/showcase/ 目录额外启用插件,请尝试以下配置
PicoFilePrefixes: recursiveDirs: - blog - showcase dirs: []
如果您想为任何文件夹启用插件,请尝试以下
PicoFilePrefixes: recursiveDirs: - . dirs: []
要仅针对 content/misc/ 目录中的页面启用插件(即不包括如 content/misc/sub/ 这样的子文件夹),请尝试以下
PicoFilePrefixes: recursiveDirs: [] dirs: - misc