ページビルド失敗: Config ファイルエラー
GitHub Pages リポジトリの *_config.yml ファイル に構文エラーがある場合、GitHub Pages サイトはビルドされません。
_config.yml ファイルに構文エラーがあるために GitHub Pages サイトのビルドに失敗した場合は、次のようなメールが届きます:
件名: Page build failed
The page build failed with the following error:
You have an error on line 1 of your
_config.yml
file.
メール通知を受け取ることができるのは、Enterprise インスタンスでアウトバウンドメールサポートが有効になっている場合のみです。詳しい情報については、サイトの管理者に連絡を取ってください。
_config.yml 構文エラーのトラブルシューティング
参考: 使用している GitHub Enterprise Serverインスタンス へプッシュする前にデバッグとビルドエラーの修正を簡単に行えるよう、Jekyll をローカルで実行 することを強くおすすめします。トラブルシューティングの選択肢についてさらに学ぶには、「GitHub Pages のビルドのトラブルシューティング」を参照してください。
_config.yml ファイルで、ビルド失敗の通知メールで参照されている行を確認します。 以下の点を確認してください:
-
ファイルでタブではなくスペースを使用していること。
-
キー/値ペアごとに ":" の後ろにスペースを追加していること。
正しい例:
timezone: Africa/Nairobi
ビルド失敗の例:
timezone:Africa/Nairobi
。 -
UTF-8 文字のみを使用していること。
-
特殊文字は引用符で囲んでいること。
正しい例:
title: "my awesome site: an adventure in parse errors"
ビルド失敗の例:
title: my awesome site: an adventure in parse errors
YAML 文法チェッカー、http://codebeautify.org/yaml-validator などを使用して YAML コードを検証します。 _config.yml ファイルでパースエラーが発生した場合は、ファイルの内容をコピーして、このようなツールに貼り付け、詳細を確認します。
_config.yml ファイルで構文エラーを修正したら、変更をコミットして GitHub Pages リポジトリに再プッシュし、サーバーで次のビルドをトリガーする必要があります。
ハイライトエラーの修正
Jekyll による GitHub Pages サイトで Rouge 以外の構文ハイライト機能を使おうとすると、ページビルドの警告が出ます。 GitHub Pages は他のハイライト機能をサポートしていないため、自動的にデフォルトの Rouge が使用されます。 詳細は「GitHub Pages で構文ハイライトを使う」を参照してください。
ページビルドの警告を解決するには、_config.yml ファイルでハイライト機能の値を rouge
に変更します。
-
GitHub Enterprise で、リポジトリのメインページへ移動します。
-
リポジトリ中の _config.yml にアクセスしてください。
-
ファイルビューの右上の隅で、 をクリックしてファイルエディタを開きます。
-
highlighter:
で始まる行を探し、値をrouge
に変更します。 -
ページの下部で、ファイルに行った変更について述べた短く意味のあるコミットメッセージを入力してください。コミットメッセージ内でコミットを複数の作者に関連付けることができます。詳細は「複数の共同作者を持つコミットを作成する」を参照してください。
-
コミットメッセージフィールドの下で、コミットを現在のブランチに追加するか、新しいブランチを作成するかを判断してください。現在のブランチが
master
なら、コミットに新しいブランチを作成することにして、プルリクエストを作成してください。 -
[Propose file change] をクリックします。