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