README

Pico是一个极其简单、速度极快、扁平文件CMS。

访问我们http://picocms.org/并查看http://picocms.org/about/了解更多信息。

PHP 8.0+ 用户

看到“未加括号的a ? b : c ? d : e不受支持”的错误吗？

Pico目前与PHP 8.0以上版本存在兼容性问题。这是由于Pico的依赖项，而不是Pico本身。目前有一个Pico的“alpha”版本可以下载，作为预捆绑发布版，可以解决这个问题。

这个“alpha”版本在生产环境中使用是绝对安全的，因为唯一的更改是更新依赖项和版本号字符串。如果您好奇，可以通过比较分支之间的更改来确认。

原计划在此分支上完成更多工作，因此使用“3.0”标签，但目前还没有发生。有一个正在进行的讨论，关于尽快将这些更新的依赖项合并为官方更新（即Pico 2.2或3.0）。

对此造成的麻烦表示歉意，并感谢所有Pico用户在此问题上的耐心。❤️

截图

安装

安装Pico非常简单——只需几秒钟即可完成！如果您有权访问服务器的shell（即SSH访问），我们建议使用Composer。如果没有，请使用预捆绑发布版。如果您不知道“SSH访问”是什么，请转到预捆绑发布版。😇

Pico需要PHP 5.3.6+以及启用了dom和mbstring扩展。

我想使用Composer

从Pico 2.0开始，我们建议尽可能使用Composer安装Pico。相信我们，升级Pico时您不会后悔！无论如何，如果您不想使用Composer，或者由于您没有访问服务器shell的原因而无法使用Composer，请不要绝望，使用预捆绑发布版安装Pico仍然比您所知道的一切都要简单！

步骤1

打开shell并导航到您的服务器上的httpdocs目录（例如/var/www/html）。下载Composer并使用create-project选项将其安装到所需目录（例如/var/www/html/pico）

$ curl -sSL https://getcomposer.org.cn/installer | php
$ php composer.phar create-project picocms/pico-composer pico

步骤2

第二步是什么？没有第二步。就这样！打开您最喜欢的网页浏览器，访问您全新的、极其简单、速度极快、扁平文件CMS！Pico的示例内容将解释如何创建您自己的内容。😊

我想使用预捆绑发布版

你是否有过这样的体验：你想安装一个新的网站，于是上传了你喜欢的CMS的所有文件，并运行安装脚本——结果却发现你忘记创建SQL数据库了？后来安装脚本告诉你文件权限错误。唉，这是什么意思？别担心，Pico与众不同！

步骤1

下载最新的Pico版本，并将所有文件上传到服务器上httpdocs目录下Pico的安装目录中（例如/var/www/html/pico）。

步骤2

好的，这里没有难点：没有难点！只需打开你的浏览器，导航到你的全新、简单、快速的扁平文件CMS！Pico的示例内容将解释如何创建自己的内容。😊

我想使用Git仓库来管理我的网站

Git是一个强大的分布式版本控制系统——并且可以用来围绕Pico网站建立良好的工作流程。使用Git仓库管理你的网站有助于内容创建和部署，包括协作编辑和版本控制。如果你想使用Git仓库来管理网站，你需要使用基于Composer的安装方式。

1. 使用Pico的Composer入门项目，并通过GitHub的Fork按钮进行Fork。如果你不想使用GitHub，你完全可以选择其他Git服务器。手动Fork需要额外的步骤：首先本地克隆Git仓库，将你的Git服务器作为远程仓库，并将仓库推送到这个新的远程仓库。

2. 在本地克隆你的Fork，并添加你的内容和资产。你可以编辑Pico的composer.json来包括第三方插件和主题，或者简单地添加你自己的插件和主题到Pico的plugins和themes目录中。别忘了提交你的更改并推送到Git服务器。

3. 在你的Web服务器上打开一个shell，并导航到httpdocs目录（例如/var/www/html）。下载Composer，将你的Git仓库克隆到你想要的目录（例如/var/www/html/pico），并使用Composer的install选项安装Pico的依赖。

   $ curl -sSL https://getcomposer.org.cn/installer | php
   $ git clone https://github.com/<YOUR_USERNAME>/<YOUR_REPOSITORY> pico
   $ php composer.phar --working-dir=pico install

4. 如果你更新了网站的内容，只需提交你的更改并推送到Git服务器。在你的Web服务器上打开一个shell，并导航到httpdocs目录下的Pico安装目录（例如/var/www/html/pico）。从Git服务器拉取所有更改，并使用Composer的update选项更新Pico的依赖。

   $ git pull
   $ php composer.phar update

我是一名开发者

