# Jekyll を使用してGitHub ページ サイトにコンテンツを追加する

GitHub Pages の Jekyll サイトに、新規ページや投稿を追加できます。

> \[!NOTE] `github-pages` gem は一部のワークフローで引き続きサポートされますが、GitHub Actions サイトのデプロイと自動化のための推奨される方法は GitHub Pages になりました。

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

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

GitHub Pages で Jekyll サイトにコンテンツを追加する前に、Jekyll サイトを作成する必要があります。 詳しくは、「[Jekyll を使用して GitHub Pages サイトを作成する](/ja/enterprise-cloud@latest/pages/setting-up-a-github-pages-site-with-jekyll/creating-a-github-pages-site-with-jekyll)」をご覧ください。

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

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

テーマには、サイトの新しいページと投稿に自動的に適用される既定のレイアウトとスタイルシートが含まれますが、これらの既定値はいずれもオーバーライドできます。 詳しくは、「[GitHub ページと Jekyll について](/ja/enterprise-cloud@latest/pages/setting-up-a-github-pages-site-with-jekyll/about-github-pages-and-jekyll#themes)」をご覧ください。

サイト上のページやポストに対してタイトルやレイアウトといった変数やメタデータを設定するには、任意のMarkdownあるいはHTMLファイルの先頭にYAMLフロントマターを追加できます。 詳しくは、Jekyll のドキュメントの「[フロント マター](https://jekyllrb.com/docs/front-matter/)」をご覧ください。

ブランチから公開している場合、サイトへの変更は、サイトの公開ソースにマージされるときに自動的に公開されます。 カスタムの GitHub Actions ワークフローから公開している場合、(通常は既定のブランチへのプッシュによって) ワークフローがトリガーされるたびに変更が公開されます。 まず変更をプレビューする場合は、GitHub ではなくローカルで変更を行うことができます。 そしてサイトをローカルでテストしてください。 詳しくは、「[Jekyll を使用して GitHub Pages サイトをローカルでテストする](/ja/enterprise-cloud@latest/pages/setting-up-a-github-pages-site-with-jekyll/testing-your-github-pages-site-locally-with-jekyll)」をご覧ください。

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

1. GitHub で、サイトのリポジトリにアクセスしてください。1. サイトの公開ソースにアクセスしてください。 詳しくは、「[GitHub Pages サイトの発行ソースの構成](/ja/enterprise-cloud@latest/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site)」をご覧ください。

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` に配置されます。

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

4. frontmatter の下に、ページのコンテンツを追加します。

5. **\[変更のコミット...]** をクリックします。

6. \[コミット メッセージ] フィールドに、ファイルに対する変更内容を説明する、短くわかりやすいコミット メッセージを入力します。 コミットメッセージでは、複数の作者にコミットを関連づけることができます。 詳しくは、「[複数の作成者または組織に代わってコミットを作成する](/ja/enterprise-cloud@latest/pull-requests/how-tos/commit-changes/creating-a-commit-with-multiple-authors)」をご覧ください。

7. GitHubのアカウントに複数のメール アドレスが関連付けられている場合は、メール アドレスのドロップダウン メニューをクリックし、Git 作成者のメール アドレスとして使用するメール アドレスを選択します。 このドロップダウンメニューには、検証済みのメールアドレスだけが表示されます。 メール アドレスのプライバシーを有効にした場合は、no-reply がコミット作成者の既定のメール アドレスになります。 no-reply メール アドレスの正確な形式の詳細については、「[コミットメールアドレスを設定する](/ja/enterprise-cloud@latest/account-and-profile/how-tos/email-preferences/setting-your-commit-email-address)」を参照してください。

![GitHub pull request のスクリーンショット。コミット作成者のメール アドレスを選ぶためのオプションを含む、ドロップダウン メニューが表示されています。
octocat@github.com が選択されています。](/assets/images/help/repository/choose-commit-email-address.png)

1. コミットメッセージフィールドの下で、コミットの追加先を現在のブランチか新しいブランチから選択してください。 現在のブランチがデフォルトブランチなら、コミット用に新しいブランチを作成してからPull Requestを作成すべきです。 詳しくは、「[pull request の作成](/ja/enterprise-cloud@latest/pull-requests/how-tos/create-pull-requests/creating-a-pull-request)」をご覧ください。

   ![GitHub pull request のスクリーンショット。メイン ブランチに直接コミットする、または新しいブランチを作成するためのラジオ ボタンが表示されています。 新しいブランチが選択されています。](/assets/images/help/repository/choose-commit-branch.png)
2. **\[変更のコミット]** または **\[変更の提案]** をクリックします。
3. 提案した変更に対するPull Requestを作成してください。
4. "Pull Requests"リスト内で、マージしたいPull Requestをクリックしてください。
5. **Merge pull request** をクリックします。 詳しくは、「[pull request のマージ](/ja/enterprise-cloud@latest/pull-requests/how-tos/merge-and-close-pull-requests/merging-a-pull-request)」をご覧ください。
6. 要求されたら、コミットメッセージを入力するか、デフォルトのメッセージのままにします。
7. **\[マージの確認]** をクリックします。
8. あるいは、ブランチを削除してください。 詳しくは、「[リポジトリ内のブランチの管理](/ja/enterprise-cloud@latest/pull-requests/how-tos/commit-changes/managing-branches-within-your-repository)」をご覧ください。

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

1. GitHub で、サイトのリポジトリにアクセスしてください。1. サイトの公開ソースにアクセスしてください。 詳しくは、「[GitHub Pages サイトの発行ソースの構成](/ja/enterprise-cloud@latest/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site)」をご覧ください。

2. `_posts` ディレクトリに移動します。

3. `YYYY-MM-DD-NAME-OF-POST.md` という名前の新しいファイルを作成し、YYYY-MM-DD をご自分が投稿する日付に置き換え、NAME-OF-POST を投稿の名前に置き換えます。

4. 次の YAML frontmatter (引用符で囲まれた投稿のタイトル、YYYY-MM-DD hh:mm:ss -0000 の形式での投稿の日時、投稿に必要な数のカテゴリなど) をファイルの先頭に追加します。

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

5. frontmatter の下に、投稿のコンテンツを追加します。

6. **\[変更のコミット...]** をクリックします。

7. \[コミット メッセージ] フィールドに、ファイルに対する変更内容を説明する、短くわかりやすいコミット メッセージを入力します。 コミットメッセージでは、複数の作者にコミットを関連づけることができます。 詳しくは、「[複数の作成者または組織に代わってコミットを作成する](/ja/enterprise-cloud@latest/pull-requests/how-tos/commit-changes/creating-a-commit-with-multiple-authors)」をご覧ください。

8. GitHubのアカウントに複数のメール アドレスが関連付けられている場合は、メール アドレスのドロップダウン メニューをクリックし、Git 作成者のメール アドレスとして使用するメール アドレスを選択します。 このドロップダウンメニューには、検証済みのメールアドレスだけが表示されます。 メール アドレスのプライバシーを有効にした場合は、no-reply がコミット作成者の既定のメール アドレスになります。 no-reply メール アドレスの正確な形式の詳細については、「[コミットメールアドレスを設定する](/ja/enterprise-cloud@latest/account-and-profile/how-tos/email-preferences/setting-your-commit-email-address)」を参照してください。

![GitHub pull request のスクリーンショット。コミット作成者のメール アドレスを選ぶためのオプションを含む、ドロップダウン メニューが表示されています。
octocat@github.com が選択されています。](/assets/images/help/repository/choose-commit-email-address.png)

1. コミットメッセージフィールドの下で、コミットの追加先を現在のブランチか新しいブランチから選択してください。 現在のブランチがデフォルトブランチなら、コミット用に新しいブランチを作成してからPull Requestを作成すべきです。 詳しくは、「[pull request の作成](/ja/enterprise-cloud@latest/pull-requests/how-tos/create-pull-requests/creating-a-pull-request)」をご覧ください。

   ![GitHub pull request のスクリーンショット。メイン ブランチに直接コミットする、または新しいブランチを作成するためのラジオ ボタンが表示されています。 新しいブランチが選択されています。](/assets/images/help/repository/choose-commit-branch.png)
2. **\[変更のコミット]** または **\[変更の提案]** をクリックします。
3. 提案した変更に対するPull Requestを作成してください。
4. "Pull Requests"リスト内で、マージしたいPull Requestをクリックしてください。
5. **Merge pull request** をクリックします。 詳しくは、「[pull request のマージ](/ja/enterprise-cloud@latest/pull-requests/how-tos/merge-and-close-pull-requests/merging-a-pull-request)」をご覧ください。
6. 要求されたら、コミットメッセージを入力するか、デフォルトのメッセージのままにします。
7. **\[マージの確認]** をクリックします。
8. あるいは、ブランチを削除してください。 詳しくは、「[リポジトリ内のブランチの管理](/ja/enterprise-cloud@latest/pull-requests/how-tos/commit-changes/managing-branches-within-your-repository)」をご覧ください。

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

## 次のステップ

JekyllのテーマをGitHub Pagesサイトに追加して、サイトのルックアンドフィールをカスタマイズできます。詳細については、「[Jekyll を使用して GitHub Pages サイトにテーマを追加する](/ja/enterprise-cloud@latest/pages/setting-up-a-github-pages-site-with-jekyll/adding-a-theme-to-your-github-pages-site-using-jekyll)」を参照してください。