Installer Hugo
Comprendre comment installer goHugo sur sa machine ou le configurer sur un système de déploiement automatisé (site en ligne). ⚠️ Nécessite de savoir ouvrir un terminal, un petit peu de manip, mais une fois réalisé, on a l’impression d’être un DEV 😁.
Hugo est un exécutable qui fonctionne sur tous les systèmes d’exploitation. Il ne dépend d’aucune autre technologie à installer au préalable (à part les systèmes de gestions d’installation type :
Brew
,Chocolatey
,pkg
). Il est sensé fonctionner sur toutes les machines existantes.
Utiliser le Terminal
Utiliser Frago
demande de savoir lancer une commande dans le terminal. Le terminal est une fenêtre (sur votre machine) avec laquelle on communique avec sa machine (en mode texte) ; on lance des commandes à la machine.
Pour utiliser goHugo
, il faut :
- Ouvrir un terminal ;
- Installer goHugo, ex :
brew install hugo
; - Aller dans le répertoire où
goHugo
est installé ; - Lancer la commande
Hugo
, ex :Hugo serve
; - Ouvrir l’url de test (copier/coller l’url donnée par le terminal, vers la barre d’adresse de son navigateur).
⚠️ Il est possible d’utiliser le terminal à partir d’un éditeur de code (ex.
https://vscodium.com/
). C’est très pratique, car la commande sera lancée dans le bon répertoire de travail. Celui dans lequel vous allez éditer les fichiers pour Frago
.
Pour cela, il faut ouvrir son éditeur ; ouvrir le répertoire de travail ; lancer le terminal à partir de l’éditeur (disponible dans la barre de menu supérieure) ; lancer la commande hugo serve
.
MacOs
Linux
Windows
Installer & Mettre à jour
Installer goHugo
- https://gohugo.io/getting-started/installing/
- https://learn.netlify.app/fr/basics/installation/
- Howto: Install Hugo on Windows
Installer Homebrew (MacOs et Linux)
À copier dans votre terminal.
$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Lien vers le système de gestion de paquets (logiciel de gestion de paquets et applications) : https://brew.sh/ .
Exemple le plus courant d’installation avec Brew
$ brew install hugo
Exemple le plus courant de mise à jour avec Brew
brew upgrade hugo
Héberger
Héberger avec Github
Consulter la page Host on GitHub pour plus d’informations.
Github utilise son système interne GitHub Action. Un exemple de fichier de configuration est disponible : gh-pages.yml .
Héberger avec Gitlab
Consulter la page Host on Gitlab pour plus d’informations.
Github utilise son système interne Gitlab CI. Un exemple de fichier de configuration est disponible : .gitlab-ci.yml .
Héberger sans GO
Il est possible que votre plateforme de génération ne supporte pas Go (ou une version de goHugo non « extended »
). Dans ce cas, il faut télécharger le thème juste avant de construire le site (build Hugo). On utilisera par example une commande git
.
Vous pouvez ajouter le répertoire themes
à votre .gitignore
pour ne pas le pousser dans votre dépôt .git
de contenu (celui de vos données Frago).
Au moment de la génération en production
, vous appelez le thème grâce à un submodule Git
(ce sera fait à chaque génération). Attention : il appellera la dernière version du thème.
git submodule add -f https://github.com/lowdit/frago.git/ themes/frago && git submodule update --init --recursive && hugo --gc --minify --buildFuture