GitHub AE est actuellement en version limitée.

Configuration d’une source de publication pour votre site GitHub Pages

Dans cet article

Si vous utilisez la source de publication par défaut pour votre site GitHub Pages, celui-ci est publié automatiquement. Vous pouvez également choisir de publier votre site à partir d’une autre branche ou d’un autre dossier.

Qui peut utiliser cette fonctionnalité

People with admin or maintainer permissions for a repository can configure a publishing source for a GitHub Pages site.

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.

À propos des sources de publication

Votre site GitHub Pages est publié lorsque des modifications sont poussées vers une branche spécifique. Vous pouvez spécifier la branche et le dossier à utiliser comme source de publication. La branche source peut être n’importe quelle branche de votre dépôt, et le dossier source peut être la racine du dépôt (/) sur la branche source ou un dossier /docs de la branche source. Chaque fois que des modifications sont poussées vers la branche source, les modifications du dossier source sont publiées sur votre site GitHub Pages.

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

Publication à partir d’une branche

  1. Assurez-vous que la branche que vous souhaitez utiliser comme source de publication existe déjà dans votre dépôt.

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

  3. 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 , puis 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é.

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

  5. Sous « GitHub Pages », utilisez le menu déroulant Branche, puis sélectionnez une source de publication. Capture d’écran des paramètres Pages dans un dépôt GitHub. Un menu permettant de sélectionner une branche pour une source de publication, intitulé « Aucun », est indiqué en orange foncé.

  6. Si vous le souhaitez, utilisez le menu déroulant de dossiers afin de sélectionner un dossier pour votre source de publication. Capture d’écran des paramètres Pages dans un dépôt GitHub. Un menu permettant de sélectionner un dossier pour une source de publication, intitulé « /(root) », est présenté en orange foncé.

  7. Cliquez sur Enregistrer.

Résolution des problèmes de publication à partir d’une branche

Remarques:

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

  • Les commits envoyés par un workflow GitHub Actions qui utilise le GITHUB_TOKEN ne déclenchent pas de build GitHub Pages.

Si vous choisissez le dossier docs sur n’importe quelle branche comme source de publication, supprimez ultérieurement le dossier /docs de cette branche dans votre référentiel, votre site ne sera pas généré et vous recevrez un message d’erreur de génération de page en raison d’un dossier /docs manquant. Pour plus d’informations, consultez « Résolution des erreurs de build Jekyll pour les sites GitHub Pages ».