Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.

Démarrage rapide pour GitHub Pages

Vous pouvez utiliser GitHub Pages pour présenter certains projets open source, héberger un blog ou même partager votre CV. Ce guide vous aidera à vous lancer dans la création de votre prochain site web.

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.

Introduction

Les pages GitHub Pages sont des pages web publiques hébergées et publiées via GitHub Enterprise Server. Le moyen le plus rapide d’être opérationnel est d’utiliser le sélecteur de thème Jekyll pour charger un thème prédéfini. Vous pouvez ensuite modifier le contenu et le style de vos pages GitHub Pages.

Ce guide vous explique les étapes de création d’un site utilisateur sur username.github.io.

Création de votre site web

  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

  2. Entrez username.github.io comme nom du dépôt Remplacez username par votre nom d’utilisateur GitHub. Par exemple, si votre nom d’utilisateur est octocat, le nom du dépôt doit être octocat.github.io. Champ Nom du dépôt 1. Sous le nom de votre dépôt, cliquez sur Paramètres. Bouton Paramètres du dépôt

  3. Dans la barre latérale gauche, cliquez sur Pages. Onglet Page dans la barre latérale gauche

  4. Sous « Génération et déploiement », sous « Source », sélectionnez Déployer à partir d’une branche.

  5. Sous « Génération et déploiement », sous « Branche », utilisez le menu déroulant Aucune ou Branche et sélectionnez une source de publication.

    Menu déroulant pour sélectionner une source de publication

  6. Ouvrez éventuellement le fichier README.md de votre dépôt. Le fichier README.md est l’endroit où vous allez écrire le contenu de votre site. Vous pouvez modifier le fichier ou conserver le contenu par défaut pour l’instant.

  7. Accédez à username.github.io pour voir votre nouveau site web. Remarque : La publication des changements de votre site peut prendre jusqu’à 10 minutes après les avoir poussés vers GitHub Enterprise Server.

Modification du titre et de la description

Par défaut, le titre de votre site est username.github.io. Vous pouvez changer le titre en modifiant le fichier _config.yml dans votre dépôt. Vous pouvez aussi ajouter une description pour votre site.

  1. Cliquez sur l’onglet Code de votre dépôt.

  2. Dans la liste des fichiers, cliquez pour _config.yml ouvrir le fichier.

  3. Cliquez sur pour modifier le fichier.

  4. Le fichier _config.yml contient déjà une ligne qui spécifie le thème de votre site. Ajoutez une nouvelle ligne avec title: suivi du titre souhaité. Ajoutez une nouvelle ligne avec description: suivi de la description souhaitée. Par exemple :

    theme: jekyll-theme-minimal
    title: Octocat's homepage
    description: Bookmark this to keep an eye on my project updates!
    
  5. Quand vous avez terminé la modification du fichier, cliquez sur Commiter les modifications.

Étapes suivantes

Pour plus d’informations sur l’ajout de pages supplémentaires à votre site, consultez « Ajout de contenu à votre site GitHub Pages en utilisant Jekyll ».

Pour plus d’informations sur la configuration d’un site GitHub Pages avec Jekyll, consultez « À propos de GitHub Pages et de Jekyll ».