Skip to main content

Jekyll を使用して、 Pages サイトの Markdown プロセッサを設定する

Markdown プロセッサを選択して、 Pages サイトで Markdown をどのようにレンダリングするかを決めることができます。

この機能を使用できるユーザーについて

Pagesは、パブリック・リポジトリの Freeと組織用の Free、パブリック・リポジトリとプライベート・リポジトリの Pro、 Team、 Enterprise Cloud、 Enterprise Serverで利用できます。 詳細については、「 のプラン」を参照してください。

Pages で、Jekyll ビルドの実行に Actions が使用されるようになりました。 ビルドのソースとしてブランチを使用する際、組み込みの Jekyll ワークフローを使用する場合は、リポジトリで Actions を有効にする必要があります。 Actions が使用できない場合、または無効になっている場合は、ソース ブランチのルートに .nojekyll ファイルを追加すると、Jekyll ビルド プロセスがバイパスされ、コンテンツが直接デプロイされます。 Actions を有効にする方法の詳細については、「リポジトリの Actions の設定を管理する」を参照してください。

リポジトリへの書き込み権限があるユーザは、 Pages サイトに対して Markdown プロセッサを設定できます。

Pages は、kramdown と の独自の Markdown プロセッサという 2 つの Markdown プロセッサをサポートしています。後者は を通じて Flavored Markdown (GFM) をレンダリングする際に使われます。 詳しくは、「 上での執筆とフォーマットについて」をご覧ください。

フレーバーの Markdown はどちらのプロセッサでも使用できます。

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

  2. リポジトリで _config.yml ファイルを参照します。

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

    ファイルのスクリーンショット。 ヘッダーにある鉛筆アイコンのラベルが付いたボタンが濃いオレンジ色の枠線で囲まれています。

    メモ

    既定のファイル エディターを使ってファイルの編集とコミットを行う代わりに、必要に応じて .dev コード エディターを使用できます。それには、 ドロップダウン メニューを選んで、[.dev] をクリックします。 また、 Desktop をクリックして、 Desktop を使用してリポジトリを複製し、ローカルでファイルを編集することもできます。

    ファイルのスクリーンショット。 ヘッダーの下向き三角形のアイコンが、濃いオレンジ色の枠線で囲まれています。

  4. markdown: で始まる行を見つけ、値を kramdown または GFM に変更します。 完全な行は markdown: kramdown または markdown: GFM となります。

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

  6. [コミット メッセージ] フィールドに、ファイルに対する変更内容を説明する、短くわかりやすいコミット メッセージを入力します。 コミットメッセージでは、複数の作者にコミットを関連づけることができます。 詳しくは、「複数の作者を持つコミットを作成する」をご覧ください。

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

    GitHub pull request のスクリーンショット。コミット作成者のメール アドレスを選ぶためのオプションを含む、ドロップダウン メニューが表示されています。 octocat@github.com が選ばれています。

  8. コミットメッセージフィールドの下で、コミットの追加先を現在のブランチか新しいブランチから選択してください。 現在のブランチがデフォルトブランチなら、コミット用に新しいブランチを作成してからPull Requestを作成すべきです。 詳しくは、「pull request の作成」をご覧ください。

    GitHub pull request のスクリーンショット。メイン ブランチに直接コミットする、または新しいブランチを作成するためのラジオ ボタンが表示されています。 新しいブランチが選ばれています。

  9. [変更のコミット] または [変更の提案] をクリックします。

参考資料