ドキュメントには頻繁に更新が加えられ、その都度公開されています。本ページの翻訳はまだ未完成な部分があることをご了承ください。最新の情報については、英語のドキュメンテーションをご参照ください。本ページの翻訳に問題がある場合はこちらまでご連絡ください。

このバージョンの GitHub Enterprise はこの日付をもって終了となりました: 2021-03-02. 重大なセキュリティの問題に対してであっても、パッチリリースは作成されません。 パフォーマンスの向上、セキュリティの改善、新機能のためには、最新バージョンのGitHub Enterpriseにアップグレードしてください。 アップグレードに関する支援については、GitHub Enterprise supportに連絡してください。

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

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

GitHub Pages is available in public repositories with GitHub Free and GitHub Free for organizations, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server.

ここには以下の内容があります:

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

変更がサイトの公開ソースにマージされると、サイトへの変更は自動的に公開されます。 まず変更をプレビューしたいなら、GitHub Enterprise Serverではなくローカルで変更を行えます。 そしてサイトをローカルでテストしてください。 詳しい情報については、「Jekyll を使用して GitHub Pages サイトをローカルでテストする」を参照してください。

テーマを追加する

  1. GitHub Enterprise Serverで、サイトのリポジトリにアクセスしてください。

  2. サイトの公開ソースにアクセスしてください。 公開元に関する詳しい情報については、「GitHub Pages について」を参照してください。

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

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

    ファイルの編集ボタン

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

    • To use a supported theme, type theme: THEME-NAME, replacing THEME-NAME with the name of the theme as shown in the README of the theme's repository. サポートされているテーマのリストについては、GitHub Pages サイトで「サポートされているテーマ」を参照してください。
      Supported theme in config file
    • GitHub にホストされているその他の任意の Jekyll テーマを使うには、remote_theme: THEME-NAME と入力します。THEME-NAME の部分は、テーマのリポジトリの README に表示されている名前に置き換えます。
      Unsupported theme in config file
  6. ページの下部で、ファイルに対して行った変更を説明する短く分かりやすいコミットメッセージを入力してください。 コミットメッセージでは、複数の作者にコミットを関連づけることができます。 詳しい情報については「複数の共作者を持つコミットの作成」を参照してください。

    変更のコミットメッセージ

  7. コミットメッセージフィールドの下で、コミットを追加を現在のブランチか新しいブランチから選択してください。 If your current branch is the default branch, you should choose to create a new branch for your commit and then create a pull request. 詳しい情報については「新しいプルリクエストの作成」を参照してください。

    コミットブランチのオプション

  8. [Propose file change] をクリックします。

    ファイル変更の提案ボタン

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

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

  1. GitHub Enterprise Serverで、サイトのリポジトリにアクセスしてください。

  2. サイトの公開ソースにアクセスしてください。 公開元に関する詳しい情報については、「GitHub Pages について」を参照してください。

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

  4. ファイルの先頭に、以下の内容を追加します。

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

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

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

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

参考リンク