Skip to main content

このバージョンの GitHub Enterprise はこの日付をもって終了となりました: 2022-10-12. 重大なセキュリティの問題に対してであっても、パッチリリースは作成されません。 パフォーマンスの向上、セキュリティの向上、新機能の向上を図るために、最新バージョンの GitHub Enterprise にアップグレードします。 アップグレードに関するヘルプについては、GitHub Enterprise サポートにお問い合わせく� さい

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

テーマを追� およびカスタマイズすることにより、Jekyll サイトをパーソナライズできます。

GitHub Pagesは、GitHub Free及びOrganizationのGitHub Freeのパブリックリポジトリ、GitHub Pro、GitHub Team、GitHub Enterprise Cloud、GitHub Enterprise Serverのパブリック及びプライベートリポジトリで利用できます。

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

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

テーマを追� する

  1. GitHub Enterprise Serverで、サイトのリポジトリにアクセスしてく� さい。 1. サイトの公開ソースにアクセスしてく� さい。 詳細については、「ご利用の GitHub Pages サイトに合わせた公開元の構成」を参照してく� さい。

  2. _config.yml に移動します。

  3. ファイル ビューの右上の隅で、 をクリックしてファイル エディターを開きます。

    [ファイルの編集] ボタン

  4. テーマ名のために、ファイルに新しい行を追� します。

    • サポートされているテーマを使用するには、「theme: THEME-NAME」と入力します。THEME-NAME の部分は、テーマのリポジトリの README に示されているテーマ名に置き換えてく� さい。 サポートされているテーマの一覧については、GitHub Pages サイトの「サポートされているテーマ」を参照してく� さい。 構成ファイルでサポートされているテーマ
    • GitHub でホストされているその他の任意の Jekyll テーマを使うには、「remote_theme: THEME-NAME」と入力します。THEME-NAME の部分は、テーマのリポジトリの README に表示されている名前に置き換えます。 構成ファイルでサポートされていないテーマ 1. ページの下部で、ファイルに対して行った変更を説明する短く分かりやすいコミットメッセージを入力してく� さい。 コミットメッセージでは、複数の作者にコミットを関連づけることができます。 詳細については、「複数の共同作成者とのコミットの作成」を参照してく� さい。 変更のコミット メッセージ 1. コミットメッセージフィールドの下で、コミットの追� 先を現在のブランチか新しいブランチから選択してく� さい。 現在のブランチがデフォルトブランチなら、コミット用に新しいブランチを作成してからPull Requestを作成すべきです。 詳細については、「新しい pull request の作成」を参照してく� さい。 コミット ブランチのオプション 1. [ファイルの変更の提案] をクリックします。 [ファイルの変更の提案] ボタン

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

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

  1. GitHub Enterprise Serverで、サイトのリポジトリにアクセスしてく� さい。 1. サイトの公開ソースにアクセスしてく� さい。 詳細については、「ご利用の GitHub Pages サイトに合わせた公開元の構成」を参照してく� さい。

  2. /assets/css/style.scss という新しいファイルを作成します。

  3. ファイルの先� �に、以下の内容を追� します。

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

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

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

  1. GitHub 上で、テーマのソースリポジトリにアクセスします。 たとえば、Minima のソース リポジトリは https://github.com/jekyll/minima です。
  2. _layouts フォルダー内で、テーマの default.html ファイルに移動します。
  3. ファイルの内容をコピーします。
  4. GitHub Enterprise Serverで、サイトのリポジトリにアクセスしてく� さい。 1. サイトの公開ソースにアクセスしてく� さい。 詳細については、「ご利用の GitHub Pages サイトに合わせた公開元の構成」を参照してく� さい。
  5. _layouts/default.html という名前のファイルを作成します。
  6. 先ほどコピーしたデフォルトのレイアウトコンテンツを貼り付けます。
  7. 必要に応じてレイアウトをカスタマイズします。

参考資料