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

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 です。

• 絶対パーマリンクは、サイトのルートから始まる URL です。
• 相対パーマリンクは、サイトのルートではなく親フォルダ (参照先のウェブページを含んでいるフォルダ) から始まるよう修飾された URL です。

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

相対パーマリンクエラーのトラブルシューティング

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

relative_permalinks: を config.yml から削除する

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

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

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

   

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

   

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

   

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

   

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

   

相対パーマリンクを絶対パーマリンクに置き換える

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