ドキュメントには頻繁に更新が加えられ、その都度公開されています。本ページの翻訳はまだ未完成な部分があることをご了承ください。最新の情報については、英語のドキュメンテーションをご参照ください。本ページの翻訳に問題がある場合はこちらまでご連絡ください。
記事のバージョン: GitHub.com

ページビルド失敗: 不明タグエラー

GitHub Pages コードに、認識されない Liquid タグが含まれている場合、GitHub Pages サイトはビルドされません。

認識されない Liquid タグがあるために GitHub Pages サイトのビルドに失敗した場合は、次のようなメールが届きます:

件名: Page build failed

The page build failed with the following error:

The tag fake_tag in index.html is not a recognized Liquid tag.

認識されないタグエラーのトラブルシューティング

参考: GitHub へプッシュする前にデバッグとビルドエラーの修正を簡単に行えるよう、Jekyll をローカルで実行 することを強くおすすめします。トラブルシューティングの選択肢についてさらに学ぶには、「GitHub Pages のビルドのトラブルシューティング」を参照してください。

プラグイン出力で、認識されないタグをチェックします。

プラグインは、認識されないタグでよくある原因です。 GitHub ではほとんどのプラグインがサポートされていないため、ローカルでビルドしてその結果を Pages リポジトリに含めるのが一般的な回避方法です。 ただし、この回避方法では Jekyll のデフォルトの変数にないタグを使う場合があり、これはビルドでパースできません。 サポートされているプラグインのリストについては、「GitHub Pages サイトに Jekyll プラグインを追加する」を参照してください。

タグエラーを修正したら、変更をコミットして GitHub Pages リポジトリに再プッシュし、サーバーで次のビルドをトリガーする必要があります。

担当者にお尋ねください

探しているものが見つからなかったでしょうか?

弊社にお問い合わせください