Création d’une page 404 personnalisée pour votre site GitHub Pages

Vous pouvez afficher une page d’erreur 404 personnalisée quand les utilisateurs essaient d’accéder à des pages inexistantes sur votre site.

Qui peut utiliser cette fonctionnalité ?

GitHub Pages est disponible dans les référentiels publics avec GitHub Free et GitHub Free pour les organisations, et dans les référentiels publics et privés avec GitHub Pro, GitHub Team, GitHub Enterprise Cloud et GitHub Enterprise Server.

  1. Dans GitHub, accédez au dépôt de votre site.

  2. Accédez à la source de publication pour votre site. Pour plus d’informations, consultez « Configuration d’une source de publication pour votre site GitHub Pages ».

  3. Au-dessus de la liste des fichiers, sélectionnez le menu déroulant Ajouter un fichier , puis cliquez sur Créer un nouveau fichier.

    Vous pouvez également cliquer sur dans l’arborescence de fichiers à gauche.

    Capture d’écran de la page principale d’un référentiel mettant en évidence l’icône « Ajouter un fichier » et l’icône « signe plus », décrites ci-dessus, avec un contour orange.

  4. Dans le champ Nom de fichier, tapez 404.html ou 404.md.

  5. Si vous avez nommé votre fichier 404.md, ajoutez la section YAML Front Matter suivante au début du fichier :

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

  6. Sous la section YAML Front Matter, si elle est présente, ajoutez le contenu que vous voulez afficher sur votre page 404.

  7. Cliquez sur Commiter les changements.

  8. Dans le champ de message de validation, tapez un message de validation court et descriptif qui indique la modification que vous avez apportée au fichier. Vous pouvez attribuer la validation à plusieurs auteurs dans le message de validation. Pour plus d’informations, consultez « Créer un commit avec plusieurs auteurs ou au nom d’une organisation ».

  9. Sous les champs de message de commit, choisissez si vous souhaitez ajouter votre commit à la branche actuelle ou à une nouvelle branche. Si votre branche actuelle est la branche par défaut, vous devez choisir de créer une nouvelle branche pour y effectuer votre commit, puis créer une pull request. Pour plus d’informations, consultez « Création d’une pull request ».

    Capture d’écran d’une pull request GitHub montrant un bouton radio permettant soit de valider directement sur la branche main, soit de créer une nouvelle branche. Une nouvelle branche est sélectionnée.

  10. Cliquez sur Valider les modifications ou Proposer des modifications.

Pour aller plus loin