@@ -92,3 +92,61 @@ coverage report -m
9292- [ pytest-cov 公式ドキュメント] ( https://pytest-cov.readthedocs.io/ )
9393- [ Python Coverage.py ドキュメント] ( https://coverage.readthedocs.io/ )
9494- [ GitHub Actions ワークフロー構文] ( https://docs.github.com/ja/actions/using-workflows/workflow-syntax-for-github-actions )
95+
96+ ---
97+
98+ ## 9. GitHub Pages の設定手順
99+
100+ ### 9.1 リポジトリ設定
101+ 1 . GitHub でリポジトリのトップページにアクセス
102+ 2 . 上部の「Settings」タブをクリック
103+ 3 . 左サイドバーから「Pages」を選択
104+
105+ ### 9.2 ソースの設定
106+ 1 . 「Source」セクションで以下を設定:
107+ - Branch: ` gh-pages `
108+ - Folder: ` / (root) `
109+ 2 . 「Save」ボタンをクリック
110+
111+ ### 9.3 Actions の権限設定
112+ 1 . リポジトリの「Settings」に戻る
113+ 2 . 左サイドバーから「Actions」→「General」を選択
114+ 3 . 「Workflow permissions」セクションで以下を設定:
115+ - ✅ Read and write permissions を有効化
116+ - ✅ Allow GitHub Actions to create and approve pull requests を有効化
117+ 4 . ページ下部の「Save」ボタンをクリック
118+
119+ ### 9.4 初回設定後の確認
120+ 1 . ` main ` または ` develop ` ブランチにプッシュ
121+ 2 . GitHub Actions の実行を確認
122+ 3 . 数分後に ` https://<ユーザー名>.github.io/<リポジトリ名>/ ` にアクセスしてレポートを確認
123+
124+ ## 10. トラブルシューティング(GitHub Pages 編)
125+
126+ ### 10.1 ページが表示されない場合
127+ 1 . GitHub Actions のワークフローが正常に完了しているか確認
128+ 2 . ブランチ名とフォルダの設定が正しいか確認
129+ 3 . 初回のデプロイには最大10分かかることがあります
130+
131+ ### 10.2 404 エラーが表示される場合
132+ 1 . リポジトリの「Settings」→「Pages」でデプロイの状態を確認
133+ 2 . ワークフローファイルの ` deploy ` ステップが実行されているか確認
134+ 3 . ` gh-pages ` ブランチに ` index.html ` が存在するか確認
135+
136+ ## 11. カスタムドメインの設定(オプション)
137+
138+ カスタムドメインを使用する場合は、以下の手順で設定できます:
139+
140+ 1 . リポジトリの「Settings」→「Pages」→「Custom domain」にドメインを入力
141+ 2 . DNSプロバイダで以下のレコードを設定:
142+ ```
143+ CNAME レコード: yourdomain.com → <ユーザー名>.github.io
144+ CNAME レコード: www → <ユーザー名>.github.io
145+ ```
146+ 3 . 「Enforce HTTPS」を有効化
147+
148+ ## 12. 参考リンク(追加)
149+
150+ - [ GitHub Pages 公式ドキュメント] ( https://docs.github.com/ja/pages )
151+ - [ GitHub Actions ワークフロー構文] ( https://docs.github.com/ja/actions/using-workflows/workflow-syntax-for-github-actions )
152+ - [ カスタムドメインの設定] ( https://docs.github.com/ja/pages/configuring-a-custom-domain-for-your-github-pages-site )
0 commit comments