Commit 99a682bf authored by wbar's avatar wbar
Browse files

fix typos

parent 75af2156
......@@ -10,7 +10,7 @@ draft = true
Ca y est !
Voici la nouvelle version du BWog-notes ! Youpi !
En plus du changement d'hébergement, la pile technique a changé.
Auapravant, le générateur était [Pelican](https://blog.getpelican.com/), maintenant c'est [Hugo](https://gohugo.io/).
Auparavant, le générateur était [Pelican](https://blog.getpelican.com/), maintenant c'est [Hugo](https://gohugo.io/).
Voici mes raisons, et mes observations liées.
<!--more-->
......@@ -31,12 +31,12 @@ Déjà, c'était pas mieux.
J'avais bricolé un ensemble de scripts python tout gros, tout moche, pas optimisé, qui me gobait des pages html fabriquées à la main,
et qui assemblait le tout pour en faire un site complet, directement hébergeable, sans prise de tête autre que celle de bien écrire le html
(manuellement, à chaque fois, sur chaque page).
Rustique, artisanal quoiqu'un peu déguelasse, mais ça faisait le boulot.
Rustique, artisanal quoiqu'un peu dégueulasse, mais ça faisait le boulot.
M'enfin je me rendais bien compte que c'était pas terrible, ça me demandait aussi bien du temps pour la rédaction, que la mise en page.
Et oui, y'avait pas de templates ! Ni aucune fonction « moderne » pour itérer magiquement sur le contenu.
Sans compter les nombreux bugs qui freinaient le processus.
J'ai voulu tout ré-écrire de zéro, mais je me suis plutôt demandé s'il n'existait pas quelque chose de déjà fait, et surtout mieux.
J'ai voulu tout réécrire de zéro, mais je me suis plutôt demandé s'il n'existait pas quelque chose de déjà fait, et surtout mieux.
Vint alors Pelican sur la table.
C'était en python, mon langage phare de l'époque[^1], il y avait des templates, et ça semblait plutôt facile à prendre en main.
......@@ -52,7 +52,7 @@ Exemple, rien que pour rédiger en markdown, faut rajouter `pip install Markdown
Ensuite, pour les bouts de code `pip install pygments`, et lui faire générer un CSS à inclure sur le site.
Faut pas oublier d'activer le virtualenv avant ça d'ailleurs, et même pour chaque rédaction.
Et puis ça génère ouate mille fichiers de conf, d'automatistation de génération, etc.
Et puis ça génère ouate mille fichiers de conf, d'automatisation de génération, etc.
Heureusement, il existe plein de plugins pour étendre les fonctionnalités, mais bon, pour certains, ils sont quand même restreint.
Et c'est pas pour jeter la pierre aux mainteneurs, je sais que ça prend du temps, mais ils sont souvent datés.
......@@ -69,12 +69,12 @@ Au delà du bête « pourquoi pas », c'est surtout parce que dans mes flux RSS,
J'avais donc déjà sous le coude des exemples et des retours d'expérience.
Alors, l'installation par rapport à Pelican ?
Et bien installer le binaire (`pacman -Sy hugo` pour moi) et ... c'est tout !
Et bien installer le binaire (`pacman -Sy Hugo` pour moi) et ... C'est tout !
Et maintenant, et bien pour moi, à l'utilisation, c'est plus simple.
Moins d'étapes (surtout dans mes scripts de synchro / publication), plus rapide, aucune dépendance, tout est inclus.
Et si on veut faire ajouter dans une page quelque qui n'est pas prévu à la base par le Markdown (même exemple, les figures cliquables) :
zou ! un `shortcode` (mini template html dans les templates qu'on appelle avec une petite ligne qu'on définit nous même) et c'est parti !
zou ! Un `shortcode` (mini template html dans les templates qu'on appelle avec une petite ligne qu'on définit nous même) et c'est parti !
## Le nouveau processus
......@@ -103,24 +103,28 @@ Maintenant c'est :
- `./publish.sh`
- vérifier en ligne le résultat
Plus besoin du script de creation d'article, hugo, via un système de templates d'articles (appelée `archetypes`),
Plus besoin du script de création d'article, hugo, via un système de templates d'articles (appelés `archetypes`),
génère un fichier avec préambule et éventuellement début de contenu.
Le script de publication en ligne est également plus court.
Et encore, je pourrais même virer une étape en mettant un `git hook` pour publier dès que je pousse les sources.
## Conclusion
Alors sans mauvaise foi, ça va beaucoup plus vite, que ce soit pour moi, ou pour la génération et la maintenance du site.
**MAIS** il faut noter que l'investissement technique (pour moi) est bien plus gros à l'entrée pour hugo.
Il a fallut recréer le thème et les templates[^3], des `layouts` dans le jargon hugo, et c'est pas facile à prendre en main,
Alors sans mauvaise foi, ça va beaucoup plus vite, que ce soit dans mon processus de rédaction,
pour la génération des pages, ou la maintenance / évolution du site.
**MAIS** ! Parce qu'il y en a toujours un, et un gros sur ce point :
il faut noter que l'investissement technique (pour moi) est bien plus gros à l'entrée pour Hugo qu'avec Pelican.
Il a fallut recréer le thème et les templates[^3], des `layouts` dans le jargon Hugo, et c'est pas facile à prendre en main,
même en reprenant une structure déjà existante.
Il y a eu un gros temps d'adaptation aux fonctions des templates, à la logique d'organisation des fichiers,
ainsi qu'un certain temps à investir pour convertir / corriger les articles.
Une fois tout ça fait, je me sens carrément plus à l'aise maintenant.
A vous de jouer, vous avez tout en main pour choisir ! Alors, n'attendez plus, lancez-vous !
Maintenant que c'est fait, je ne regrette pas car je me sens plus à l'aise dans l'utilisation.
A vous de jouer, vous avez tout en main pour choisir ! Alors, n'attendez plus, lancez vous !
[^1]: Entre nous, ça l'est toujours dès que je dois prototyper un truc, ou scripter plus haut niveau que de la bête admin sys.
[^1]: Entre nous, ça l'est toujours dès que je dois prototyper un truc, ou scripter un truc trop haut niveau pour Bash.
[^2]: Un script perso qui pré-génère un squelette d'article.
[^3]: Pas envie de prendre un thème tout fait, j'avais déjà le mien après tout.
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment