Jekyll を使用して GitHub Pages サイトにコンテンツを追� する

リポジトリへの書き込み権限があるユーザは、Jekyll を使用して GitHub Pages サイトにコンテンツを追� できます。

Jekyll サイトのコンテンツについて

GitHub Pages で Jekyll サイトにコンテンツを追� する前に、Jekyll サイトを作成する必要があります。 詳細については、「Jekyll で GitHub Pages サイトを作成する」を参照してく� さい。

Jekyll サイトのコンテンツとして 2 つの主なタイプは、ページと投稿です。 ページとは、特定の日付に紐付けられていない、「About」ページなどの独立したコンテンツです。 既定の Jekyll サイトには、YOUR-SITE-URL/about のご自分のサイトでページとしてレンダリングされる about.md というファイルが含まれています。 このファイルのコンテンツを編集して、「About」ページをパーソナライズできます。また、新しいページを作成するため、「About」ページをテンプレートとして使用できます。 詳細については、Jekyll のドキュメントの「Pages」(ページ) を参照してく� さい。

投稿とは、ブログ記事のことです。 デフォルトの Jekyll サイトには、既定の投稿ファイルがある、_posts という名前のディレクトリが含まれています。 この投稿のコンテンツを編集し、デフォルト投稿を、新規投稿を作成するためのテンプレートとして使用できます。 詳細については、Jekyll のドキュメントの「Posts」(投稿) を参照してく� さい。

テーマには、デフォルトのレイアウト、およびサイトの新規ページや新規投稿に自動的に適用されるスタイルシートが含まれますが、これらのデフォルト設定はオーバーライドできます。 詳細については、「GitHub Pages と Jekyll について」を参照してく� さい。

サイト上のページやポストに対してタイトルやレイアウトといった変数やメタデータを設定するには、任意のMarkdownあるいはHTMLファイルの先� �にYAMLフロントマターを追� できます。 詳しくは、Jekyll のドキュメントの「フロント マター」をご覧く� さい。

変更 は、それが該当するサイトの公開元にマージされると、自動的に公開されます。 まず変更をプレビューしたいなら、GitHub Enterprise Server 上ではなくローカルで変更を行うことができます。 そしてサイトをローカルでテストしてく� さい。 詳細については、「Jekyll を使用して GitHub Pages サイトをローカルでテストする」を参照してく� さい。

新規ページをサイトに追� する

1. GitHub Enterprise Serverで、サイトのリポジトリにアクセスしてく� さい。 1. サイトの公開ソースにアクセスしてく� さい。 詳細については、「ご利用の GitHub Pages サイトに合わせた公開元の構成」を参照してく� さい。
2. 公開元のルートに、ご自分のページ用の PAGE NAME.md という名前の新規ファイルを作成します。PAGE-NAME は、ページを示す意味のあるファイル名に置き換えます。
3. 以下の YAML frontmatter を、ファイルの先� �に追� します。PAGE TITLE はページのタイトルに、URL-PATH はページの URL として指定するパスに置き換えます。 たとえば、サイトのベース URL が https://octocat.github.io で URL-PATH が /about/contact/ である� �合、ページは https://octocat.github.io/about/contact に配置されます。

   layout: page
   title: "PAGE TITLE"
   permalink: /URL-PATH/

4. frontmatter の下に、ページのコンテンツを追� します。
5. ページの下部で、ファイルに対して行った変更を説明する短く分かりやすいコミットメッセージを入力してく� さい。 コミットメッセージでは、複数の作者にコミットを関連づけることができます。 詳細については、「複数の共同作成者とのコミットの作成」を参照してく� さい。 1. コミットメッセージフィールドの下で、コミットの追� 先を現在のブランチか新しいブランチから選択してく� さい。 現在のブランチがデフォルトブランチなら、コミット用に新しいブランチを作成してからPull Requestを作成すべきです。 詳細については、「新しい pull request の作成」を参照してく� さい。 1. [ファイルの変更の提案] をクリックします。 1. 提案した変更に対するPull Requestを作成してく� さい。
6. "Pull Requests"リスト内で、マージしたいPull Requestをクリックしてく� さい。 1. [pull request のマージ] をクリックします。 詳細については、pull request のマージに関するページを参照してく� さい。 1. 要求されたら、コミットメッセージを入力するか、デフォルトのメッセージのままにします。 1. [マージの確認] をクリックします。 1. あるいは、ブランチを削除してく� さい。 詳細については、「リポジトリ内でブランチを作成および削除する」を参照してく� さい。

新規投稿をサイトに追� する

1. GitHub Enterprise Serverで、サイトのリポジトリにアクセスしてく� さい。 1. サイトの公開ソースにアクセスしてく� さい。 詳細については、「ご利用の GitHub Pages サイトに合わせた公開元の構成」を参照してく� さい。
2. _posts ディレクトリに移動します。
3. YYYY-MM-DD-NAME-OF-POST.md という名前の新しいファイルを作成し、YYYY-MM-DD をご自分が投稿する日付に置き換え、NAME-OF-POST を投稿の名前に置き換えます。
4. 以下の YAML frontmatter を、ファイルの先� �に追� して、POST TITLE は投稿のタイトルに、YYYY-MM-DD hh:mm:ss -0000 は投稿の日時に置き換え、CATEGORY-1、CATEGORY-2 を投稿するカテゴリの数に合わせて置き換えてく� さい。

   layout: post
   title: "POST TITLE"
   date: YYYY-MM-DD hh:mm:ss -0000
   categories: CATEGORY-1 CATEGORY-2

5. frontmatter の下に、投稿のコンテンツを追� します。
6. ページの下部で、ファイルに対して行った変更を説明する短く分かりやすいコミットメッセージを入力してく� さい。 コミットメッセージでは、複数の作者にコミットを関連づけることができます。 詳細については、「複数の共同作成者とのコミットの作成」を参照してく� さい。 1. コミットメッセージフィールドの下で、コミットの追� 先を現在のブランチか新しいブランチから選択してく� さい。 現在のブランチがデフォルトブランチなら、コミット用に新しいブランチを作成してからPull Requestを作成すべきです。 詳細については、「新しい pull request の作成」を参照してく� さい。 1. [ファイルの変更の提案] をクリックします。 1. 提案した変更に対するPull Requestを作成してく� さい。
7. "Pull Requests"リスト内で、マージしたいPull Requestをクリックしてく� さい。 1. [pull request のマージ] をクリックします。 詳細については、pull request のマージに関するページを参照してく� さい。 1. 要求されたら、コミットメッセージを入力するか、デフォルトのメッセージのままにします。 1. [マージの確認] をクリックします。 1. あるいは、ブランチを削除してく� さい。 詳細については、「リポジトリ内でブランチを作成および削除する」を参照してく� さい。

あなたの投稿がサイトにアップされているはずです。 ご自分のベース URL がhttps://octocat.github.io の� �合は新しい投稿の� �所は https://octocat.github.io/YYYY/MM/DD/TITLE.html になります。

次のステップ

JekyllのテーマをGitHub Pagesサイトに追� して、サイトのルックアンドフィールをカスタマイズできます。 詳細については、「Jekyll を使って GitHub Pages サイトにテーマを追� する」を参照してく� さい。