建站记录

这个网站使用 Zensical 构建，并沿用与 Material for MkDocs 兼容的 Markdown、导航和自定义样式。Zensical 的 Modern 主题负责页面呈现，内容仍然保存在轻便、易维护的 Markdown 文件中。

当前结构

docs/
  index.md
  archive.md
  about.md
  learning/
  coding/
  footprints/
  essays/
  javascripts/
  stylesheets/
mkdocs.yml
requirements.txt

.venv/bin/zensical serve

运行后可以在浏览器中打开本地地址预览。

.venv/bin/zensical build --clean

GitHub Pages 部署也使用相同的构建命令，生成结果写入 site/。

本地构建后，可以检查生成页面中的站内链接、图片路径和标题锚点：

.venv/bin/zensical build --clean
.venv/bin/python scripts/check_site_links.py site

GitHub Actions 会执行同样的检查。只要发现页面链接、资源路径或锚点失效，就会停止部署并显示具体来源。

原始旅行照片不直接放入 docs/。先使用处理脚本清除 EXIF 信息、纠正拍摄方向、限制最长边，并生成网页使用的 WebP：

.venv/bin/python scripts/process_travel_images.py \
  ~/Pictures/trip-example \
  --output-dir docs/assets/images/footprints/trip-example

默认最长边为 1920 像素、WebP 质量为 84。可以使用 --max-edge 和 --quality 调整。原始照片不会被修改。