GitHub Pages サイトを作成する

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

サイトが独立プロジェクトなら、サイトのソースコードを保存するために新しいリポジトリを作成できます。 サイトが既存のプロジェクトと関連しているなら、サイトのソースコードをそのプロジェクトのリポジトリのgh-pagesブランチもしくはmasterブランチのdocsフォルダに追加できます。 たとえば、すでにGitHub Enterprise上にあるプロジェクトのドキュメンテーションを公開するサイトを作成しているなら、そのサイトのソースコードはプロジェクトと同じリポジトリに保存したいでしょう。

既存のリポジトリにサイトを作成したいのなら、サイトの作成セクションまでスキップしてください。

1. ページの右上角で ドロップダウンメニューを使い、New repository（新規リポジトリ）を選択してください。
   
2. Owner（オーナー）ドロップダウンメニューを使い、リポジトリを所有したいアカウントを選択してください。
   
3. リポジトリの名前と、任意で説明を入力してください。 ユーザもしくはOrganizationのサイトを作成しているなら、リポジトリは<user>.github.ioもしくは<organization>.github.ioという名前でなければなりません。 詳細については、「GitHub Pagesについて」を参照してください。
   
4. リポジトリの可視性を選択してください。 詳しい情報については「リポジトリの可視性について」を参照してください。
   
5. [Initialize this repository with a README] を選択します。
   
6. [Create repository] をクリックします。

サイトを作成する

サイトを作成する前には、GitHub Enterprise上にサイトのためのリポジトリを持っていなければなりません。 既存のリポジトリ内にサイトを作成しようとしているのではないなら、「サイトのためのリポジトリの作成」を参照してください。

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

2. プロジェクトサイトを作成しているなら、使いたい公開ソースを決めてください。 ユーザもしくはOrganizationのサイトを作成しているなら、サイトのソースコードはmasterブランチに保存しなければなりません。 詳しい情報については「GitHub Pagesについて」を参照してください。

3. 選択した公開元が既に存在する場合、公開元に移動します。 選択した公開元がまだ存在しない場合は、公開元を作成します。

4. 公開元のルートに、サイトのメインページに表示したいコンテンツを含んだ、index.md という名前の新しいファイルを作成します。

5. プロジェクトサイトにデフォルトではない公開ソースを使っているなら、公開ソースを設定してください。 詳しい情報については「GitHub Pages サイトの公開元を設定する」を参照してください。

6. リポジトリ名の下で Settings（設定）をクリックしてください。

   

7. 公開されたサイトを見るには、"GitHub Pages"の下で、サイトのURLをクリックしてください。

   

   メモ: サイトに対する変更は、その変更をGitHub Enterpriseにプッシュしてから公開されるまでに、最大20分かかることがあります。 1時間経っても変更がブラウザーに反映されなければ、「GitHub PagesサイトのJekyllビルドエラーについて」を参照してください。

次のステップ

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

また、サイトの見た目をカスタマイズするため、テーマを追加できます。 詳しい情報については、「Jekyll テーマ選択画面で GitHub Pages サイトにテーマを追加する」を参照してください。

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

参考リンク

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