Skip to main content
Nous publions des mises à jour fréquentes de notre documentation, et la traduction de cette page peut encore être en cours. Pour obtenir les informations les plus actuelles, consultez la documentation anglaise.
GitHub AE est actuellement en version limitée.
All products
GitHub Pages

Hover over a link to another article to get more details. If you have ideas for how we can improve this page, let us know in the discussion.

Création d’un site GitHub Pages

Dans cet article

Vous pouvez créer un site GitHub Pages dans un dépôt nouveau ou existant.

GitHub Pages est disponible dans les dépôts internes et privés avec GitHub AE. GitHub Pages est disponible dans les dépôts publics avec GitHub Free et GitHub Free pour les organisations, et dans les dépôts publics et privés avec GitHub Pro, GitHub Team, GitHub Enterprise Cloud et GitHub Enterprise Server.

Création d’un dépôt pour votre site

Vous pouvez créer un dépôt ou choisir un dépôt existant pour votre site.

Si vous souhaitez créer un site GitHub Pages pour un dépôt où les fichiers du dépôt ne sont tous pas liés au site, vous pouvez configurer une source de publication pour votre site. Par exemple, vous pouvez avoir une branche et un dossier dédiés pour conserver les fichiers sources de votre site.

Si vous souhaitez créer un site dans un dépôt existant, passez à la section « Création de votre site ».

  1. En haut à droite d’une page, utilisez le menu déroulant et sélectionnez Nouveau dépôt. Menu déroulant avec l’option pour créer un dépôt 1. Utilisez le menu déroulant Propriétaire, puis sélectionnez le compte qui doit posséder le dépôt. Menu déroulant Propriétaire 1. Tapez un nom pour votre référentiel et une description facultative. Si vous créez un utilisateur ou un site d’organisation, votre référentiel doit être nommé <user>.github.io ou <organization>.github.io. Si votre nom d’utilisateur ou d’organisation contient des lettres majuscules, vous devez mettre les lettres en minuscules. Pour plus d’informations, consultez « À propos de GitHub Pages ». Champ de création de dépôt 1. Choisissez une visibilité de dépôt. Pour plus d’informations, consultez « À propos des dépôts ». Cases d’option pour sélectionner la visibilité des dépôts 1. Sélectionnez Initialize this repository with a README (Initialiser ce dépôt à l’aide d’un fichier LISEZMOI). Case à cocher Initialiser ce référentiel à l’aide d’un fichier LISEZMOI 1. Cliquez sur Créer le dépôt. Bouton pour créer un dépôt

Création de votre site

Pour pouvoir créer votre site, vous devez avoir un dépôt pour votre site sur GitHub AE. Si vous ne créez pas votre site dans un dépôt existant, consultez « Création d’un dépôt pour votre site ».

Avertissement : les sites GitHub Pages sont visibles par tous les membres de l’entreprise, même si le dépôt du site est privé. Si vous avez des données sensibles dans le dépôt de votre site, vous pouvez les supprimer avant publication. Pour plus d’informations, consultez « À propos des dépôts ».

  1. Dans GitHub AE, accédez au dépôt de votre site. 1. Déterminez la source de publication que vous souhaitez utiliser. Pour plus d’informations, consultez « Configuration d’une source de publication pour votre site GitHub Pages ».

  2. Créez le fichier d’entrée pour votre site. GitHub Pages recherche un fichier index.html, index.md ou README.md comme fichier d’entrée pour votre site.

    Le fichier d’entrée doit être au niveau supérieur de la source de publication que vous avez choisie. Par exemple, si votre source de publication est le dossier /docs de la branche main, votre fichier d’entrée doit se trouver dans le dossier /docs sur une branche appelée main. 1. Configurez votre source de publication. Pour plus d’informations, consultez « Configuration d’une source de publication pour votre site GitHub Pages ». 1. Sous le nom de votre dépôt, cliquez sur Paramètres. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant et cliquez sur Paramètres.

    Capture d’écran d’un en-tête de dépôt montrant les onglets. L’onglet « Paramètres » est mis en évidence avec un encadré orange foncé.

  3. Dans la section « Code et automatisation » de la barre latérale, cliquez sur Pages.

  4. Pour voir votre site publié, sous « GitHub Pages », cliquez sur Visiter le site. Capture d’écran du bouton « Visiter le site » en regard de l’URL d’un site publié

    Remarque : La publication des changements de votre site peut prendre jusqu’à 10 minutes après les avoir poussés vers GitHub AE. Si vous ne voyez pas vos modifications du site GitHub Pages reflétées dans votre navigateur après une heure, consultez « À propos des erreurs de build Jekyll pour les sites GitHub Pages ».

Remarque : Si votre site n’a pas été publié automatiquement, assurez-vous qu’une personne avec des autorisations d’administrateur et une adresse e-mail vérifiée a effectué une poussée vers la source de publication.

Étapes suivantes

Vous pouvez ajouter d’autres pages à votre site en créant davantage de fichiers. Chaque fichier sera disponible sur votre site dans la même structure de répertoire que celle de votre source de publication. Par exemple, si la source de publication de votre site de projet est la branche gh-pages et que vous créez un fichier appelé /about/contact-us.md sur la branche gh-pages, le fichier sera disponible dans http(s)://<hostname>/pages/<username>/<repository>/about/contact-us.html.

Vous pouvez également ajouter un thème pour personnaliser l’apparence de votre site. Pour plus d’informations, consultez « Ajout d’un thème à votre site GitHub Pages avec Jekyll ».

Pour personnaliser davantage votre site, vous pouvez utiliser Jekyll, un générateur de site statique avec prise en charge intégrée de GitHub Pages. Pour plus d’informations, consultez « À propos de GitHub Pages et Jekyll ».

Pour aller plus loin