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.

À propos de GitHub Pages

Vous pouvez utiliser GitHub Pages pour héberger un site web sur vous-même, votre organisation ou votre projet directement à partir d’un dépôt sur GitHub AE.

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 de GitHub Pages

GitHub Pages est un service d’hébergement de site statique qui prélève des fichiers HTML, CSS et JavaScript directement dans un dépôt sur GitHub AE, les exécute éventuellement dans un processus de génération, puis publie un site web. Vous pouvez voir des exemples de sites GitHub Pages dans la collection d’exemples GitHub Pages.

Pour commencer, consultez « Création d’un site GitHub Pages ».

Types de sites GitHub Pages

Il existe trois types de sites GitHub Pages : projet, utilisateur et organisation. Les sites de projet sont connectés à un projet spécifique hébergé sur GitHub AE, comme une bibliothèque JavaScript ou une collection de recettes. Les sites d’utilisateur et d’organisation sont connectés à un compte spécifique sur GitHub AE.

Pour publier un site d’utilisateur, vous devez créer un dépôt appartenant à votre compte personnel, nommé <username>.<hostname>. Pour publier un site d’organisation, vous devez créer un dépôt appartenant à une organisation, nommé <organization>.<hostname>. Les sites d’utilisateur et d’organisation sont disponibles à l’emplacement http(s)://pages.<hostname>/<username> ou http(s)://pages.<hostname>/<organization>.

Les fichiers sources d’un site de projet sont stockés dans le même dépôt que leur projet. Des sites de projet sont disponibles à l’emplacement http(s)://pages.<hostname>/<username>/<repository>/ ou http(s)://pages.<hostname>/<organization>/<repository>/.

Vous ne pouvez créer qu’un seul utilisateur ou site d’organisation pour chaque compte sur GitHub AE. Les sites de projet, qu’ils appartiennent à un compte d’organisation ou personnel, sont illimités.

Publication de sources pour les sites 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 ».

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.

Pour plus d’informations, consultez « Configuration d’une source de publication pour votre site GitHub Pages ».

Générateurs de sites statiques

GitHub Pages publie tous les fichiers statiques que vous envoyez (push) à votre dépôt. Vous pouvez créer vos propres fichiers statiques ou utiliser un générateur de site statique pour générer votre site à votre place. Vous pouvez également personnaliser votre propre processus de génération localement ou sur un autre serveur.

Nous recommandons Jekyll comme générateur de site statique avec une prise en charge intégrée des GitHub Pages et un processus de génération simplifié. Pour plus d’informations, consultez « À propos de GitHub Pages et Jekyll ».

GitHub Pages utilise Jekyll pour générer votre site par défaut. Si vous souhaitez utiliser un générateur de site statique autre que Jekyll, désactivez le processus de génération Jekyll en créant un fichier vide appelé .nojekyll à la racine de votre source de publication, puis suivez les instructions de votre générateur de site statique pour générer votre site localement.

GitHub Pages ne prend pas en charge les langages côté serveur tels que PHP, Ruby ou Python.

Limites relatives à l’utilisation de GitHub Pages

GitHub Pages n’est ni destiné, ni autorisé à être utilisé comme service d’hébergement web gratuit pour exécuter votre entreprise en ligne, votre site de commerce électronique ou tout autre site web visant principalement à faciliter des transactions commerciales ou à fournir un SaaS commercial. Les sites GitHub Pages ne devraient pas être utilisés pour des transactions sensibles telles que l’envoi de mots de passe ou de numéros de carte de crédit.

En outre, votre utilisation de GitHub Pages est régie par les conditions d’utilisation de GitHub, y compris les restrictions concernant les systèmes d’enrichissement rapide, les contenus sexuellement obscènes et les contenus ou activités violents ou menaçants.

Limites d’utilisation

Les sites GitHub Pages sont soumises aux limites d’utilisation suivantes :

  • Les dépôts sources GitHub Pages ont une limite recommandée de 1 Go.
  • Les sites publiés GitHub Pages ne peuvent ne pas avoir une taille supérieure à 1 Go.

Types MIM sur GitHub Pages

Un type MIME est un en-tête qu’un serveur envoie à un navigateur, fournissant des informations sur la nature et le format des fichiers que le navigateur a demandés. GitHub Pages prend en charge plus de 750 types MIME dans des milliers d’extensions de fichier. La liste des types MIME pris en charge est générée à partir du projet mime-db.

Bien que vous ne puissiez pas spécifier de types MIME personnalisés par fichier ou par dépôt, vous pouvez ajouter ou modifier des types MIME à utiliser sur GitHub Pages. Pour plus d’informations, consultez les recommandations relatives aux contributions mime-db.

Pour aller plus loin