该存储库包含 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