Jekyll を使用して GitHub Pages サイトを設定する
静的サイトジェネレータとして広く利用されている Jekyll を使用して、GitHub Pages サイトをさらにカスタマイズすることができます。
この機能を使用できるユーザーについて
GitHub Pagesは、パブリック・リポジトリのGitHub Freeと組織用のGitHub Free、パブリック・リポジトリとプライベート・リポジトリのGitHub Pro、GitHub Team、GitHub Enterprise Cloud、GitHub Enterprise Serverで利用できます。 詳しくは、「GitHub のプラン」をご覧ください。
GitHub Pages で、Jekyll ビルドの実行に GitHub Actions が使用されるようになりました。 ビルドのソースとしてブランチを使用する際、組み込みの Jekyll ワークフローを使用する場合は、リポジトリで GitHub Actions を有効にする必要があります。 GitHub Actions が使用できない場合、または無効になっている場合は、ソース ブランチのルートに .nojekyll
ファイルを追加すると、Jekyll ビルド プロセスがバイパスされ、コンテンツが直接デプロイされます。 GitHub Actions の有効化の詳細については、「リポジトリの GitHub Actions の設定を管理する」を参照してください。
GitHub PagesとJekyllについて
Jekyllは、GitHub Pagesのサポートが組み込まれている静的サイトジェネレータです。
Jekyll を使用して GitHub Pages サイトを作成する
新規または既存のリポジトリ内に、GitHub Pages Jekyll を使用してサイトを作成できます。
Jekyll を使用して GitHub Pages サイトをローカルでテストする
GitHub Pages サイトをローカルでビルドすると、サイトに対する変更のプレビューとテストを行うことができます。
Jekyll を使用して GitHub Pages サイトにコンテンツを追加する
GitHub Pages の Jekyll サイトに、新規ページや投稿を追加できます。
Jekyll を使用して、GitHub Pages サイトの Markdown プロセッサを設定する
Markdown プロセッサを選択して、GitHub Pages サイトで Markdown をどのようにレンダリングするかを決めることができます。
Jekyll を使用して GitHub Pages サイトにテーマを追加する
テーマを追加およびカスタマイズすることにより、Jekyll サイトをパーソナライズできます。
GitHub PagesサイトのJekyllビルドエラーについて
ローカルで、またはGitHub上でGitHub Pagesサイトをビルド中にJekyllでエラーが発生した場合には、詳細情報を伴うエラーメッセージが示されます。
GitHub Pages サイトの Jekyll ビルドエラーに関するトラブルシューティング
Jekyll ビルドエラーのメッセージを利用して、GitHub Pages サイトの問題をトラブルシューティングすることができます。