Démarrage rapide pour les pages GitHub

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

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. Pour plus d’informations, consultez plans de GitHub.

Dans cet article

Introduction

Dans ce guide, vous allez créer un site utilisateur à <username>.github.io.

Création de votre site web

  1. Dans le coin supérieur droit de n’importe quelle page, sélectionnez sur , puis cliquez sur Nouveau référentiel.

    Capture d’écran d’un menu déroulant GitHub montrant les options permettant de créer des éléments. L’élément de menu « Nouveau référentiel » est souligné en orange foncé.

  2. Entrez username.github.io comme nom du dépôt Remplacez username par votre GitHub nom d’utilisateur. Par exemple, si votre nom d’utilisateur est octocat, le nom du dépôt doit être octocat.github.io.

Capture d’écran des paramètres GitHub Pages dans un dépôt. Le champ de nom du référentiel contient le texte « octocat.github.io » et est décrit en orange foncé.

  1. Choisissez une visibilité de dépôt. Pour plus d’informations, consultez « À propos des dépôts ».

  2. Réglez l’option Ajouter README sur Actif.

  3. Cliquez sur Créer le dépôt.

  4. Sous le nom de votre référentiel, 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é.

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

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

  7. Sous « Génération et déploiement », sous « Branche », utilisez le menu déroulant Branche et 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é.

  1. 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.
  2. Accédez à username.github.io pour voir votre nouveau site web. Notez qu’il peut prendre jusqu’à 10 minutes pour que les modifications apportées à votre site soient publiées après avoir envoyé les modifications GitHub.

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 de fichiers, vérifiez si _config.yml existe. S’il n’existe pas, créez un fichier nommé _config.yml.

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

  4. Cliquez pour modifier le fichier.

  5. 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!

  6. Lorsque vous avez terminé de modifier le fichier, cliquez sur Commiter les modifications.

Étapes suivantes

Vous avez créé, personnalisé et publié votre premier GitHub Pages site web, mais il y a tellement plus à explorer ! Voici quelques ressources utiles pour effectuer vos étapes suivantes :GitHub Pages