此儲存庫包含 Pelican 的主題。請隨意克隆、添加您自己的主題並提交拉取請求。這是社群管理的!
現場版本可以在 http://www.pelicanthemes.com 上看到。
這些說明假設您已經閱讀了所有 Pelican 文件、擁有一個工作站點,現在想要套用非預設主題。
首先,選擇一個放置主題的位置。對於此範例,我們將使用目錄~/pelican-themes
,但您的目錄可能不同。將pelican-themes
儲存庫複製到本機上的該位置:
git clone --recursive https://github.com/getpelican/pelican-themes ~ /pelican-themes
現在您應該將pelican-themes
儲存庫儲存在~/pelican-themes/
中。
要使用其中一個主題,請編輯您的 Pelican 設定檔以包含以下行:
THEME = "/home/user/pelican-themes/theme-name"
因此,例如,要使用mnmlist
主題,您需要編輯設定檔以包含:
THEME = "/home/user/pelican-themes/mnmlist"
將變更儲存到您的設定文件,然後使用您應該已經使用pelican-quickstart
設定的 Makefile 重新產生您的網站:
make html
也可以透過pelican
指令的-t ~/pelican-themes/theme-name
參數直接指定主題。如果您想編輯主題,請確保您所做的任何編輯都是針對儲存在~/pelican-themes/theme-name
中的副本進行的。對儲存在網站output
目錄中的檔案所做的任何變更都將在您下次產生網站時刪除。
生成主題預覽透過 GitHub Actions 工作流程自動發生,之後這些預覽將發佈到 https://pelicanthemes.com。如果您想在工作站上本地產生預覽,請複製Pelican 儲存庫(例如,複製到~/projects/pelican/),將此儲存庫複製到某個位置,變更到該複製的根目錄,然後按照以下步驟操作:
python -m pip install pelican[markdown] shot-scraper
mkdir _pelican
cp -r ~ /projects/pelican/samples _pelican/
python build-theme-previews.py