GitHub PagesサイトのJekyllビルドエラーについて

Jekyllのビルドエラーについて

ブランチから公開している場合、サイトの公開ソースに変更をプッシュした後で GitHub Pages がサイトのビルドを試行しない場合があります。

変更をプッシュしたユーザーがメールアドレスを検証していない。詳細については、「メールアドレスを検証する」を参照してください。
デプロイキーでプッシュしている。サイトのリポジトリへのプッシュを自動化する場合は、かわりにマシンユーザーを設定できます。詳しくは、「デプロイキーの管理」をご覧ください。
公開元をビルドするようにCIサービスを設定していない。たとえば、Travis CI は、ブランチをセーフリストに追加しない限り、gh-pages ブランチをビルドしません。詳細については、Travis CI の「ビルドのカスタマイズ」またはお使いの CI サービスのドキュメントを参照してください。

メモ

サイトに対する変更は、その変更を GitHub にプッシュしてから公開されるまでに最大 10 分かかることがあります。

Jekyll がサイトのビルドを試行せず、エラーが発生した場合は、ビルドエラーメッセージが表示されます。

ビルドエラーのトラブルシューティングの詳細については、「GitHub Pages サイトの Jekyll ビルドエラーに関するトラブルシューティング」を参照してください。

GitHub ActionsでJekyllのビルドエラーメッセージを表示する

デフォルトでは、GitHub PagesサイトはGitHub Pagesサイトが別のCIツールを使うように設定しないかぎり、GitHub Actionsワークフローの実行でビルドされ、デプロイされます。ビルドの潜在的なエラーを見つけるには、リポジトリのワークフロー実行をレビューすることによって、GitHub Pagesサイトのためのワークフローの実行をチェックできます。詳しくは、「ワークフロー実行の履歴を表示する」をご覧ください。エラーが発生した場合にワークフローを再実行する方法の詳細については、「ワークフローとジョブの再実行」を参照してください。

ローカルでのJekyllビルドエラーメッセージの表示

サイトのテストはローカルで行なうことをお勧めします。そうすることで、ビルドエラーメッセージをコマンドラインに表示し、ビルドエラーがあった場合は解決してから、変更を GitHub にプッシュできます。詳しくは、「Jekyll を使用して GitHub Pages サイトをローカルでテストする」をご覧ください。

Pull Request中でのJekyllのビルドエラーメッセージの表示

ブランチから公開している場合、GitHub の公開ソースを更新するために pull request を作成すると、その pull request の [Checks] タブにビルドエラーメッセージが表示されます。詳しくは、「ステータスチェックについて」をご覧ください。

カスタムの GitHub Actions ワークフローを使用して公開している場合、pull request でのビルドエラーメッセージを確認するには、pull_request トリガーに対してそのワークフローが実行されるように構成する必要があります。これを行う際は、ワークフローが pull_request イベントによってトリガーされた場合に、展開手順をスキップすることをお勧めします。これにより、pull request からの変更をサイトにデプロイすることなく、ビルドエラーを確認することができます。詳細については、「ワークフローをトリガーするイベント」および「ワークフローとアクションで式を評価する」を参照してください。

メールでのJekyllのビルドエラーメッセージの表示

ブランチから公開している場合は、GitHub 上の公開元に変更をプッシュしたときに、GitHub Pages によって、サイトのビルドが試行されます。ビルドが失敗すると、プライマリメールアドレスにメールが送信されます。

カスタムの GitHub Actions ワークフローを使用して公開している場合、pull request でのビルドエラーに関する Email を受信するには、pull_request トリガーに対してそのワークフローが実行されるように構成する必要があります。これを行う際は、ワークフローが pull_request イベントによってトリガーされた場合に、展開手順をスキップすることをお勧めします。これにより、pull request からの変更をサイトにデプロイすることなく、ビルドエラーを確認することができます。詳細については、「ワークフローをトリガーするイベント」および「ワークフローとアクションで式を評価する」を参照してください。

サードパーティCIサービスでのPull Request中でのJekyllのビルドエラーメッセージの表示

各コミット後にエラーメッセージを表示するように、Travis CI などのサードパーティのサービスを構成できます。

公開ソースのルートに、以下の内容で Gemfile と呼ばれるファイルをまだ追加していない場合は、追加します。
```
source `https://rubygems.org`
gem `github-pages`
```
選択したテストサービス用にサイトのリポジトリを設定します。たとえば、Travis CI を使用するには、公開ソースのルートに .travis.yml という名前のファイルを追加し、次の内容を含めます。
```
language: ruby
rvm:
  - 2.3
script: "bundle exec jekyll build"
```
サードパーティのテストサービス内で、リポジトリを有効にする必要があるかもしれません。詳しい情報については、お使いのテストサービスのドキュメンテーションを参照してください。