6 changed files with 23 additions and 145 deletions
Split View
Diff Options
-
+3 -0.gitmodules
-
+1 -02018_hugo
-
+0 -132018_hugo/Makefile
-
+0 -422018_hugo/notes.md
-
+0 -902018_hugo/slides.md
-
+19 -0README.md
+ 3
- 0
.gitmodules
View File
| @ -0,0 +1,3 @@ | |||
| [submodule "2018_hugo"] | |||
| path = 2018_hugo | |||
| url = git@framagit.org:ptilou/conf.git | |||
+ 0
- 13
2018_hugo/Makefile
View File
| @ -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 | |||
+ 0
- 42
2018_hugo/notes.md
View File
| @ -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. | |||
+ 0
- 90
2018_hugo/slides.md
View File
| @ -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/) | |||