GitHub Pages サイトを作成する

サイト用にリポジトリを作成する

リポジトリを作成することも、自分のサイト用の既存のリポジトリを選ぶこともできます。

リポジトリに対して GitHub Pages サイトを作成したい場合、そのリポジトリ内のすべてのファイルがサイトに関連付けられるわけではないのなら、そのサイトに対して公開元を構成することができます。 たとえば、サイト ソース ファイルを保持する専用のブランチとフォルダーを用意することや、カスタムの GitHub Actions ワークフローを使ってサイト ソース ファイルをビルドして配置することができます。

リポジトリを所有しているアカウントが GitHub Free または Organization 用の GitHub Free を使用している場合、そのリポジトリはパブリックである必要があります。

既存のリポジトリにサイトを作成する場合は、「サイトを作成する」セクションに進んでください。

1. ページの右上隅で を選択し、 [新しいリポジトリ] をクリックします。

   

2. [所有者] ドロップダウン メニューを使い、リポジトリを所有させたいアカウントを選びます。

   

3. リポジトリの名前と、任意で説明を入力してください。 ユーザーまたは Organization サイトを作成する場合は、リポジトリに <user>.github.io または <organization>.github.io という名前を付ける必要があります。 ユーザーまたは Organization の名前に大文字が含まれている場合は、小文字にする必要があります。 詳しくは、「What is GitHub Pages?」をご覧ください。

   

4. リポジトリの可視性を選択してください。 詳しくは、「リポジトリについて」をご覧ください。

5. [Initialize this repository with a README] (このレポジトリを README で初期化する) を選択します。

6. [Create repository] (リポジトリの作成) をクリックします。

サイトを作成する

サイトを作成する前には、GitHub 上にサイト用のリポジトリがある必要があります。 既存のリポジトリにサイトを作成していない場合は、「サイト用にリポジトリを作成する」をご覧ください。

1. GitHub で、サイトのリポジトリにアクセスしてください。

2. 使用する公開ソースを決定します。 詳しくは、「GitHub Pages サイトの公開元を設定する」をご覧ください。

3. サイト用のエントリ ファイルを作成します。 GitHub Pages では、サイト用のエントリ ファイルとして index.html、index.md、または README.md ファイルを検索します。

   パブリッシュ ソースがブランチとフォルダーの場合、エントリ ファイルはソース ブランチのソース フォルダーの最上位にある必要があります。 たとえば、公開元が main ブランチ上の /docs フォルダーである場合、エントリ ファイルは、main という名前のブランチ上の /docs フォルダー内に配置する必要があります。

   公開元が GitHub Actions ワークフローである場合、デプロイする成果物には、成果物の最上位レベルにあるエントリ ファイルが含まれている必要があります。 エントリ ファイルをリポジトリに追加する代わりに、GitHub Actions ワークフローの実行時にエントリ ファイルを生成するように選択することもできます。

4. 公開ソースを設定してください。 詳しくは、「GitHub Pages サイトの公開元を設定する」をご覧ください。 1. リポジトリ名の下にある [設定] をクリックします。 [設定] タブが表示されない場合は、 [] ドロップダウン メニューを選び、 [設定] をクリックします。

   

5. サイド バーの [コードと自動化] セクションで、 [ ページ] をクリックします。

6. 公開されたサイトを表示するには、[GitHub Pages] の下で [ サイトにアクセスする] をクリックします。

   

1. GitHub Pages サイトは、GitHub Actions ワークフローでビルドされ、デプロイされます。 詳しくは、「ワークフロー実行の履歴を表示する」をご覧ください。

   メモ

   GitHub Actions はパブリックリ ポジトリでは無料です。 使用料は、無料の時間 (分) の毎月の割り当てを超えるプライベート リポジトリと内部リポジトリに適用されます。 詳しくは、「使用制限、支払い、管理」をご覧ください。

次の手順

新しいファイルを追加で作成することにより、ページを追加できます。 各ファイルは、公開元と同じディレクトリ構造で、サイト上に表示されます。 たとえば、プロジェクト サイトの公開元が gh-pages ブランチであり、gh-pages ブランチで /about/contact-us.md という名前の新しいファイルを作成した場合、ファイルは https://<user>.github.io/<repository>/about/contact-us.html で使用できます。

また、サイトの見た目をカスタマイズするため、テーマを追加できます。 詳しくは、「Jekyll を使用して GitHub Pages サイトにテーマを追加する」をご覧ください。

サイトを更にカスタマイズするには、Jekyll を使用できます。Jekyll は、GitHub Pages に組み込まれている静的サイトジェネレータです。 詳しくは、「GitHub PagesとJekyllについて」をご覧ください。

参考資料

• GitHub Pages サイトの Jekyll ビルドエラーに関するトラブルシューティング
• リポジトリ内でブランチを作成および削除する
• 新しいファイルの作成
• GitHub Pages サイトの 404 エラーのトラブルシューティング