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

ページビルド失敗: 相対パーマリンクが設定されている

_config.yml ファイルで相対パーマリンクを設定している場合は、ページビルドが失敗し、_config.yml ファイルから relative_permalink オプションを削除してサイトの相対パーマリンクを絶対パーマリンクに置き換えるようアドバイスされます。

GitHub Pages サイトの _config.yml ファイルで相対パーマリンクを設定している場合は、次のようなメールが届きます:

件名: Page build failed

The page build failed with the following error:

Your site is using the relative_permalinks configuration option. This

setting is deprecated as has been removed from the latest version of

Jekyll. To ensure your site continues to build as expected, remove the

option from your site's configuration and update any post or page

permalinks to be absolute to the site root, not the parent folder.

パーマリンクとは、GitHub Pages サイトの特定の投稿またはページを参照している恒久的な URL です。

詳しい情報については、Jekyll の公式ドキュメントでパーマリンクに関する記事を参照してください。

GitHub Pages と Jekyll では、相対パーマリンクがサポートされなくなっています。 GitHub Pages サイトの _config.yml ファイルから relative_permalinks 設定オプションを削除し、サイトの相対パーマリンクを絶対パーマリンクに変更します。

  1. GitHub で、リポジトリのメインページへ移動します。

  2. リポジトリ中の _config.yml にアクセスしてください。

  3. ファイルビューの右上の隅で、 をクリックしてファイルエディタを開きます。

    エディットアイコンでファイルエディタをオープン

  4. relative_permalinks: で始まる行を探し、行全体を削除します。

    config.yml の relative-permalinks-value

  5. ページの下部で、ファイルに行った変更について述べた短く意味のあるコミットメッセージを入力してください。コミットメッセージ内でコミットを複数の作者に関連付けることができます。詳細は「複数の共同作者を持つコミットを作成する」を参照してください。

    変更のコミットメッセージ

  6. コミットメッセージフィールドの下で、コミットを現在のブランチに追加するか、新しいブランチを作成するかを判断してください。現在のブランチが master なら、コミットに新しいブランチを作成することにして、プルリクエストを作成してください。

    Commit branch options

  7. [Propose file change] をクリックします。

    ファイルの変更を提案 ボタン

  1. サイトの投稿またはページで相対パーマリンクを検索します。
  2. 相対パーマリンクがあれば、絶対パーマリンクに置き換えます。

担当者にお尋ねください

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

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