GitHub Pages の公開ソースを設定する
GitHub Pages は、GitHub Free のパブリックリポジトリ、GitHub Pro のパブリックおよびプライベートリポジトリ、GitHub Team、GitHub Enterprise Cloud、GitHub Enterprise Server で利用いただけます。
サイトのソースファイルを、master、gh-pages、または /docs フォルダから、特定の条件に当てはまる Project Pages やその他の Pages サイトで master ブランチのフォルダに公開するよう GitHub Pages を設定できます。
サイトがユーザまたは Organization Page で、<username>.[hostname]
または<orgname>.[hostname]
という名前のリポジトリがある場合は、サイトのソースファイルを別の場所に公開できません。 この類のリポジトリ名を持つユーザおよび Organization Pages は、master ブランチからのみ公開されます。
さまざまな種類の GitHub Pages サイトに関する詳しい情報については、「ユーザ、Organization、およびプロジェクト Pages」を参照してください。
ユーザ名命名規則のないリポジトリの、デフォルトのソース設定
サイトのソースファイル公開に関するデフォルト設定は、サイトの種類と、サイトリポジトリにあるブランチによって異なります。
サイトリポジトリに master または gh-pages ブランチがない場合、GitHub Pages公開ソースは [None] に設定され、サイトは公開されません。
master または gh-pages ブランチを作成すれば、それを公開ソースに設定して、サイトを公開できます。
master または gh-pages ブランチのみのサイトリポジトリをフォークまたはアップロードすると、そのブランチに対してサイトのソース設定が自動的に有効になります。
GitHub Pages が master または gh-pages からサイトを公開できるようにする
master または gh-pages を公開ソースとして選択するには、そのブランチがリポジトリに存在する必要があります。 master または gh-pages ブランチがない場合は、それらを作成してからソース設定に戻り、公開ソースを変更できます。
-
GitHub Enterprise上で GitHub Pagesサイトのリポジトリにアクセスします。
-
リポジトリ名の下で [Settings] をクリックします。
-
[Select source] ドロップダウンメニューで、GitHub Pages の公開ソースとして master または gh-pages を選択します。
-
Saveをクリックします。
master ブランチの /docs フォルダから GitHub Pages サイトを公開する
master ブランチの /docs フォルダからソースファイルを公開するには、master ブランチがあり、かつリポジトリが以下の条件を満たす必要があります:
- リポジトリのルートに
/docsフォルダがある - リポジトリの命名規則
<username>.[hostname]
または<orgname>.[hostname]
に従っていない
参考: 有効化した後に /docs フォルダを master ブランチから削除すると、サイトはビルドされず、/docs フォルダがないためページをビルドできないというエラーメッセージが表示されます。
-
GitHub Enterprise上で GitHub Pagesサイトのリポジトリにアクセスします。
-
masterブランチでリポジトリのルートに/docsという名前のフォルダを作成します。 -
リポジトリ名の下で [Settings] をクリックします。
-
[Select source] ドロップダウンメニューから、GitHub Pages公開ソースとして master branch /docs folder を選択します。
参考:
/docsフォルダがmasterブランチに存在しない場合、master branch /docs folder はオプションとして表示されません。 -
Saveをクリックします。
