HUGO est un gestionnaire de contenu statique, c’est à dire sans base de données et sans fichier dynamique (php ou autre langage), qui génère des sites Web ou des blogs uniquement constitués de fichiers HTML, un retour au source.

Ce framework (comprendre applicatif) très séduisant se présente sous la forme d’un petit exécutable utilisé en ligne de commande, il génère le squelette du site, transforme les documents Markdown en articles ou en pages, génère le site à la volée et peut le publier sur Github.

Présenté comme le plus rapide et le plus populaire, je l’ai testé avec un bilan mitigé.

Ce n’est pas un outil facile, la ligne de commande avec des tonnes d’options c’est vraiment moyen à utiliser surtout pour un débutant. Heureusement, quelques commandes de base peuvent suffire. HUGO s’utilise avec un éditeur performant notamment pour l’édition des fichiers du site (HTML ou MarkDown), Geany ou reText par exemple.

Il n’existe AUCUN tutoriel digne de ce nom qui aborde réellement la mis en œuvre complète de l’outil, tous les article français et anglais que j’ai lus expliquent en long  et large les nombreux avantages d’HUGO puis listent rapidement 2 ou 3 commandes :

• création du site
• création d’un article
• installation d’un thème
• lancement du serveur local

sans jamais entrer dans le détails. On a juste l’impression que le rédacteur n’en sait pas plus. La consultation de la doc sur le site officiel est dans la même veine (page QuickStart).

A l’usage, HUGO est assez complexe à paramétrer notamment au niveau du thème. Les réglages y sont toujours spécifiques au thème, n’espérez pas changer de thème rapidement, il faudra se plonger dans la doc du thème.

La gestion de l’arborescence n’est pas non plus évidente pour les sites, étant liée étroitement au thème.

Ce que je critique le plus dans ce genre d’outil, c’est qu’il est créé pour un public réduit  sans qu’un seul tutoriel pédagogique permette une prise en main complète.

Il existe une interface graphique disponible pour Linux (qui n’a pas fonctionné sur Ubuntu 16 lors des essais) et Windows basée sur Java 8, Lipi   permet de mettre en œuvre HUGO sans trop se prendre la tête, idéal pour le tester sur un blog.

Hugo est un logiciel efficace qui n’intéressera que quelques connaisseurs. Pour ma part je persévère dans l’exploration et dans la découverte d’HUGO…

MARP ne s’installe pas, que ce soit sous Win, Macos ou Linux, c’est un logiciel portable qui s’exécute après décompactage de l’archive.

Sauf que sous Ubuntu, il y a un problème de dépendance et que l’appli ne fonctionne pas. Dans un terminal, il suffit de cette commande pour régler le problème…

sudo apt-get install libgconf-2-4

Enjoy !

Pour le découvrir et apprendre markdown, ce tutoriel doit vous rendre autonome en moins de 30 minutes.

Saurez-vous relever le défi ?

Pas d’animation, pas de transition, on ne perd pas un temps fou avec des fioritures inutiles, on se contente de texte, de liens et de quelques images grâce à la syntaxe MarkDown.

La syntaxe est très simple, les diapositives sont définies par une suite de 3 traits et la mise en forme s’effectue en appliquant au texte des instructions de formatage, exemple pour le **gras**.

MARP affiche en temps réel le résultat de la mise en forme, 3 modes de visualisation sont proposés. Une fois la présentation terminée, elle est exportée en PDF et enregistrée sous le format Markdown, en fait un format texte. La mise en forme s’effectue de deux manières grâce à :

• des instructions pour la mise en forme du texte et l’insertion de liens et d’images.
• des directives de paramétrage du diaporama : dimension et orientation des diapositives, pied de page, numérotation et thème.

Pour expliciter la syntaxe, deux exemples sont fournis avec MARP mais malheureusement ils ne sont pas très pédagogiques et ils sont en anglais.

Ayant l’objectif de proposer cet outil à mes étudiants, deux guides MARP ont été mis en ligne sur un github.

Le premier décrit les instructions, le second les directives.

Lien : https://github.com/fredtempez/MARP_Guides

C’est un article de Korben qui m’a permis de découvrir Marp, un petit utilitaire disponible en binaire pour différentes plate-formes en version portable, ce qui veut dire qu’il n’y a rien à installer.

Une fois Marp lancé, on “rédige” le texte de la présentation dans la partie gauche de l’écran en Mardown, pas de panique c’est hyper simple. Ce que je trouve rigolo dans l’affaire c’est de revenir à la fin des années 80 avec une mise en forme pas vraiment visuelle et pourtant efficace.

Notions essentielles de Markdown :

• Pour changer de diapositive :
  —
• Pour appliquer un style de titre comme en html :
  # titre ##
• Avec des niveaux comme pour les balises , exemple :
  ## titre 2 ##
• Pour mettre un mot en évidence **mot** ou en italique _mot_
• Pour un citation, la ligne commence par >
  > “Qui vivra verra”
• Pour insérer un lien
  [Google](http://www.google.fr)
• Pour insérer une image
  

Pour approfondir la syntaxe, je vous propose ce pdf à imprimer avec toutes les commandes. Ensuite dans Help/Open Examples, vous trouverez les détails de la syntaxe spécifiques aux thèmes intégrés dans Marp, deux pour le moment et ainsi que les directives (pour gérer la numérotation, le ratio d’écran).

Après quelques minutes de pratique, on maîtrise rapidement les bases de la syntaxe et d’une manière fort surprenante on gagne très vite en productivité, concentré sur le contenu et non sur la mise en forme.

Mais après ?

Une fois votre premier diaporama terminé, Marp le sauvegarde en md,  un simple fichier texte.

Pour l’exploiter, il faut exporter la présentation en pdf avec la commande “Export Slide as PDF”. Mais ensuite ?

Bien évidemment, vous pouvez mettre le pdf à disposition de l’auditoire, mais pour une véritable présentation, il suffit juste d’utiliser Acrobat Reader ou un logiciel similaire en mode présentation.

Sous Linux avec Evince, activez le mode présentation :

Sous Windows, c’est aussi possible avec Acrobat Reader et là il y a un peu plus d’options comme des transitions et l’affichage d’une barre de navigation.

J’oubliais, Marp  est un logiciel libre.

Marp : https://yhatt.github.io/marp/