Hugo memento

Création d’un nouveau site ‘quickstart’

1. Création du répertoire et de la structure

$ hugo new site quickstart

2. Ajout d’un thème

$ cd quickstart
$ git init
$ git submodule add https://github.com/budparr/gohugo-theme-ananke.get themes/ananke

3. Configuration du thème

$ echo 'theme = "ananke"' >> config.toml

4. Add content

$ hugo new posts/my-first-post.md

5. Lancement du serveur

$ hugo server -D

Compilation

$ hugo

/!\ hugo n’efface pas le répertoire public/ avant compilation. A effacer manuellement si besoin, ou utiliser un répertoire différent pour le developpement public-dev/

hugo server -D -d public-dev

Structure du site

|- archetypes/ : template de création de fichier avec '$ hugo new ...'
|- content/    : contenu du site, chaque repertoire est une section
|- data/       : configurations pour générer le site + template de data
|- layouts/    : templates de présentation (*.html)
|- static/     : contenu static (images, css, js...)
|- themes/     : thèmes de présentation
|- config.toml : fichier de configuration de fabrication du site

Installation

$ sudo apt update
$ sudo apt install snapd
$ sudo snap install hugo

Process de création d’un article

$ hugo new <Categorie>/<article.md>
$ vi <Categorie>/<article.md>
  +++
  ...
  drafts = true
  +++
$ hugo server -D -d public-dev # -D inclus les drafts
$ vi <Categorie>/<article.md> # Quand page mise au point
  drafts:false # ou supprimer la ligne
$ hugo
$ rsync # synchro vers le serveur web