Jekyll を使用して GitHub Pages サイトにテーマを追加する

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

ブランチから公開している場合、自分のサイトに加えた変更は、それが該当するサイトの公開元にマージされると、自動的に公開されます。カスタムの GitHub Actions ワークフローから公開している場合、変更はご利用のワークフローがトリガーされるたびに公開されます (通常は既定のブランチへのプッシュによる)。まず変更をプレビューしたいなら、GitHub Enterprise Cloud 上ではなくローカルで変更を行うことができます。そしてサイトをローカルでテストしてください。詳しくは、「Jekyll を使用して GitHub Pages サイトをローカルでテストする」を参照してください。

テーマを追加する

GitHub Enterprise Cloudで、サイトのリポジトリにアクセスしてください。 1. サイトの公開ソースにアクセスしてください。詳しくは、「GitHub Pages サイトの公開元を設定する」を参照してください。
_config.yml に移動します。
ファイルビューの右上の隅で、をクリックしてファイルエディターを開きます。

注: ファイルの編集とコミットに既定のファイルエディターを使うのではなく、必要に応じて github.dev コードエディターを使用できます。それには、の横にあるドロップダウンメニューをクリックし、 [Open in github.dev](github.dev で開く) を選びます。
テーマ名のために、ファイルに新しい行を追加します。
- サポートされているテーマを使用するには、「theme: THEME-NAME」と入力します。THEME-NAME の部分は、テーマのリポジトリの README に示されているテーマ名に置き換えてください。サポートされているテーマの一覧については、GitHub Pages サイトの「サポートされているテーマ」を参照してください。
- GitHub でホストされているその他の任意の Jekyll テーマを使うには、「remote_theme: THEME-NAME」と入力します。THEME-NAME の部分は、テーマのリポジトリの README に表示されている名前に置き換えます。 1. ページの下部で、ファイルに対して行った変更を説明する短く分かりやすいコミットメッセージを入力してください。コミットメッセージでは、複数の作者にコミットを関連づけることができます。詳しくは、「複数の作者を持つコミットを作成する」を参照してください。
GitHub.com のアカウントに複数のメールアドレスが関連付けられている場合は、[メールアドレス] ドロップダウンメニューをクリックし、Git 作成者のメールアドレスとして使用するメールアドレスを選びます。このドロップダウンメニューには、検証済みのメールアドレスだけが表示されます。メールアドレスのプライバシーを有効にした場合は、<username>@users.noreply.github.com が既定のコミット作成者のメールアドレスになります。詳しくは、「コミットメールアドレスを設定する」を参照してください。 1. コミットメッセージフィールドの下で、コミットの追加先を現在のブランチか新しいブランチから選択してください。現在のブランチがデフォルトブランチなら、コミット用に新しいブランチを作成してからPull Requestを作成すべきです。詳しくは、「pull request の作成」を参照してください。 1. [ファイルの変更の提案] をクリックします。

テーマの CSS をカスタマイズする

これらの手順は、GitHub Pages によって公式にサポートされているテーマで最もうまくいきます。サポートされているテーマの完全な一覧については、GitHub Pages サイトの「サポートされているテーマ」をご覧ください。

テーマのソースリポジトリには、テーマのカスタマイズに関するヘルプがあるかもしれません。たとえば、Minima の README を参照してください。

GitHub Enterprise Cloudで、サイトのリポジトリにアクセスしてください。 1. サイトの公開ソースにアクセスしてください。詳しくは、「GitHub Pages サイトの公開元を設定する」を参照してください。
/assets/css/style.scss という新しいファイルを作成します。
ファイルの先頭に、以下の内容を追加します。
```
---
---

@import "{{ site.theme }}";
```
カスタム CSS または Sass (インポートファイルも含む) があれば、@import 行の直後に追加します。

テーマの HTML レイアウトをカスタマイズする