ノート: Organizationのオーナーは、Organizationが所有しているリポジトリからのGitHub Pagesサイトの公開を制限できます。 詳しい情� �については「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上にあるプロジェクトのドキュメンテーションを公開するサイトを作成しているなら、そのサイトのソースコードはプロジェクトと同じリポジトリに保存したいでしょう。
既存のリポジトリにサイトを作成したいのなら、サイトの作成セクションまでスキップしてく� さい。
- ページの右上角で ドロップダウンメニューを使い、New repository(新規リポジトリ)を選択してく� さい。
- Owner(オーナー)ドロップダウンメニューを使い、リポジトリを所有したいアカウントを選択してく� さい。
- リポジトリの名前と、任意で説明を入力してく� さい。 ユーザもしくはOrganizationのサイトを作成しているなら、リポジトリは
<user>.github.io
もしくは<organization>.github.io
という名前でなければなりません。 If your user or organization name contains uppercase letters, you must lowercase the letters. 詳しい情� �については「GitHub Pagesについて」を参照してく� さい。 - リポジトリの可視性を選択してく� さい。 For more information, see "About repositories."
- [Initialize this repository with a README] を選択します。
- [Create repository] をクリックします。
サイトを作成する
サイトを作成する前には、GitHub Enterprise Server上にサイトのためのリポジトリを持っていなければなりません。 既存のリポジトリ内にサイトを作成しようとしているのではないなら、「サイトのためのリポジトリの作成」を参照してく� さい。
Warning: If your site administrator has enabled Public Pages, GitHub Pages sites are publicly available on the internet, even if the repository for the site is private or internal. If you have sensitive data in your site's repository, you may want to remove the data before publishing. For more information, see "Configuring GitHub Pages for your enterprise" and "About repositories."
-
GitHub Enterprise Serverで、サイトのリポジトリにアクセスしてく� さい。
-
Decide which publishing source you want to use. 詳しい情� �については「GitHub Pagesについて」を参照してく� さい。
-
選択した公開元が既に存在する� �合、公開元に移動します。 選択した公開元がま� 存在しない� �合は、公開元を作成します。
-
公開元のルートに、サイトのメインページに表示したいコンテンツを含ん� 、
index.md
という名前の新しいファイルを作成します。参考:
index.html
があるなら、index.md
の代わりに利用されます。index.html
もindex.md
もないなら、README.md
が使われます。 -
公開ソースを設定してく� さい。 詳しい情� �については「GitHub Pages サイトの公開元を設定する」を参照してく� さい。
-
リポジトリ名の下で Settings(設定)をクリックしてく� さい。
-
左のサイドバーでPages(ページ)をクリックしてく� さい。
-
公開されたサイトを見るには、"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."
Note: If your site has not published automatically, make sure someone with admin permissions and a verified email address has pushed to the publishing source.
次のステップ
新しいファイルを追� で作成することにより、ページを追� できます。 各ファイルは、公開元と同じディレクトリ構� で、サイト上に表示されます。 たとえば、プロジェクトサイトの公開元が 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」を参照してく� さい。