GitHub Pages ビルドのトラブルシューティング
GitHub Pages は、GitHub Free のパブリックリポジトリ、GitHub Pro のパブリックおよびプライベートリポジトリ、GitHub Team、GitHub Enterprise Cloud、GitHub Enterprise Server で利用いただけます。
弊社のサーバーで GitHub Pages のサイトのビルドに失敗した場合または他のエラーが起きた場合、よくある問題に照らし合わせて、または特定のエラーメッセージを確認して、トラブルシューティングしてください。 メール、リポジトリ、コマンドラインまたは第三者のサービスを使って、Jekyll ビルドのエラーメッセージを確認できます。
Jekyll ビルドエラーメッセージを表示する
Jekyll ビルドのエラーメッセージは、電子メール、リポジトリ、コマンドライン、またはコミットごとにエラーメッセージを表示するサードパーティのサービスで確認できます。
一般的な Jekyll のビルドの失敗
一般的なビルドの失敗によって、特定のファイルとエラー情報が記載されたメールが送信されることはありません。 「Page build failed」とだけ記載されたメールを受信した場合や、GitHub Pages のサイトが最初のプッシュ後に表示されない場合は、こちらの一般的なエラーをご確認ください。
"ページビルド失敗: docs フォルダがない"
master ブランチ/docs フォルダ ソース設定を有効にしていて、サイトのソースファイルの /docs
フォルダを、master
ブランチでリポジトリのルートから削除した場合、GitHub Pages サイトはビルドされません。
"ページビルド失敗: サブモジュールが無効"
GitHub Pages コードに無効なサブモジュールに対する参照が含まれている場合、GitHub Pages サイトはビルドされません。
"ページビルド失敗: サブモジュールがない"
GitHub Pages コードに、存在しない、または適切に初期化されていないサブモジュールへの参照が含まれている場合、GitHub Pages サイトはビルドされません。
"ページビルド失敗: Markdown エラー"
GitHub Pages コードに Markdown エラーが含まれている場合、GitHub Pages サイトはビルドされません。
"ページビルド失敗: Config ファイルエラー"
GitHub Pages リポジトリの *_config.yml ファイル に構文エラーがある場合、GitHub Pages サイトはビルドされません。
"ページビルド失敗: 不明タグエラー"
GitHub Pages コードに、認識されない Liquid タグが含まれている場合、GitHub Pages サイトはビルドされません。
"ページビルド失敗: タグが正しく終了していない"
GitHub Pages リポジトリに、Liquid で正しく終了していない出力タグがある場合、GitHub Pages サイトはビルドされません。
"ページビルド失敗: タグが正しく閉じていない"
GitHub Pages リポジトリに、Liquid で正しく閉じていない論理タグがある場合、GitHub Pages サイトはビルドされません。
"ページビルド失敗: includes ディレクトリにファイルが存在しない"
GitHub Pages のコードが _includes ディレクトリに存在しないファイルを参照している場合、GitHub Pages サイトはビルドされません。
"ページビルド失敗: ファイルがシンボリックリンク"
GitHub Pages リポジトリのファイルが、リポジトリに存在しない、シンボリックリンクされたファイルを参照している場合、GitHub Pages サイトはビルドされません。
"ページビルド失敗: サイトのリポジトリにシンボリックリンクが存在しない"
GitHub Pages サイトに、サイトのリポジトリに存在する他のファイルまたはディレクトリへのシンボリックリンク が含まれる場合、サイトはビルドされません。
"ページビルド失敗: ファイルが UTF-8 で正しくエンコードされていない"
GitHub Pages リポジトリに、UTF-8 で正しくエンコードされていないファイルがある場合、GitHub Pages サイトはビルドされません。
"ページビルド失敗: 投稿日付が無効"
GitHub Pages リポジトリに、無効な日付の投稿がある場合、GitHub Pages サイトはビルドされません。
"ページビルド失敗: Sass または SCSS が無効"
GitHub Pages リポジトリに、無効な内容の Sass または SCSS ファイルが含まれている場合、GitHub Pages サイトはビルドされません。
"ページビルド失敗: 無効なハイライト言語"
GitHub Pages のコードが無効な言語 ID で highlighter
タグを使用している場合、GitHub Pages サイトはビルドされません。
Markdown プロセッサを kramdown にアップデートする
まだ Jekyll 3.0.0 のデフォルトの Markdown プロセッサである kramdown を使っていない場合、_config.yml ファイルを使用して Markdown プロセッサを更新する必要があります。
"ページビルド失敗: 相対パーマリンクが設定されている"
_config.yml ファイルで相対パーマリンクを設定している場合は、ページビルドが失敗し、_config.yml ファイルから relative_permalink
オプションを削除してサイトの相対パーマリンクを絶対パーマリンクに置き換えるようアドバイスされます。
"ページビルド失敗: 'for' ループの構文エラー"
GitHub Pages コードで Liquid の for
ループ宣言に無効な構文が含まれている場合、GitHub Pages サイトはビルドされません。
アンダースコアで始まるファイルが見つからない
GitHub Pages のサイトで特定のファイルが公開されない場合は、タイトルの再フォーマットが必要となる場合があります。 Jekyll をお使いの場合は、 .nojekyll ファイルを作成したり、_config.yml ファイルを編集して、これらのファイルを公開できます。
"ページビルド失敗: データファイルの YAML が無効"
GitHub Enterprise Pages サイトの _data
フォルダにあるファイルに無効な YAML が含まれている場合、GitHub Enterprise Pages サイトはビルドされません。
"ページビルド失敗: 日付が有効な日時ではない"
GitHub Pages リポジトリに、無効な日時が表示されるページがある場合、GitHub Pages サイトはビルドされません。