DocusaurusドキュメントをGitHub Pagesにデプロイするには、ビルド設定、GitHub Actionsワークフロー、デプロイブランチの手動構成が必要です。このスキルは、CI/CDトリガー前に事前検証済みテンプレートとローカルテストでプロセス全体を自動化します。
Télécharger le ZIP du skill
Importer dans Claude
Allez dans Paramètres → Capacités → Skills → Importer un skill
Activez et commencez à utiliser
Tester
Utilisation de "docusaurus-deployer". Docusaurusドキュメントを初めてGitHub Pagesにデプロイする
Résultat attendu:
- DocusaurusサイトをGitHub Pagesにデプロイするお手伝いをします。
- ステップ1: プロジェクト分析
- docusaurus.config.ts、sidebars.ts、package.jsonを確認するため、Docusaurus構造を検査します。
- ステップ2: 構成検証
- GitHub Pages互換性のための設定を確認します(url、baseUrl、organizationName、projectName)。
- ステップ3: ローカルテスト
- プッシュ前にエラーを早期に発見するため、npm ci、npm run typecheck、npm run build、npm run serveを実行して検証します。
- ステップ4: CI/CDセットアップ
- Pagesデプロイ用の公式GitHub Actionsを使用して、.github/workflows/deploy.ymlを作成します。
- ステップ5: リポジトリ構成
- GitHub Actionsからのデプロイを有効にするため、GitHub Pages設定を通じてガイドします。
- Docusaurusプロジェクトの場所とGitHubリポジトリのURLは何ですか?
Audit de sécurité
SûrThis 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.
Score de qualité
Ce que vous pouvez construire
初回ドキュメントセットアップ
適切なCI/CD自動化で新しいDocusaurusサイトをGitHub Pagesに構成してデプロイします。
CI/CDパイプライン作成
プッシュたびにドキュメントを自動ビルドおよびデプロイするGitHub Actionsワークフローを設定します。
デプロイトラブルシューティング
ビルド失敗、404エラー、デプロイ済みドキュメントのリンク切れなど、一般的な問題を診断して修正します。
Essayez ces prompts
DocusaurusサイトをGitHub Pagesにデプロイしてください。リポジトリはgithub.com/ユーザー名/リポジトリ名で、Docusaurusファイルはdocs/ディレクトリにあります。
DocusaurusドキュメントをデプロイするためのGitHub Actionsワークフローを作成してください。mainブランチにプッシュした際に自動的にビルドされるようにしたいです。
Docusaurus構成がGitHub Pagesデプロイに適切か確認してください。docusaurus.config.tsはdocs/docusaurus.config.tsにあります。
Docusaurusサイトをデプロイ後に404エラーが表示されます。ローカルでは正常にビルドされますが、GitHub Pagesでは問題が発生しています。トラブルシューティングを手伝ってください。
Bonnes pratiques
- 常にローカル検証(typecheck、build、serve)を実行してから変更をプッシュし、早期にエラーを発見します
- ドキュメント内でハードコードされたURLではなく相対リンクを使用し、GitHub Pagesで正しいナビゲーションを確保します
- マージ前に正常なCI/CD実行を要求するようにブランチ保護ルールを構成します
Éviter
- ローカルテストなしでデプロイすると、CI/CD実行の失敗とドキュメントの破損につながります
- マークダウンファイルでハードコードされたURL 대신相対パスを使用すると、ナビゲーションが壊れます
- npm run typecheckステップをスキップすると、TypeScriptエラーでCI/CDでビルドが失敗します