Browse Source

Atelier Hugo 2018 : remplacement du dossier par un lien vers le dépôt officiel

master
Olivier DOSSMANN 2 years ago
parent
commit
bfa8338c05
6 changed files with 23 additions and 145 deletions
  1. +3
    -0
      .gitmodules
  2. +1
    -0
      2018_hugo
  3. +0
    -13
      2018_hugo/Makefile
  4. +0
    -42
      2018_hugo/notes.md
  5. +0
    -90
      2018_hugo/slides.md
  6. +19
    -0
      README.md

+ 3
- 0
.gitmodules View File

@ -0,0 +1,3 @@
[submodule "2018_hugo"]
path = 2018_hugo
url = git@framagit.org:ptilou/conf.git

+ 1
- 0
2018_hugo

@ -0,0 +1 @@
Subproject commit 516dc774d173e10cb0589383e96706eb53cec6eb

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

+ 19
- 0
README.md View File

@ -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…
Cancel
Save