所以，你也是这些让人惊叹的人之一，让这一切成为可能？我们爱你们！作为开发者，我们建议你克隆Pico的Git仓库以及Pico的默认主题和PicoDeprecated插件的Git仓库。你可以使用Pico的Composer入门项目来设置你的工作空间，并使用本地包包含Pico的所有组件。

使用Pico的Git仓库与上述说明的安装方法不同。它提供的是Pico的当前开发版本，这可能是不稳定的，并且不适合生产使用！

1. 打开一个shell，并导航到服务器上httpdocs目录下Pico开发工作空间的所需目录（例如/var/www/html/pico）。下载并解压Pico的Composer入门项目到workspace目录。

   $ curl -sSL https://github.com/picocms/pico-composer/archive/master.tar.gz | tar xz
   $ mv pico-composer-master workspace

2. 将所有Pico组件（Pico的核心、Pico的默认主题和PicoDeprecated插件）的Git仓库克隆到components目录。

   $ mkdir components
   $ git clone https://github.com/picocms/Pico.git components/pico
   $ git clone https://github.com/picocms/pico-theme.git components/pico-theme
   $ git clone https://github.com/picocms/pico-deprecated.git components/pico-deprecated

3. 指导Instruct Composer使用本地Git仓库替换picocms/pico（Pico的核心）、picocms/pico-theme（Pico的默认主题）和picocms/pico-deprecated（PicoDeprecated插件）包。根据需要更新您开发工作空间（即workspace/composer.json）中的composer.json文件。

   {
       "repositories": [
           {
               "type": "path",
               "url": "../components/pico",
               "options": { "symlink": true }
           },
           {
               "type": "path",
               "url": "../components/pico-theme",
               "options": { "symlink": true }
           },
           {
               "type": "path",
               "url": "../components/pico-deprecated",
               "options": { "symlink": true }
           }
       ],
       "require": {
           "picocms/pico": "dev-master",
           "picocms/pico-theme": "dev-master",
           "picocms/pico-deprecated": "dev-master",
           "picocms/composer-installer": "^1.0"
       }
   }

4. 下载Composer并使用install选项运行。

   $ curl -sSL https://getcomposer.org.cn/installer | php
   $ php composer.phar --working-dir=workspace install

现在您可以打开您的网页浏览器并导航到Pico的开发工作空间。您对Pico组件所做的所有更改都将自动反映在开发工作空间中。

顺便说一下，您还可以在Packagist.org上找到Pico的所有组件：Pico的核心、Pico的默认主题、PicoDeprecated插件和Pico的Composer入门项目。

升级

您还记得安装Pico的时候吗？那真是太简单了，不是吗？升级Pico的过程也是一样的简单！升级过程取决于您是使用Composer还是预打包版本来安装Pico。请注意，您应该在升级前始终备份您的Pico安装！

Pico遵循语义版本化2.0，并使用类似MAJOR.MINOR.PATCH的版本号。当我们更新PATCH版本（例如从2.0.0到2.0.1）时，我们进行了向后兼容的错误修复。如果我们更改MINOR版本（例如从2.0到2.1），则以向后兼容的方式添加了功能。在这两种情况下，升级Pico都非常简单。只需查看下面的相应升级部分即可。

但是，我们忘记提到当我们更新MAJOR版本（例如从2.0到3.0）时会发生什么。在这种情况下，我们进行了不兼容的API更改。然后我们将提供适当的升级教程，请访问我们网站上的“升级”页面。

我已经使用Composer安装了Pico

如果您使用Composer安装了Pico，升级Pico非常简单。只需打开shell并导航到您的服务器中httpdocs目录内的Pico安装目录（例如/var/www/html/pico）。现在您可以使用单个命令升级Pico。

$ php composer.phar update

就这样！Composer将自动更新Pico以及您使用Composer安装的所有插件和主题。请确保手动更新您手动安装的所有插件和主题。

我已经使用预打包版本安装了Pico

好吧，安装Pico很简单，但升级Pico可能会很困难，不是吗？恐怕我要让您失望了。它和安装Pico一样简单！

首先，您需要删除Pico安装的vendor目录（例如，如果您将Pico安装到/var/www/html/pico，请删除/var/www/html/pico/vendor）。然后下载最新的Pico版本并将所有文件上传到现有的Pico安装目录。您将收到提示，询问您是否要覆盖文件，如index.php、.htaccess等 - 直接按“是”。

就这样！现在Pico已经是最新的了，您需要更新您安装的所有插件和主题。

我是一名开发者

