Introduction

Je vais essayer dans cet article de vous présenter la mise en place pas à pas d’un blog sur Github.

il n’y aura pas forcément outs les petis details ni de la configuration en profondeur, mais à minima comment créer son blog et qu’il soit hébergé par Github.

Dédicace à Thierry Degols ;-) j’espère répondre à tes attentes.

Création

1. Création d’un “repository”

Pour créer un blog sur Github la première chose à faire est de créer un nouveau “repository”

Sur sa page Github, on se rend donc dans “Repositories”

puis on clique sur le bouton “New” :

On arrive alors dans le processus normal de création d’un “repository”

Il faut :

• un nom. Exemple : christophekumor.github.io

il faut respecter ce format de nom cela permetra d’avoir une url en https://christophekumor.github.io Plus d’informations..

• Une description : Apparaîtra juste dans le “repository” mais c’est toujours plus sympas.
• Choisir public ou Private. Private étant payant. à vous de voir
• Cocher “Initialize this repository with a README”

Pour finir cliquer sur :

2. Petite config

Vous allez revenir sur votre repo fraîchement créé, Je vous conseil d’ajouter un lien vers votre blog directement sur la page de votre repo, pour cela dans la barre de Titre du repo, cliquez sur le bouton “Edit”:

Ajoutez le lien en https (ne pas faire comme sur la photo ci dessous ou j’avais juste mis http) de votre blog, en principe si vous avez bien utilisé le formalisme lors de la déclaration, celui ci doit etre de la forme https://votrenomdecomptegithub.github.io

Il ne reste plus qu’a sauvegarder avec le bouton “Save”

Vous voilà revenu sur la page d’accueil de votre repository, avec un jolie lien vers votre blog.

3. Choix d’un thème

Ce n’est pas fini, il vous faut choisir un thème pour votre site, pour cela toujours dans votre nouveau repository, vous cliquez sur l’onglet “Settings”

Puis vers le bas de la page, cliquez sur “Choose a theme”

Faite votre choix parmis les thèmes proposés par github via les vignettes du haut de la page, une fois votre choix effectué, cliquez sur le bouton “Select thème”

Il se peut que l’on vous demande de modifier le README.md de votre site, vous pouvez faire cancel et le faire plus tard..

Pour les besoins du tutorial j’ai refait un repo de test, donc ici on me propose de modifier le Readme.md. J’ai donc fait cancel

Une fois revenu sur la page de votre repository, vous avez le message avec le choix du thème qui a été appliqué

4. Vérification

Pour vérifier l’url de votre Blog, il faut aller à nouveau dans l’onglet “setting”

Vers le bas de la page, vous aurez l’information de publication de votre site :

ici on voit clairement ce qui se passe lorsque l’on ne respecte pas le formalisme dont j’ai parlé à l’étape du choix de nom de repository ou lorsqu’un repository “site/blog” existe déjà, il va publier votre “site/blog” comme un sous répertoire de votre “site/blog” principal.

And Voila ! vous êtes en ligne !!

CONCLUSION

Github supporte nativement le langage Jekyll pour la conception de vos pages ou de vos posts, je n’en ai pas du tout parlé dans ce post car etant moi même en plein apprentissage, je vais avoir du mal à donner des conseils..

En revanche voici le lien vers le site officiel :