GitHub Pages サイトを作成する

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

サイトが独立プロジェクトなら、サイトのソースコードを保存するために新しいリポジトリを作成できます。 If your site is associated with an existing project, you can add the source code for your site to a gh-pages branch or a docs folder on the master branch in that project's repository. For example, if you're creating a site to publish documentation for a project that's already on GitHub Enterprise, you may want to store the source code for the site in the same repository as the project.

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

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

サイトを作成する

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

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

2. If you're creating a project site, decide which publishing source you want to use. If you're creating a user or organization site, you must store your site's source code on the master branch. For more information, see "About GitHub Pages."

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

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

5. Configure your publishing source. 詳しい情報については「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 ビルドエラーに関するトラブルシューティング
• "リポジトリ内でのブランチの作成と削除"
• 新しいファイルの作成