Simiki3 文档 ·

开发

Simiki3 支持 Python 3.10 及更高版本。仓库使用 uv 管理依赖,使用 pytestruff 做验证。

准备环境

git clone https://github.com/hmgle/simiki3.git
cd simiki3
uv sync --extra dev

验证改动

uv run --extra dev pytest -q
uv run --extra dev ruff check src tests
uv run --extra dev python -m compileall -q src tests

端到端冒烟路径是 init → build → serve。主题和迁移行为发生变化时,应增加集成测试覆盖。

在本地构建本站文档

这个仓库的文档本身就是一个 Simiki3 站点:

uv run simiki3 build docs
uv run simiki3 serve docs --watch

生成文件写入 docs/output/,并且会被 Git 忽略。