个人杂谈站

这个仓库托管了 ltmc.top 的个人站点，使用 MkDocs + Material for MkDocs 构建，部署在 GitHub Pages。

本地开发

需要 Python 3.x 与 Node.js（生成搜索索引用）。

pip install mkdocs-material thumbhash Pillow beautifulsoup4
mkdocs serve    # 本地预览 http://localhost:8000（不含搜索索引）
mkdocs build    # 构建静态文件到 site/

搜索由 Pagefind 提供，索引在 mkdocs build 之后生成。想本地完整体验搜索，可执行：

mkdocs build
npx --yes pagefind@^1.5.0 --site site --force-language zh --serve

每次推送到 main 分支时，GitHub Actions 会自动：

Material 内置的 search 插件已移除，改由 Pagefind 索引。
plugins/pagefind/hooks.py 在页面中注入 Component UI 资源、data-pagefind-body 正文标记与 <pagefind-modal> 弹窗。
overrides/partials/header.html 用 <pagefind-modal-trigger> 替换页头搜索入口（默认快捷键 Ctrl/⌘ + K，同时保留 /）。
docs/assets/css/pagefind-theme.css 负责与 Material 亮/暗色主题对齐。