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