phrozenbyte/pico-file-prefixes

这是 Pico 官方的文件前缀插件,用于从页面 URL 中删除文件前缀。Pico 是一个极其简单、速度极快、基于平面文件的 CMS。

v2.0.0 2018-07-24 17:59 UTC

This package is auto-updated.

Last update: 2024-09-12 10:18:04 UTC


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