diff --git a/2018_hugo/Makefile b/2018_hugo/Makefile new file mode 100644 index 0000000..f94f6a6 --- /dev/null +++ b/2018_hugo/Makefile @@ -0,0 +1,13 @@ +NAME = hugo + +all: html + +pdf: slides.md + pandoc -t beamer -V theme=Ilmenau -V colortheme=dolphin --latex-engine=xelatex slides.md -o "${NAME}.pdf" + +html: slides.md reveal.js + pandoc -s -t revealjs -o "${NAME}.html" slides.md + sed -i -e 's#reveal.min.css#reveal.css#' -e 's#reveal.min.js#reveal.js#' -e 's#simple.css#night.css#' "${NAME}.html" + +clean: + rm -f *.html *.pdf diff --git a/2018_hugo/notes.md b/2018_hugo/notes.md new file mode 100644 index 0000000..8616298 --- /dev/null +++ b/2018_hugo/notes.md @@ -0,0 +1,42 @@ +# Titre + + * Charles Lesecq et Olivier DOSSMANN + * + * + + * Background développement logiciel + * aime bien les moteurs de blog statique + * ancien auteur de Makefly, le moteur de blog statique en Lua (si vous lisez LinuxFr) + +# Hugo + + * génère un site web à partir du contenu rédigé + * résultat peut être déposé chez n'importe quel hébergeur + * 5000 articles en 6 secondes + * 5 à 6 MB + * binaire unique disponible pour BSD, Linux, Windows et MacOS + * l'utilisateur est libre d'organiser son contenu comme il le souhaite + * 500+ contributeurs et des sorties de versions tous les mois environ + +## Fonctionnement + + * Markdown = format spécial pour rédiger du texte + * modèle = template + * variable = qui s'adapte suivant des paramètres + * HTML = page web + * XML = flux RSS + +## L'entête + + * TOML + * title, date et draft sont obligatoires + * les "+" indiquent l'entête (début/fin) + * draft = mode brouillon pour billets en avance + * slug = personnalisation de l'URL + réticulaire + +## Le contenu + +Le markdown est assez parlant. + + diff --git a/2018_hugo/slides.md b/2018_hugo/slides.md new file mode 100644 index 0000000..24d54d4 --- /dev/null +++ b/2018_hugo/slides.md @@ -0,0 +1,90 @@ +% Créer un site web, un blog, un wiki, une galerie d'image ou une documentation à l'aide de Hugo +% Charles Lesecq et Olivier DOSSMANN +% 11 juillet 2018 + +# Quelques mots + +## Déroulement + + * courte présentation (environ 20mn) + * atelier pratique : + * projet perso ou + * projet d'exemple + +## Pré-requis de l'atelier + + * notions de HTML préférables + * Markdown optionnel (car memento) + +# Présentation + +## Hugo + + * outil pour créer un site : + * site vitrine + * blog + * documentation / wiki + * galerie d'images + * rapide et assez léger + * autonome et multiplateforme + * souple (contenu) et multilingue + * projet actif + +## Fonctionnement + + * contenu écrit en Markdown ou importé (Wordpress, Jekyll…) + * apparence à l'aide de modèles + * modèles ont du contenu variable + * résultat en HTML, XML + * système de commentaires : + * en JS (Disqus, Isso…) + * via lien externe (LinuxFR, Lejournalduhacker…) + +# Exemple de billet + +## Une entête + +```toml ++++ +title = "Mon premier billet" +date = "2018-05-21" +draft = true +slug = "prems_prems" ++++ +``` + +## Le contenu + +```markdown +# Titre principal + +Introduction de notre billet. + +## Sous-titre 1 + +Quelques éléments **importants** : + + * un + * deux + * etc. + +## Sous-titre 2 + +Pour en [savoir plus](https://perdu.com/) +``` + +## Résultat + +**LIEN VERS SITE MONTRANT LE RÉSULTAT** + +# Questions ? + +# Atelier, partie 1/2 + +# Atelier, partie 2/2 + +# Merci + +# Liens utiles + +[https://gohugo.io/](https://gohugo.io/)