Atelier Hugo 2018 : remplacement du dossier par un lien vers le dépôt officiel
parent
da2094ab73
commit
bfa8338c05
|
|
@ -0,0 +1,3 @@
|
||||||
|
[submodule "2018_hugo"]
|
||||||
|
path = 2018_hugo
|
||||||
|
url = git@framagit.org:ptilou/conf.git
|
||||||
|
|
@ -0,0 +1 @@
|
||||||
|
Subproject commit 516dc774d173e10cb0589383e96706eb53cec6eb
|
||||||
|
|
@ -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/)
|
|
||||||
19
README.md
19
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.
|
Nécessite le même paquet/dépôt que pour Gissmo, avec les même commandes.
|
||||||
|
|
||||||
Génèrera : hugo.html
|
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
|
||||||
|
```
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue