GitHub Pages サイトのカスタム 404 ページを作成する

サイト上の存在しないページにアクセスしようとした際に表示される、404 エラーページをカスタマイズできます。

この機能を使用できるユーザーについて

GitHub Pagesは、パブリック・リポジトリのGitHub Freeと組織用のGitHub Free、パブリック・リポジトリとプライベート・リポジトリのGitHub Pro、GitHub Team、GitHub Enterprise Cloud、GitHub Enterprise Serverで利用できます。

  1. GitHub Enterprise Serverで、サイトのリポジトリにアクセスしてください。

  2. サイトの公開ソースにアクセスしてください。 詳しくは、「GitHub Pages サイトの公開元を設定する」を参照してください。

  3. ファイル リストの上にある [Add file ] ドロップダウン メニューを選んで、[ Create new file] をクリックします。

    または、左側のファイル ツリー ビューの をクリックしてもかまいません。

    リポジトリのメイン ページのスクリーンショット。 ファイルの一覧の上には、[ファイルの追加] というラベルが付いたボタンが濃いオレンジ色の枠線で囲まれています。 リポジトリのファイル ツリー ビューでは、+ アイコンが付いたボタンも濃いオレンジ色で囲まれています。

  4. ファイル名フィールドに、404.html または 404.md と入力します。

  5. ファイルに 404.md という名前を付けた場合は、ファイルの先頭に次の YAML フロント マターを追加します。

    ---
permalink: /404.html
---

  6. YAML front matter の下に、404 ページに表示したいコンテンツがある場合には、それを追加します。

  7. [変更のコミット...] をクリックします。

  8. [コミット メッセージ] フィールドに、ファイルに対する変更内容を説明する、短くわかりやすいコミット メッセージを入力します。 コミットメッセージでは、複数の作者にコミットを関連づけることができます。 詳しくは、「複数の作者を持つコミットを作成する」を参照してください。

  9. コミットメッセージフィールドの下で、コミットの追加先を現在のブランチか新しいブランチから選択してください。 現在のブランチがデフォルトブランチなら、コミット用に新しいブランチを作成してからPull Requestを作成すべきです。 詳しくは、「pull request の作成」を参照してください。

    GitHub pull request のスクリーンショット。メイン ブランチに直接コミットする、または新しいブランチを作成するためのラジオ ボタンが表示されています。 新しいブランチが選ばれています。

  10. [変更のコミット] または [変更の提案] をクリックします。

参考資料