Contexte
Pour notre exemple, nous allons utiliser mon nom d'utilisateur : cybermonde
Le site sera accessible à l'adresse http://cybermonde.github.io/
J'ai ajouté un domaine personnalisé : http://git.cybermonde.org/ Ce domaine est configuré chez Gandi.
Création du dépôt
La documentation complète est disponible ici : http://pages.github.com/
Créer le dépôt dont le nom sera obligatoirement : votrenomdutilisateur.github.io Ici : cybermonde.github.io
Toutes les autres options sont facultatives, je vous conseille de donner une description, d'ajouter un readme et surtout de laisser le dépôt public.
Ajout des fichiers
Je suppose que vous êtes familier avec les commandes de bases de Git.
Créons :
- un fichier index.html qui sera la page d'accueil du site
- un fichier 404.html qui s'affichera en cas d'erreur 404
- un fichier CNAME pour utiliser un domaine personnalisé
Configuration du domaine
Mon domaine cybermonde.org est géré par Gandi, pour configurer le sous-domaine git.cybermonde.org afin qu'il renvoie vers le site nouvellement créé, il faut modifier la zone DNS.
Après connexion à votre compte, il faut modifier la zone DNS en ajoutant une entrée CNAME qui renvoie vers cybermonde.github.io :
Cette procédure est semblable chez OVH par exemple, seule l'interface change.
Conclusion
Après quelques heures, une fois les DNS à jour, le résultat apparaît, je me suis inspiré du travail de https://github.com/ozh/ozh.github.com en ajoutant la gestion des Gists :
