Prise en main rapide de Hugo

Des commandes rapides pour utiliser Docker et Hugo.

Générer un site Hugo, ajouter des articles.

Créer un nouvel environement de test.

Tout ce qu’il faut pour débuter!

Créer un nouveau billet blog (blog/Nom-du-billet/_index.md)#

  
hugo new blog/Nom-du-billet/index.md
  

Créer un nouveau billet tuto (tuto/Nom-du-billet/_index.md)#

  
hugo new tuto/Nom-du-billet/index.md
  

Créer un nouveau billet blog (blog/Nom-du-billet.md)#

  
hugo new blog/Nom-du-billet.md
  

Créer un nouveau billet tuto (tuto/Nom-du-billet.md)#

  
hugo new tuto/Nom-du-billet.md
  

Lancer le serveur local pour tester mon site#

  
docker run --rm -p 1313:1313 --name debugHugo -v ${PWD}/limonier.be:/src -v ${PWD}/hugo_cache:/tmp/hugo_cache hugomods/hugo:ci server --buildDrafts --cleanDestinationDir
  

Nouvel environnement de test#

On se base sur une structure comme il suit:

limonier
├── cv_pdf/
├── docker/
├── Docker.md
├── hugo_cache/
├── Jenkinsfile
├── LICENSE
├── limonier.be/
└── README.md

1. Dans le dossier principal (limonier/), créer un dossier hugo_cache/.

2. On lance l’image docker et on se connecte à son terminal.

  
docker run -it -v ${PWD}/limonier.be:/src -v ${PWD}/hugo_cache:/tmp/hugo_cache hugomods/hugo:ci /bin/sh
  

3. Une fois dans l’image, éxécuter les commandes suivantes, qui peuvent avoir des erreurs si les dossiers/fichiers existent déjà.

  
hugo mod get -u
hugo mod npm pack
npm install
hugo mod tidy
hugo mod vendor
  

4. Dans une autre console éxécuter la commande qui permettra d’avoir un rendu temps réel du site.

  
docker run --rm -p 1313:1313 --name debugHugo -v ${PWD}/limonier.be:/src -v ${PWD}/hugo_cache:/tmp/hugo_cache hugomods/hugo:ci server --buildDrafts --cleanDestinationDir
  

On a maintenant un environnement de test complet avec un terminal dans lequel on peut effectuer les commandes hugo sans impacter son ordinateur ainsi qu’un serveur hugo qui affiche chaque changement dans nos pages du site hugo.