記事のバージョン: Enterprise Server 2.17
Jekyll を使用して GitHub Pages サイトにテーマを追加する
テーマを追加およびカスタマイズすることにより、Jekyll サイトをパーソナライズできます。
GitHub Pagesは、GitHub Free 及びGitHub FreeのOrganizationではパブリックリポジトリでのみ使用でき、GitHub Pro、GitHub Team、GitHub Enterprise Cloud、GitHub Enterprise Server ではパブリックおよびプライベートリポジトリで使用できます。
リポジトリへの書き込み権限があるユーザは、Jekyll を使用して GitHub Pages サイトにテーマを追加できます。
変更がサイトの公開ソースにマージされると、サイトへの変更は自動的に公開されます。 まず変更をプレビューしたいなら、GitHub Enterpriseではなくローカルで変更を行えます。 そしてサイトをローカルでテストしてください。 詳しい情報については、「Jekyll を使用して GitHub Pages サイトをローカルでテストする」を参照してください。
テーマを追加する
-
GitHub Enterpriseで、サイトのリポジトリにアクセスしてください。
-
サイトの公開ソースにアクセスしてください。 公開元に関する詳しい情報については、「GitHub Pages について」を参照してください。
-
_config.yml に移動します。
-
ファイルビューの右上の隅で、 をクリックしてファイルエディタを開きます。
-
テーマ名のために、ファイルに新しい行を追加します。
theme: THEME-NAME
と入力します。THEME-NAME の部分は、テーマのリポジトリの README に表示されている名前に置き換えます。 サポートされているテーマのリストについては、GitHub Pages サイトで「サポートされているテーマ」を参照してください。 -
ページの下部で、ファイルに対して行った変更を説明する短く分かりやすいコミットメッセージを入力してください。 コミットメッセージでは、複数の作者にコミットを関連づけることができます。 詳しい情報については「複数の共作者を持つコミットの作成」を参照してください。
-
コミットメッセージフィールドの下で、コミットの追加先を現在のブランチか新しいブランチから選択してください。 現在のブランチが
master
であれば、コミット先として新しいブランチを作成することを選択し、続いてプルリクエストを作成しなければなりません。 詳しい情報については「新しいプルリクエストの作成」を参照してください。 -
[Propose file change] をクリックします。
テーマの CSS をカスタマイズする
テーマのソースリポジトリには、テーマのカスタマイズに関するヘルプがあるかもしれません。 例として「MinimaのREADME」を参照してください。
-
GitHub Enterpriseで、サイトのリポジトリにアクセスしてください。
-
サイトの公開ソースにアクセスしてください。 公開元に関する詳しい情報については、「GitHub Pages について」を参照してください。
-
/assets/css/style.scss という新しいファイルを作成します。
-
ファイルの先頭に、以下の内容を追加します。
--- --- @import "";
-
カスタム CSS または Sass (インポートファイルも含む) があれば
@import
行の直後に追加します。
テーマの HTML レイアウトをカスタマイズする
テーマのソースリポジトリには、テーマのカスタマイズに関するヘルプがあるかもしれません。 例として「MinimaのREADME」を参照してください。
- GitHub 上で、テーマのソースリポジトリにアクセスします。 たとえば、Minima のソースリポジトリは https://github.com/jekyll/minima です。
- _layouts フォルダ内で、テーマの default.html ファイルに移動します。
- ファイルのコンテンツをコピーします。
- GitHub Enterpriseで、サイトのリポジトリにアクセスしてください。
- サイトの公開ソースにアクセスしてください。 公開元に関する詳しい情報については、「GitHub Pages について」を参照してください。
- _layouts/default.html というファイルを作成します。
- 先ほどコピーしたデフォルトのレイアウトコンテンツを貼り付けます。
- 必要に応じてレイアウトをカスタマイズします。