name: docusaurus-deployer version: 1.2 description: 此技能应用于将Docusaurus站点部署到GitHub Pages时。它自动化了配置、构建和部署过程，处理GitHub Pages设置、环境配置和CI/CD自动化。包括在触发GitHub Actions之前的本地验证。 constitution_alignment: v4.0.1

Docusaurus GitHub Pages 部署器

自动化构建Docusaurus文档站点并将其部署到GitHub Pages，在触发CI/CD之前进行本地验证。

宪法对齐：此技能实现了宪法v4.0.1（第I部分第9支柱：通用云原生部署）中定义的生产部署标准。所有部署在发布前必须满足项目质量门禁。

在以下情况下将Docusaurus部署到GitHub Pages：

遵循 本地验证然后发布 的工作流程：

收集GitHub组织/用户名、仓库名称、部署目标（用户/项目页面）和自定义域名（可选）。

检查Docusaurus项目：

ls -la path_to_docusaurus_project/
cat path_to_docusaurus_project/docusaurus.config.ts
cat path_to_docusaurus_project/sidebars.ts

验证docusaurus.config.ts、sidebars.js/ts、package.json engines字段和依赖项是否存在。

有关详细配置指南，请参阅 references/configuration-guide.md。

使用GitHub Pages设置更新 docusaurus.config.ts。根据部署目标（用户页面与项目页面），请参阅 references/configuration-guide.md 获取完整的配置示例和指南。

安装依赖项，运行类型检查，构建站点，验证输出，本地测试，并验证内容质量。

执行：

npm ci
npm run typecheck
npm run build
npm run serve

有关详细验证程序，请参阅 references/local-validation-guide.md。

本地验证成功后：

git add .
git commit -m "更新文档：[描述]"
git push origin main

这将触发GitHub Actions工作流。

使用 references/deploy-workflow.yml 中的模板创建 .github/workflows/deploy.yml。

有关详细的工作流配置和故障排除，请参阅 references/github-actions-guide.md。

在Actions选项卡中检查GitHub Actions工作流状态，验证站点在配置的URL上是否加载，并确认所有导航功能正常。

有关常见问题和解决方案，请参阅 references/troubleshooting.md，其中涵盖：

在部署到生产环境之前，请验证：

参考：有关完整的生产部署标准，请参阅 .specify/memory/constitution.md 部署标准部分。