サイト用にリポジトリを作成する
サイトが独立プロジェクトなら、サイトのソースコードを保存するために新しいリポジトリを作成できます。 サイトが既存のプロジェクトと関連しているなら、ソースコードをサイト用にgh-pages
ブランチもしくはそのプロジェクトのリポジトリのmaster
ブランチ上のdocs
フォルダに追加できます。たとえば、すでにGitHub Enterprise Server上にあるプロジェクトのためのドキュメンテーションを公開するサイトを作成しているなら、そのサイトのソースコードをプロジェクトと同じリポジトリに保存したいでしょう。
既存のリポジトリにサイトを作成したいのなら、サイトの作成セクションまでスキップしてください。
- ページの右上角で ドロップダウンメニューを使い、New repository(新規リポジトリ)を選択してください。
- Owner(オーナー)ドロップダウンメニューを使い、リポジトリを所有したいアカウントを選択してください。
- リポジトリの名前と、任意で説明を入力してください。 ユーザもしくはOrganizationのサイトを作成しているなら、リポジトリは
<user>.github.io
もしくは<organization>.github.io
という名前でなければなりません。 詳しい情報については「GitHub Pagesについて」を参照してください。 - リポジトリの可視性を選択してください。 詳細は「リポジトリの可視性について」を参照してください。
- [Initialize this repository with a README] を選択します。
- Create repository(リポジトリの作成)をクリックしてください。
サイトを作成する
サイトを作成する前には、GitHub Enterprise Server上にサイトのためのリポジトリを持っていなければなりません。 既存のリポジトリ内にサイトを作成しようとしているのではないなら、「サイトのためのリポジトリの作成」を参照してください。
警告: サイト管理者がPublic Pagesを有効化したなら、GitHub Pagesサイトは、サイトのリポジトリがプライベートもしくはインターナルであっても、インターネット上で公開利用できます。もしセンシティブなデータがサイトのリポジトリにあるなら、公開前にそのデータを削除しておくとよいでしょう。 詳しい情報については、 「EnterpriseのGitHub Pagesの設定」及び「リポジトリの可視性について」を参照してください。
-
GitHub Enterprise Serverで、サイトのリポジトリにアクセスしてください。
-
プロジェクトサイトを作成しているなら、どの公開ソースを使いたいか、判断してください。 ユーザもしくはOrganizationのサイトを作成しているなら、サイトのソースコードは
master
ブランチに保存しなければなりません。詳しい情報については「GitHub Pagesについて」を参照してください。 -
選択した公開元が既に存在する場合、公開元に移動します。 選択した公開元がまだ存在しない場合は、公開元を作成します。
-
公開元のルートに、サイトのメインページに表示したいコンテンツを含んだ、
index.md
という名前の新しいファイルを作成します。 -
公開ソースを設定してください。 詳しい情報については「GitHub Pages サイトの公開元を設定する」を参照してください。
-
リポジトリ名の下で Settings(設定)をクリックしてください。
-
公開されたサイトを見るには、"GitHub Pages"の下で、サイトのURLをクリックしてください。
メモ: サイトに対する変更は、その変更をGitHub Enterprise Serverにプッシュしてから公開されるまでに、最大20分かかることがあります。 1時間経っても変更がブラウザーに反映されなければ、「GitHub PagesサイトのJekyllビルドエラーについて」を参照してください。
ノート: サイトのソースファイルがデフォルトの公開ソース、すなわちユーザ及びOrganizationのサイトであればmaster
、プロジェクトのサイトであればgh-pages
にありながら、サイトが自動的に公開されない場合は、管理権限と認証済みメールアドレスを持つ人が公開ソースにプッシュしていることを確認してください。
次のステップ
新しいファイルを追加で作成することにより、ページを追加できます。 各ファイルは、公開元と同じディレクトリ構造で、サイト上に表示されます。 たとえば、プロジェクトサイトの公開元が 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」を参照してください。