@ -0,0 +1,3 @@ | |||
[submodule "2018_hugo"] | |||
path = 2018_hugo | |||
url = git@framagit.org:ptilou/conf.git |
@ -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 |
@ -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. | |||
@ -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/) |