[ADD] New conference about Hugo for RMLL 2018

This commit is contained in:
Olivier DOSSMANN 2018-06-26 16:39:06 +02:00
parent 4add3aabac
commit da2094ab73
3 changed files with 145 additions and 0 deletions

13
2018_hugo/Makefile Normal file
View File

@ -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

42
2018_hugo/notes.md Normal file
View File

@ -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.

90
2018_hugo/slides.md Normal file
View File

@ -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/)