Flex主题安装笔记

何师傅工作室：Pelican 博客 Flex 主题安装与避坑指南 1. 核心流程：从零到上线

• 克隆主题：在 themes 目录下通过 Git 克隆 Flex 仓库。若遇到 GitHub 连接重置（Connection reset），可使用镜像加速。

• 环境清理：至关重要！ 必须删除 themes/Flex/ 下隐藏的 .git 文件夹，否则 GitHub 会将其识别为子模块，导致线上构建时主题文件夹为空。

• 参数配置：在 pelicanconf.py 中定义 THEME = 'themes/Flex'，并配置 SITENAME、SITETITLE 及 SITESUBTITLE 等核心变量。

• 本地预览：执行 pelican --listen 并在浏览器访问 localhost:8000。

• 部署上线：通过 git add .、git commit 和 git push 将代码推送到 GitHub，触发 Cloudflare Pages 自动构建。

1. 遇到的典型问题及对策

问题 A：克隆失败 (RPC failed; curl 56)

• 原因：网络环境访问 GitHub 不稳定。

• 解决：使用镜像地址 [可疑链接已删除] 前缀进行克隆，或直接下载 ZIP 包解压。

问题 B：修改配置后预览不生效（仍显示默认主题）

• 原因：Pelican 缓存或 output 文件夹未刷新。

• 解决：手动删除 output 文件夹，重新运行 pelican content -s pelicanconf.py 强制生成。

问题 C：Git 警告 LF 将被 CRLF 替换

• 原因：跨系统（Linux 源码在 Windows 操作）的换行符差异。

• 解决：这只是警告，不影响运行。可通过 git config --global core.autocrlf true 消除。

问题 D：fatal: unknown write failure on standard output

• 原因：Git 在终端输出大量文件列表时触发的缓冲区溢出。

• 解决：这通常不影响 commit 结果。通过 git status 确认文件已进入暂存区即可放心 push。

1. 经验总结

• 保持文件夹干净：及时清理 .github 和隐藏的 .git 文件。

• 强制刷新：遇到样式没变的情况，多用 Ctrl + F5 绕过浏览器缓存。

• 小步快跑：先上线，再优化，逐步通过修改 pelicanconf.py 实现个性化。