A implantação da documentação do Docusaurus no GitHub Pages requer configuração manual das configurações de build, fluxos de trabalho do GitHub Actions e branches de implantação. Esta habilidade automatiza todo o processo com modelos pré-validados e testes locais antes dos gatilhos de CI/CD.
下载技能 ZIP
在 Claude 中上传
前往 设置 → 功能 → 技能 → 上传技能
开启并开始使用
测试它
正在使用“docusaurus-deployer”。 Deploy my Docusaurus documentation to GitHub Pages for the first time
预期结果:
- Vou ajudá-lo a implant seu site Docusaurus no GitHub Pages.
- Etapa 1: Análise do Projeto
- Vou examinar sua estrutura Docusaurus para verificar docusaurus.config.ts, sidebars.ts e package.json.
- Etapa 2: Validação da Configuração
- Verifique suas configurações para compatibilidade com GitHub Pages (url, baseUrl, organizationName, projectName).
- Etapa 3: Teste Local
- Execute npm ci, npm run typecheck, npm run build e npm run serve para validar antes de enviar.
- Etapa 4: Configuração de CI/CD
- Crie .github/workflows/deploy.yml usando o GitHub Actions oficial para implantação de Pages.
- Etapa 5: Configuração do Repositório
- Orienta você pelas configurações do GitHub Pages para habilitar a implantação do GitHub Actions.
- Qual é a localização do seu projeto Docusaurus e a URL do repositório GitHub?
安全审计
安全This is a documentation-only skill that provides guidance and templates for deploying Docusaurus sites to GitHub Pages. All functionality is achieved through standard npm commands and official GitHub Actions. No sensitive data access, network calls to external endpoints, or code execution risks detected.
质量评分
你能构建什么
Primeira Configuração de Documentação
Configure e implanta um novo site Docusaurus no GitHub Pages com automação adequada de CI/CD.
Criação de Pipeline CI/CD
Configura fluxos de trabalho automatizados do GitHub Actions que constroem e implantam documentação a cada push.
Solução de Problemas de Implantação
Diagnostica e corrige problemas comuns como falhas de build, erros 404 e links quebrados na documentação implantada.
试试这些提示
Deploy my Docusaurus site to GitHub Pages. My repository is at github.com/username/repo-name and the Docusaurus files are in the docs/ directory.
Create a GitHub Actions workflow for deploying my Docusaurus documentation. I want it to build automatically when I push to main branch.
Check if my Docusaurus configuration is correct for GitHub Pages deployment. My docusaurus.config.ts is at docs/docusaurus.config.ts.
My Docusaurus site shows 404 errors after deployment. The site builds successfully locally but not on GitHub Pages. Help me troubleshoot.
最佳实践
- Sempre execute validação local (typecheck, build, serve) antes de enviar alterações para capturar erros antecipadamente
- Use links relativos na documentação em vez de URLs fixos para garantir navegação correta no GitHub Pages
- Configure regras de proteção de branches para exigir execuções de CI/CD bem-sucedidas antes de mesclar alterações
避免
- Implantar sem teste local - isso leva a execuções de CI/CD com falha e documentação quebrada
- Usar URLs fixos em arquivos markdown em vez de caminhos relativos - causa navegação quebrada
- Pular a etapa npm run typecheck - Erros de TypeScript falharão o build no CI/CD