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 所依賴的項目。