サイト運営・SEO用途

静的HTMLサイトをGitHubで管理する時の基本

HTML、CSS、JavaScriptで作る静的サイトをGitHubで管理する時の基本と、本番サーバーとの違いを整理します。

このサイトはGitHub公式サイトではありません。GitHubの基本的な使い方や、Codex・ChatGPT時代のコード管理を初心者向けに整理するガイドです。機能・料金・提供状況は変更される可能性があるため、重要な判断ではGitHub公式情報も確認してください。

このページでわかること

最初に結論

静的HTMLサイトでは、GitHubをコードの保管場所、本番サーバーを公開場所として分けて考えると管理しやすくなります。

初心者向け説明

HTML、CSS、JavaScriptのファイルはGitHubで履歴管理できます。ただし、GitHubにあることと、実際の公開URLで見えることは別です。deploy後の公開確認が必要です。

向いている使い方

  • 小規模サイトを軽く管理する
  • 変更履歴を残す
  • CodexでHTMLページを増やす

注意が必要な使い方

  • 本番反映を忘れない
  • 未完成ページをsitemapに入れない
  • 資格情報やサーバー設定をリポジトリに入れない

CodexやChatGPTと組み合わせる場合

Codexに静的サイトを増築させる時は、追加ページ、既存リンク、sitemap、公開確認をセットで依頼すると抜け漏れを減らせます。

秘密情報・APIキー・パスワード・個人情報の注意

静的サイトでもdeploy資格情報や設定ファイルは秘密情報です。HTML内やGitHubに出さない運用を守ります。

GitHub Pagesのサイト種別とURLの階層

2026年11月18日時点の公式ヘルプでは、GitHub Pagesはリポジトリ内のHTML、CSS、JavaScriptをもとに公開する静的サイトのホスティング機能です。必要に応じてビルド処理を挟む構成にも対応しています。サイトにはユーザーまたは組織のサイトと、プロジェクトのサイトがあります。前者では所有者名.github.ioという名前のリポジトリを使い、既定URLは所有者名.github.ioです。後者の既定URLには、その後ろにリポジトリ名の階層が付きます。ユーザーまたは組織のサイトは一アカウントにつき一つ、プロジェクトのサイトは一リポジトリにつき一つという区分です。独自ドメインを使う構成もあり、リポジトリの保存場所と、訪問者が開くURLの構造を分けて把握できます。

出典:GitHub『What is GitHub Pages?』(2026年11月18日確認)https://docs.github.com/en/pages/getting-started-with-github-pages/what-is-github-pages

入口ファイルとサーバー側プログラムの範囲

2026年11月18日時点の公式ヘルプでは、GitHub Pagesの入口としてindex.html、index.md、README.mdが使われます。ブランチとフォルダを公開元にする場合、入口ファイルは指定したフォルダの最上位に必要です。Actionsで公開する構成では、配置する成果物の最上位に入口ファイルを含めます。リポジトリのどこかにindex.htmlがあるというだけでは、入口の条件とは一致しません。また、GitHub PagesはPHP、Ruby、Pythonなどのサーバー側言語に対応していません。静的ファイルを配信する仕組みと、サーバーでプログラムを動かして応答を作る仕組みは提供範囲が異なります。Jekyll以外の方法で生成したファイルを置く場合は、カスタムActionsや、公開元の.nojekyllでJekyll処理を無効にする構成が案内されています。

出典:GitHub『Creating a GitHub Pages site』(2026年11月18日確認)https://docs.github.com/en/pages/getting-started-with-github-pages/creating-a-github-pages-site

公開元ブランチとビルド方法の設定

2026年11月18日時点の公式ヘルプでは、GitHub Pagesの公開元は特定ブランチからの公開か、独自のGitHub Actionsワークフローかを選べます。ブランチ方式で選択できるフォルダは、そのブランチのルートまたは/docsです。任意の下位フォルダを同じ設定欄で指定する構造ではありません。/docsを公開元にした後でそのフォルダを削除すると、公開元が存在しないためビルドエラーになります。ブランチ方式を選んだ場合も、最終的な配置はGitHub Actionsの実行を通じて行われます。公開元の選択画面と、ビルドや配置の実行記録は別の場所です。公式資料では、ビルドまたは配置の問題を調べる入口として、リポジトリのワークフロー実行履歴が案内されています。

出典:GitHub『Configuring a publishing source for your GitHub Pages site』(2026年11月18日確認)https://docs.github.com/en/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site

容量・ビルド時間と利用目的の制限

2026年11月18日時点の公式ヘルプでは、公開するGitHub Pagesサイトの容量は1GB以下で、配置処理は10分を超えるとタイムアウトする制限があります。帯域には月100GBのソフトリミット、ビルドには一時間10回のソフトリミットが示され、独自のGitHub Actionsでビルド・公開する構成では後者の制限は適用されません。これらは異なる対象の上限で、ファイル容量と通信量、ビルド回数を同じ数値として扱うことはできません。GitHub Pagesは、商取引や商用SaaSの提供を主目的とする事業サイトを動かす用途には認められていません。また、パスワードやクレジットカード番号などの機密性の高い取引情報を送る用途に使うべきではないと説明されています。保存可能なコードの種類だけでなく、ホスティングの用途にも条件があります。

出典:GitHub『GitHub Pages limits』(2026年11月18日確認)https://docs.github.com/en/pages/getting-started-with-github-pages/github-pages-limits

404の確認対象になるファイル名の大小文字

2026年11月18日時点の公式ヘルプでは、GitHub Pagesで404が出る時の確認対象に入口ファイルが挙げられています。入口のindex.htmlは大文字と小文字を区別するため、Index.htmlやindex.HTMLとは同じ扱いになりません。また、入口ファイルは公開元の最上位に置く必要があります。公式の確認手順にはGitHub Statusで障害情報を見る項目もあり、すべての404をHTML本文の誤りだけで判断する構成ではありません。独自ドメインを使う場合は、そのドメイン設定も確認対象です。ページの内容が完成しているかという確認と、公開元の場所、入口名、ドメインの状態によってそのページへ到達できるかという確認を分けられます。独自ドメインのCNAMEレコードについては、所有者のgithub.ioを指し、リポジトリ名を含めない形が公式の説明です。プロジェクトの既定URLに付くリポジトリ名の階層を、そのままDNSの宛先へ加える設定とは異なります。

出典:GitHub『Troubleshooting 404 errors for GitHub Pages sites』(2026年11月18日確認)https://docs.github.com/en/pages/getting-started-with-github-pages/troubleshooting-404-errors-for-github-pages-sites

関連ページ

FAQ

静的HTMLサイトをGitHubで管理する時の基本は初心者でも確認できますか?

はい。専門用語を覚える前に、何を確認すればよいかを優先して整理しています。

CodexやChatGPTを使う場合も同じ考え方ですか?

基本は同じです。自動化できる部分が増えても、差分確認、秘密情報確認、公開前確認は人間側で見ます。

秘密情報が混ざったかもしれない時はどうしますか?

commitやpushを急がず、対象ファイル、公開範囲、履歴への混入有無を確認します。必要に応じてキーやパスワードを無効化します。

GitHubの機能や画面は変わりますか?

変わる可能性があります。重要な判断や最新仕様はGitHub側の情報も確認してください。

このカテゴリの親ハブ

関連ページをまとめて確認する場合は、サイト運営ハブ から読み進められます。