ページビルド失敗: データファイルの YAML が無効
GitHub Enterprise Pages サイトの _data
フォルダにあるファイルに無効な YAML が含まれている場合、GitHub Enterprise Pages サイトはビルドされません。
YAML パースエラーのために GitHub Enterprise Pages サイトのビルドに失敗した場合は、次のようなメールが届きます:
件名: Page build failed
The page build failed with the following error:
There was a YAML syntax error on line
line_number
columncolumn_number
infilename
:syntax_error
.
メール通知を受け取ることができるのは、Enterprise インスタンスでアウトバウンドメールサポートが有効になっている場合のみです。詳しい情報については、サイトの管理者に連絡を取ってください。
YAML パースエラーのトラブルシューティング
参考: 使用している GitHub Enterprise Serverインスタンス へプッシュする前にデバッグとビルドエラーの修正を簡単に行えるよう、Jekyll をローカルで実行 することを強くおすすめします。トラブルシューティングの選択肢についてさらに学ぶには、「GitHub Pages のビルドのトラブルシューティング」を参照してください。
_data
フォルダの YAML ファイルで、次の点を確認します:
-
YAML ファイルでインデントを確認し、タブ文字があったら削除します。YAML ファイルの推奨スペーシングに適合しない場合があるからです。
-
キーと値とその前のコロンの間にスペースがあることを確認します。
正しい例:
key: value
ビルド失敗の例:
key:value
-
エントリで複数行の値がないか確認します。
|
を追加すると、値の各行に改行が挿入され、>
を追加すると改行が無視されてすべて内容が 1 行のままになります。 -
適切な引用符を使用していることを確認します。 URL のほか、コロンに続く YAML 特殊文字で始まる、または特殊文字を含む変数や文字列も、引用符で囲む必要があります。
参考: YAML エラーの診断と修正には、YAML Lint などのファイルを使用できます。
YAML エラーをすべて修正したら、変更をコミットして GitHub Pages リポジトリに再プッシュし、サーバーで次のビルドをトリガーする必要があります。
Jekyll データファイルの詳しい情報については、Jekyll ドキュメンテーションを参照してください。