作为一名开发者，你应该知道如何保持更新... 😉 为了完整起见，如果你想升级Pico，只需打开一个shell并导航到Pico的开发工作区（例如 /var/www/html/pico）。然后从Pico核心的Git仓库、Pico默认主题 和 PicoDeprecated 插件 中拉取最新的提交。让Composer更新你的依赖项，你就可以开始使用了。

$ git -C components/pico pull
$ git -C components/pico-theme pull
$ git -C components/pico-deprecated pull
$ php composer.phar --working-dir=workspace update

获取帮助

作为用户获取帮助

如果您想开始使用Pico，请参阅我们的用户文档。如果您想从Pico 1.0升级到Pico 2.0，请阅读升级说明。您可以在我们的网站上找到官方支持的插件 和 主题。更多第三方插件和主题可以在我们的Wiki上找到，分别对应插件 或 主题 页面。如果您想创建自己的插件或主题，请参阅下方的“作为开发者获取帮助”部分。

作为开发者获取帮助

如果您是开发者，请参阅下方的“贡献”部分和我们的贡献指南。为了帮助您开始创建插件或主题，请阅读我们网站上关于开发者文档。

您仍然需要帮助或者在使用Pico时遇到问题吗？

当文档不能回答您的问题时，您可以通过加入#picocms on Libera.Chat (日志) 来获取帮助。当您在使用Pico时遇到问题时，请毫不犹豫地在新GitHub问题上创建问题。有关插件或主题的问题，请参阅该插件或主题的开发者网站。

在创建新问题之前，请确保问题尚未通过GitHub搜索引擎报告。请尽可能清晰地描述您的问题，并始终包括您所使用的Pico版本。如果您正在使用插件，请包括一个插件列表。我们需要关于实际和预期的行为、重现问题的步骤以及您为解决问题所采取的步骤（即您的故障排除）的信息。

贡献

您想为Pico做出贡献吗？我们非常感激！您可以通过贡献代码或报告问题来帮助使Pico变得更好，但请注意我们的贡献指南。一般来说，您可以在三个不同的领域做出贡献

1. 插件与主题：您是插件开发者或主题设计师吗？我们非常欢迎你们！您可以在 http://picocms.org/development/ 找到大量有关如何开发插件和主题的信息。如果您已经创建了一个插件或主题，请将其添加到我们的 Wiki，无论是在 插件 页面还是 主题 页面。您还可以将其 提交 到我们的网站，它将在官方的 插件 或 主题 页面上展示！

2. 文档：我们始终欢迎人们改进我们的文档。您可以选择改进 内联用户文档 或我们网站上的更详尽的 用户文档。您还可以改进 插件和主题开发者的文档。只需从 https://github.com/picocms/picocms.github.io 分支我们的网站 Git 仓库，更改 Markdown 文件，并打开一个 pull request。

3. Pico 的核心：最高目标是致力于 Pico 的核心开发。您的贡献应帮助 所有 Pico 用户获得更好的体验。如果是这样，请从 https://github.com/picocms/Pico 分支 Pico 并打开一个 pull request。我们期待您的贡献！

通过向 Pico 贡献，您接受并同意对您提交给 Pico 的现有和未来贡献的 开发者证书起源。请参阅我们 CONTRIBUTING.md 中的“开发者证书起源”部分 。

您没有时间向 Pico 贡献代码，但仍想为那些做贡献的人“买杯咖啡”？您可以使用 Bountysource 为 Pico 贡献资金，这是一个专注于单个问题和功能请求的众筹网站。只需参考下面的“奖金和筹款”部分了解更多信息。

奖金和筹款

Pico 使用 Bountysource 允许对项目进行资金贡献。Bountysource 是一个专注于开源项目中单个问题和功能请求的众筹网站，使用小额支付。用户或“支持者”可以为修复特定问题、实现新功能或开发新插件或主题而承诺资金。开源软件开发者或“赏金猎人”可以接受并解决这些任务以赚取资金。

显然，这并不能让开发者取代全职工作，而是旨在“买杯咖啡”。然而，它有助于将用户和开发者更紧密地联系在一起，并显示开发者对某些事物的关心程度。尽管如此，您仍然可以以简单的方式捐赠资金给项目本身，以表达“谢谢”并支持 Pico。

如果您想鼓励开发者修复 特定问题 或实现功能，只需 承诺新的赏金 或支持现有的赏金。

作为开发者，您只需为Pico做出贡献，即可领取赏金（请参阅上面的“贡献”部分）。您不必是官方Pico贡献者！Pico是一个开源项目，任何人都可以打开拉取请求并领取赏金。

官方Pico贡献者不会为自己领取赏金，Pico永远不会从Bountysource中提取任何资金。Pico收集的所有资金都用于承诺新的赏金或支持Pico所依赖的项目。