Pico 是一款极其简单、速度极快的平面文件 CMS。
请访问我们的 http://picocms.org/ 并参阅 http://picocms.org/about/ 了解更多信息。
看到一个Unparenthesized a ? b : c ? d : e is not supported.
错误?
Pico 目前在 8.0 以上的 PHP 版本上存在问题。 这是由于 Pico 的依赖性,而不是 Pico 本身。 目前有一个 Pico 的“alpha”版本,您可以下载作为预捆绑版本来解决这个问题。
这个“alpha”在生产中使用是完全安全的,因为唯一的变化是更新的依赖项和版本号字符串。 如果您好奇,可以通过比较分支之间的变化来确认这一点。
本来打算在这个分支上完成更多的工作,因此有了“3.0”标签,但它还没有发生。 关于尽快将这些更新的依赖项合并为官方更新(Pico 2.2 或 3.0)的讨论正在进行中。
对于给您带来的不便,我们深表歉意,并感谢所有 Pico 用户的耐心等待。
安装 Pico 非常简单 - 只需几秒钟即可完成!如果您有权访问服务器上的 shell(即 SSH 访问),我们建议使用 Composer。如果没有,请使用预捆绑版本。如果您不知道什么是“SSH 访问”,请转到预捆绑版本。
Pico 需要 PHP 5.3.6+ 并启用 PHP 扩展dom
和mbstring
。
从 Pico 2.0 开始,我们建议尽可能使用 Composer 安装 Pico。相信我们,升级 Pico 时您不会后悔!无论如何,如果您不想使用 Composer,或者因为无法访问服务器上的 shell 而根本无法使用 Composer,请不要绝望,仍然可以使用预捆绑版本安装 Pico比你所知道的一切都容易!
打开 shell 并导航到服务器的httpdocs
目录(例如/var/www/html
)。下载 Composer 并使用create-project
选项运行它,将其安装到所需的目录(例如/var/www/html/pico
):
$curl -sSL https://getcomposer.org/installer | php $ phpcomposer.phar 创建项目 picocms/pico-composer pico
什么第二步?没有第二步了。就是这样!打开您最喜欢的网络浏览器并导航到您全新的、极其简单、速度极快的平面文件 CMS! Pico 的示例内容将解释如何创建您自己的内容。
您是否知道这种感觉:您想要安装一个新网站,因此您上传了您最喜欢的 CMS 的所有文件并运行安装脚本 - 结果却发现您忘记了首先创建 SQL 数据库?稍后安装脚本会告诉您文件权限错误。哎呀,这到底是什么意思?算了,Pico 不一样!
下载最新的 Pico 版本并将所有文件上传到服务器的httpdocs
目录(例如/var/www/html/pico
)内所需的 Pico 安装目录。
好吧,这里有一个问题:没有问题。就是这样!打开您最喜欢的网络浏览器并导航到您全新的、极其简单、速度极快的平面文件 CMS! Pico 的示例内容将解释如何创建您自己的内容。
Git 是一个非常强大的分布式版本控制系统 - 它可用于围绕您的 Pico 网站建立良好的工作流程。为您的网站使用 Git 存储库有助于内容创建和部署,包括协作编辑和版本控制。如果您想在 Git 存储库中管理您的网站,您可以使用基于 Composer 的安装。
使用 GitHub 的 fork 按钮来 fork Pico 的 Composer 入门项目。如果您不想使用 GitHub,则可以选择您想要的任何 Git 服务器。手动分叉只需要一些额外的步骤:首先在本地克隆 Git 存储库,将 Git 服务器添加为远程服务器,然后将存储库推送到这个新的远程服务器。
在本地克隆您的分叉并添加您的内容和资产。您可以编辑 Pico 的composer.json
以包含第 3 方插件和主题,或者只是将您自己的插件和主题添加到 Pico 的plugins
中。 themes
目录。不要忘记提交更改并将其推送到 Git 服务器。
在网络服务器上打开 shell 并导航到httpdocs
目录(例如/var/www/html
)。下载 Composer,将 Git 存储库克隆到所需目录(例如/var/www/html/pico
)并使用 Composer 的install
选项安装 Pico 的依赖项:
$curl -sSL https://getcomposer.org/installer | php $ git clone https://github.com/<YOUR_USERNAME>/<YOUR_REPOSITORY> pico $ phpcomposer.phar --working-dir=pico 安装
如果您更新网站的内容,只需提交更改并将其推送到您的 Git 服务器即可。在您的网络服务器上打开 shell,然后导航到服务器的httpdocs
目录(例如/var/www/html/pico
)内的 Pico 安装目录。从 Git 服务器中提取所有更改并使用 Composer 的update
选项更新 Pico 的依赖项:
$ git 拉 $ phpcomposer.phar 更新
那么,您是使这一切成为可能的杰出人士之一吗?我们爱你们!作为开发人员,我们建议您克隆 Pico 的 Git 存储库以及 Pico 默认主题和PicoDeprecated
插件的 Git 存储库。您可以使用 Pico 的 Composer 入门项目设置工作区,并使用本地包包含 Pico 的所有组件。
使用 Pico 的 Git 存储库与使用上面阐述的安装方法之一不同。它为您提供 Pico 的当前开发版本,该版本可能不稳定并且尚未准备好用于生产使用!
打开 shell 并导航到服务器的httpdocs
目录(例如/var/www/html/pico
)内 Pico 开发工作区的所需目录。下载 Pico 的 Composer 入门项目并将其解压到workspace
目录中:
$curl -sSL https://github.com/picocms/pico-composer/archive/master.tar.gz |焦油 $ mv pico-composer-master 工作区
将所有 Pico 组件(Pico 的核心、Pico 的默认主题和PicoDeprecated
插件)的 Git 存储库克隆到components
目录中:
$ mkdir 组件 $ git 克隆 https://github.com/picocms/Pico.git Components/pico $ git 克隆 https://github.com/picocms/pico-theme.git Components/pico-theme $ git 克隆 https://github.com/picocms/pico-deprecated.git Components/pico-deprecated
指示 Composer 使用本地 Git 存储库来替代picocms/pico
(Pico 的核心)、 picocms/pico-theme
(Pico 的默认主题)和picocms/pico-deprecated
( PicoDeprecated
插件)包。相应地更新开发工作区的composer.json
(即workspace/composer.json
):
{“存储库”:[ {“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/作曲家安装程序": "^1.0"} }
下载 Composer 并使用install
选项运行它:
$curl -sSL https://getcomposer.org/installer | php $ php Composer.phar --working-dir=工作空间安装
您现在可以打开 Web 浏览器并导航到 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,那么升级 Pico 就非常简单。只需打开 shell 并导航到服务器的httpdocs
目录(例如/var/www/html/pico
)内的 Pico 安装目录即可。您现在只需使用一个命令即可升级 Pico:
$ phpcomposer.phar 更新
就是这样! Composer 将自动更新 Pico 以及您使用 Composer 安装的所有插件和主题。请确保手动更新您手动安装的所有插件和主题。
好吧,安装 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 核心、Pico 默认主题和PicoDeprecated
插件的 Git 存储库中提取最新提交。让 Composer 更新您的依赖项,然后您就可以开始了。
$ git -C 组件/pico pull $ git -C 组件/pico-theme pull $ git -C 组件/pico-deprecated pull $ php Composer.phar --working-dir=工作空间更新
如果您想开始使用 Pico,请参阅我们的用户文档。如果您想从Pico 1.0升级到Pico 2.0,请阅读升级说明。您可以在我们的网站上找到官方支持的插件和主题。更多第三方插件和主题的选择可以分别在我们的 Wiki 的插件或主题页面上找到。如果您想创建自己的插件或主题,请参阅下面的“作为开发人员获取帮助”部分。
如果您是开发人员,请参阅下面的“贡献”部分和我们的贡献指南。要开始创建插件或主题,请阅读我们网站上的开发人员文档。
当文档无法回答您的问题时,您可以通过加入我们的 Libera.Chat 上的 #picocms(日志)来获得帮助。当您在使用 Pico 时遇到问题,请随时在 GitHub 上创建新问题。有关插件或主题的问题,请参阅该插件或主题开发者的网站。
在创建新问题之前,请确保尚未使用 GitHub 搜索引擎报告该问题。请尽可能清楚地描述您的问题,并始终包含您正在使用的Pico 版本。如果您正在使用插件,也请包含它们的列表。我们需要有关实际和预期行为、重现问题的步骤以及您自己解决问题所采取的步骤(即您自己的故障排除)的信息。
您想为 Pico 做出贡献吗?我们真的很感激!您可以通过贡献代码或报告问题来帮助改进 Pico,但请注意我们的贡献指南。一般来说,您可以在三个不同的领域做出贡献:
插件和主题:您是插件开发人员或主题设计师?我们爱你们!您可以在 http://picocms.org/development/ 找到大量有关如何开发插件和主题的信息。如果您创建了插件或主题,请将其添加到我们的 Wiki,无论是在插件还是主题页面上。您也可以将其提交到我们的网站,它将显示在官方插件或主题页面上!
文档:我们始终感谢人们改进我们的文档。您可以改进我们网站上的内联用户文档或更广泛的用户文档。您还可以改进插件和主题开发人员的文档。只需从 https://github.com/picocms/picocms.github.io 分叉我们网站的 Git 存储库,更改 Markdown 文件并打开拉取请求。
Pico 的核心:最高的纪律是致力于 Pico 的核心。您的贡献应该帮助每个Pico 用户获得更好的 Pico 体验。如果是这种情况,请从 https://github.com/picocms/Pico 分叉 Pico 并打开拉取请求。我们期待您的贡献!
通过向 Pico 做出贡献,您接受并同意您当前和未来提交给 Pico 的贡献的开发者原产地证书。请参阅我们的CONTRIBUTING.md
中的“开发者原产地证书”部分。
您没有时间向 Pico 贡献代码,但仍想为有贡献的人“喝杯咖啡”?您可以使用 Bountysource 向 Pico 捐款,Bountysource 是一个专注于个人问题和功能请求的众筹网站。请参阅下面的“赏金和筹款活动”部分了解更多信息。
Pico 使用 Bountysource 为项目提供金钱捐助。 Bountysource 是一个众筹网站,专注于使用小额支付的开源项目中的个人问题和功能请求。用户或“支持者”可以承诺提供资金来解决特定问题、实施新功能或开发新插件或主题。开源软件开发人员或“赏金猎人”可以接手并解决这些任务来赚钱。
显然,这不会让开发人员取代全职工作,而是旨在“喝杯咖啡”。然而,它有助于拉近用户和开发人员的距离,并向开发人员展示用户想要什么以及他们对某些事情的关心程度。尽管如此,您仍然可以向项目本身捐款,作为表达“谢谢”和支持 Pico 的简单方式。
如果您想鼓励开发人员解决特定问题或实现一项功能,只需承诺新的赏金或支持现有的赏金即可。
作为开发者,您只需向 Pico 做出贡献即可获得赏金(请参阅上面的“贡献”部分)。您不必成为官方 Pico 贡献者! Pico 是一个开源项目,任何人都可以打开拉取请求并领取赏金。
Pico 官方贡献者不会代表自己索取赏金,Pico 绝不会从 Bountysource 中获取任何资金。 Pico 收集的所有资金均用于承诺新的赏金或支持 Pico 所依赖的项目。