构建文档站

在仓库根目录运行:

python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
.venv/bin/mkdocs build --strict
.venv/bin/mkdocs serve

静态站点生成在 site/。在 Cloudflare Dashboard 打开 Workers & Pages → Create application → Workers → Import a repository(部分界面显示 Connect to Git)。安装或配置 Cloudflare 的 GitHub App,仅授予访问私有仓库 PlutoKeating/Project.Amani-Xiaomi12 的权限。选择该仓库以及生产分支 main。Worker 名称填 amani-xiaomi12,根目录采用仓库根目录。构建命令填 python3 -m venv .venv && .venv/bin/pip install -r requirements.txt && .venv/bin/mkdocs build --strict,部署命令填 npx --yes wrangler@4.166.0 deploy。点击 Save and Deploy。唯一正式生产域名为 amani.plutokeating.beer,已在 Worker 的自定义域中绑定。发布后核对首页和实机验收页。私有仓库的访问权限与发布网站的访问权限分别配置;如文档也限内部访问,可用 Cloudflare Access 限制站点。提交仓库中的 Wrangler 配置负责选择静态资产目录。验收发布时记录构建提交和实际可访问的站点地址。

参见 Cloudflare Workers Builds 配置。