diff --git a/.gitmodules b/.gitmodules new file mode 100644 index 0000000..b98fd9e --- /dev/null +++ b/.gitmodules @@ -0,0 +1,3 @@ +[submodule "2018_hugo"] + path = 2018_hugo + url = git@framagit.org:ptilou/conf.git diff --git a/2018_hugo b/2018_hugo new file mode 160000 index 0000000..516dc77 --- /dev/null +++ b/2018_hugo @@ -0,0 +1 @@ +Subproject commit 516dc774d173e10cb0589383e96706eb53cec6eb diff --git a/2018_hugo/Makefile b/2018_hugo/Makefile deleted file mode 100644 index f94f6a6..0000000 --- a/2018_hugo/Makefile +++ /dev/null @@ -1,13 +0,0 @@ -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 deleted file mode 100644 index 8616298..0000000 --- a/2018_hugo/notes.md +++ /dev/null @@ -1,42 +0,0 @@ -# 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 deleted file mode 100644 index 24d54d4..0000000 --- a/2018_hugo/slides.md +++ /dev/null @@ -1,90 +0,0 @@ -% 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/) diff --git a/README.md b/README.md index 28f418d..654bcb9 100644 --- a/README.md +++ b/README.md @@ -44,3 +44,22 @@ Présenté le 17 décembre 2016 au Congrès Tartines Nécessite le même paquet/dépôt que pour Gissmo, avec les même commandes. Génèrera : hugo.html + +## Atelier Hugo + +Titre : Créer un site web, un blog, un wiki, une galerie d'image ou une documentation à l'aide de Hugo + +Présenté le 11 juillet 2018 aux Réunions Mondiales du Logiciel Libre + +Contenu déporté sur [Framagit](https://framagit.org/ptilou/conf), mais récupérable avec les commandes suivantes : + +```bash +git submodule update --init --recursive +``` + +Puis : + +```bash +cd 2018_hugo +make +```