Créer une page GitHub

Cette page est écrite en HTML et publiée grâce à GitHub Pages. Elle sert à la fois de démonstration et de tutoriel complet.

Qu’est‑ce que GitHub Pages ?

GitHub Pages est un service gratuit qui permet d’héberger des pages web directement depuis un dépôt GitHub. Il suffit d’ajouter un fichier index.html ou index.md dans un dépôt, puis d’activer GitHub Pages.

Étape 1 — Créer un dépôt GitHub

1. Connectez-vous à GitHub.
2. Cliquez sur New repository.
3. Donnez un nom à votre dépôt (ex. mon-site).
4. Choisissez Public.
5. Cliquez sur Create repository.

Étape 2 — Ajouter un fichier index.html

1. Dans votre dépôt, cliquez sur Add file → Create new file.
2. Nommez le fichier index.html.
3. Collez le contenu de cette page.
4. Cliquez sur Commit new file.

Étape 3 — Activer GitHub Pages

1. Allez dans Settings du dépôt.
2. Dans le menu de gauche, cliquez sur Pages.
3. Dans Build and deployment, choisissez :
  • Source : Deploy from a branch
  • Branch : main
4. Cliquez sur Save.

Étape 4 — Accéder à votre site

Une fois la génération terminée, GitHub affiche une URL du type :
https://votre-nom.github.io/nom-du-depot/
Cliquez dessus pour voir votre site en ligne.

Markdown ou HTML ?

GitHub Pages peut afficher des pages écrites en HTML ou en Markdown.

Une page Markdown est ecrite dans un fichier .md, puis transformee automatiquement en page HTML. GitHub Pages utilise un moteur appelé Jekyll pour faire cette conversion. Vous pouvez créer un blog ou un site complet avec Jekyll. Jekyll supporte aussi les fichiers HTML, mais le Markdown est plus simple pour ecrire du contenu sans se soucier de la syntaxe HTML. Il supporte la création de layouts personnalisés, l'inclusion de fichiers, les variables, et bien plus encore. En savoir plus sur Jekyll.