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. Consultez « plans de GitHub ».

  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. Si vous avez plusieurs adresses e-mail associées à votre compte GitHub, cliquez sur le menu déroulant de l’adresse e-mail et sélectionnez l’adresse e-mail à utiliser comme adresse e-mail de l’auteur Git. Seules les adresses e-mail vérifiées apparaissent dans ce menu déroulant. Si vous avez activé la confidentialité de l’adresse e-mail, le mode sans réponse sera utilisé par défaut pour l’adresse e-mail de l’auteur de commit. Pour plus d’informations sur la forme exacte que l’adresse e-mail sans réponse peut prendre, consultez Définition de votre adresse e-mail de commit.

Capture d’écran d’une pull request GitHub affichant un menu déroulant avec des options permettant de choisir l’adresse e-mail de l’auteur du commit. octocat@github.com est sélectionné.

  1. 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.

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

Pour aller plus loin