Jekyll ビルドエラーメッセージを表示する
Jekyll ビルドのエラーメッセージは、電子メール、リポジトリ、コマンドライン、またはコミットごとにエラーメッセージを表示するサードパーティのサービスで確認できます。
Jekyll ビルドエラーメッセージには主に 2 つのタイプがあります。
「Page build warning」 - ビルドは問題なく完了しましたが、知っておくべきことがあります。
「Page build failed」 - ビルドは完了できませんでした。 特定のエラーを検出できた場合は、サポートドキュメントへのリンクを含むエラーメッセージが表示されます。 ページビルド失敗で特定のエラーを検出することができないならば、一般的な「page build failed」エラーメッセージが送信されます。
メールで Jekyll ビルドエラーメッセージを表示する
メールを設定していれば、すべての Jekyll ビルドエラーメッセージをメールで表示できます。 新しいメールアドレスを追加するか、古いメールアドレスを検証するには、「プライマリメールアドレスを変更する」を参照してください。
リポジトリ内の Jekyll ビルド失敗メッセージを表示する
GitHub Pages サイトのレポジトリ設定で Jekyll ビルド失敗メッセージを表示することができます。
-
GitHub Enterprise で、リポジトリのメインページへ移動します。
-
リポジトリ名の下で [Settings] をクリックします。
-
使用している GitHub Enterprise Serverインスタンス ページの下で、現在の Jekyll ビルド失敗メッセージを表示することができます。
メモ: ページビルド警告は、リポジトリ設定には表示されません。
コマンドラインで Jekyll ビルドエラーメッセージを表示する
参考: 使用している GitHub Enterprise Serverインスタンス へプッシュする前にデバッグとビルドエラーの修正を簡単に行えるよう、Jekyll をローカルで実行 することを強くおすすめします。トラブルシューティングの選択肢についてさらに学ぶには、「GitHub Pages のビルドのトラブルシューティング」を参照してください。
すべての Jekyll ビルドエラーメッセージをコマンドラインで表示するには、Jekyll サイトをコンピュータ上でローカルに設定する必要があります。詳細は「Jekyll を使用して GitHub Enterprise Pages サイトをローカルでセットアップする」を参照してください。 使用している GitHub Enterprise Serverインスタンス にプッシュしてもページが構築されない場合は、「GitHub Pages ビルドのトラブルシューティング」を参照してください。
Jekyll ビルドエラーメッセージを表示するようサードパーティサービスを設定する
各コミット後にエラーメッセージを表示するように、Travis CI などのサードパーティサービスを設定できます。
- 次の内容で Gemfile という名前のファイル (「G」は大文字にする必要があります) を GitHub Pages リポジトリのルートに追加します。
source 'https://rubygems.org'
gem 'github-pages'
- 選択したテストサービス用に GitHub Pages リポジトリを設定します。 例えば Travis CI を設定するには、次の内容で .travis.yml という名前のファイルを GitHub Pages リポジトリのルートに追加します。
language: ruby
rvm:
- 2.1
script: "bundle exec jekyll build"
- サードパーティのテストサービス内で、GitHub Pages リポジトリを有効にする必要があるかもしれません。 Travis の場合は、Travis C のプロフィールページでこれを行います。
ベンダーが Gem を vendor フォルダに入れた場合 (または Travis のような CI サービスが行った場合) は、潜在的な競合を回避するため、必ず、exclude: ["vendor"]
を _config.yml ファイルに追加してください。