GitHub Pages サイトを作成する

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

サイトが独立プロジェクトなら、サイトのソースコードを保存するために新しいリポジトリを作成できます。 If your site is associated with an existing project, you can add the source code to that project's repository, in a /docs folder on the default branch or on a different branch. たとえば、すでにGitHub Enterprise Server上にあるプロジェクトのドキュメンテーションを公開するサイトを作成しているなら、そのサイトのソースコードはプロジェクトと同じリポジトリに保存したいでしょう。

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

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

サイトを作成する

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

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

2. Decide which publishing source you want to use. 詳しい情� �については「GitHub Pagesについて」を参照してく� さい。

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

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

   参考: index.htmlがあるなら、index.mdの代わりに利用されます。 index.htmlもindex.mdもないなら、README.mdが使われます。

5. 公開ソースを設定してく� さい。 詳しい情� �については「GitHub Pages サイトの公開元を設定する」を参照してく� さい。

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

7. 左のサイドバーでPages（ページ）をクリックしてく� さい。

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

   メモ: サイトに対する変更は、その変更をGitHub Enterprise Serverにプッシュしてから公開されるまでに、最大10分かかることがあります。 If you don't see your GitHub Pages site changes reflected in your browser after an hour, see "About Jekyll build errors for GitHub Pages sites."

次のステップ

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

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

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

参考リンク

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