hscc

Soure code of <https://hugo.soucy.cc>.
git clone git://soucy.cc/hscc.git
Log | Files | Refs

commit e7bb7f4cee3b321ed458ee5161a450edcb49fc2d
parent 084aa16f56c23a2e1bbdd267a17d298e69d816d9
Author: Hugo Soucy <hugo@soucy.cc>
Date:   Mon, 12 Apr 2021 11:50:59 -0400

Add new contents

Diffstat:
Acontent/2021/mp/planter-des-arbres.lua | 8++++++++
Acontent/2021/mp/planter-des-arbres.md | 14++++++++++++++
Acontent/2021/nt/journee-qui-existe-pas.lua | 7+++++++
Acontent/2021/nt/journee-qui-existe-pas.md | 3+++
Acontent/satelito.lua | 5+++++
Acontent/satelito.md | 96+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
6 files changed, 133 insertions(+), 0 deletions(-)

diff --git a/content/2021/mp/planter-des-arbres.lua b/content/2021/mp/planter-des-arbres.lua @@ -0,0 +1,8 @@ +return { +title = "Planter des arbres", +url = "https://philstjacques.com/2021-04-11-planter-arbres.html", +date = "2021-04-12", +datetime = "10:51:16", +posttype = "bookmark", +keywords = { "arbre","humeur","forêt", "Philippe St-Jacques"} +} diff --git a/content/2021/mp/planter-des-arbres.md b/content/2021/mp/planter-des-arbres.md @@ -0,0 +1,14 @@ +<https://philstjacques.com/2021-04-11-planter-arbres.html> + +> [...] +> +> &laquo;Planter des arbres est un acte d'abnégation de soi car ce sont nos +> enfants qui récolteront le fruit de notre labeur. +> +> Planter des arbres est un acte militant et révolutionnaire car on +> s'extirpe de la course omniprésente à la performance et au profit +> instantané. +> +> [...] +> +> Plantez des arbres.&raquo; diff --git a/content/2021/nt/journee-qui-existe-pas.lua b/content/2021/nt/journee-qui-existe-pas.lua @@ -0,0 +1,7 @@ +return { +title = "Une journée qui n'existe pas", +date = "2021-04-01", +datetime = "13:41:02", +posttype = "note", +keywords = { "humeur", } +} diff --git a/content/2021/nt/journee-qui-existe-pas.md b/content/2021/nt/journee-qui-existe-pas.md @@ -0,0 +1,3 @@ +J'aimerais ça vous dire que je me sens comme si on était +vendredi. Mais non, je me sens comme dans une journée qui n'existe +pas. diff --git a/content/satelito.lua b/content/satelito.lua @@ -0,0 +1,5 @@ +return { + title = "Satelito est un générateur de site HTML statique écrit en lua script", + date = "2021-04-09", + datetime = "14:34:50", +} diff --git a/content/satelito.md b/content/satelito.md @@ -0,0 +1,96 @@ +# Satelito + +[*Attention Satelito est en cours de développement ainsi que sa documentation*.] + +**Satelito** est un générateur de site statique en ligne de commande, fait +avec le langage de programmation lua et destiné aux systèmes +d'exploitations dérivés de Unix (GNU/Linux, BSD, Mac OS, etc). Le +support pour Windows viendra peut-être éventuellement. + +Comme la plupart des SSG (Static Site Generator), Satelito crée des +pages HTML à partir de fichiers markdown. Et utilise des fichiers lua +script pour les métadonnées. Il n'y a pas de support pour des +métadonnées directement en markdown (frontmatter). Nous comptons +plutôt sur la versatilité des tableaux lua qui nous permmettent +d'étendre facilement les fonctionnalités des pages. + +Pour les gabarits, Satelito utilise l'engin [etlua templating +language](https://github.com/leafo/etlua) qui est simple mais +puissant, puisqu'il nous permet d'utilisé lua directement dans les +*templates*. + +Ainsi, grâce à l'utilisation de Satelito, vous vous familiarisez avec +langage de programmation, qui a une exécution rapide et une courte +courbe d'apprentissage. + +## Installation + +Pour installer Satelito, vous devez déjà avoir +[Luarocks](https://luarocks.org/) et [Git](https://git-scm.com/) sur +votre ordinateur. + +Puis ensuite dans votre terminal: + + luarocks install --server=https://luarocks.org/dev satelito --local. + +Pour tester si votre installtion c'est vraiment bien passée, vous pouvez invoquer la page d'aide avec la commande suivante: + + satelito -h + +Ce qui vous retournera quelque chose qui ressemble à ça: + + Usage: satelito [-h] <command> ... + + Satelito is a static site generator in lua script. + + Options: + -h, --help Show this help message and exit. + + Commands: + init Init the sample website in your $HOME folder. + pipe Build the site by inputing one or more markdown files through the pipeline. + make Build the site from his directory. + + For more info, see https://soucy.cc/git/satelito/file/README.md.html + + +## Démarrer un projet + +Pour créer un projet vous devez utiliser la commande `init` comme suit: + + satelito init + +Satelito clonera alors [le site web de +démonstration](https://soucy.cc/git/satelito-sample/files.html) dans +votre répertoire utilisateur, communément appelé votre `$HOME`. + + Clonage dans '/home/hs0ucy/satelito-sample'... + remote: Enumerating objects: 57, done. + remote: Counting objects: 100% (57/57), done. + remote: Compressing objects: 100% (56/56), done. + remote: Total 57 (delta 14), reused 0 (delta 0), pack-reused 0 + Réception d'objets: 100% (57/57), 487.31 Kio | 2.13 Mio/s, fait. + Résolution des deltas: 100% (14/14), fait. + -------------------------------------------------------------------------------------------- + total 48 + drwxr-xr-x 5 hs0ucy hs0ucy 512 Apr 9 15:48 . + drwxr-xr-x 33 hs0ucy hs0ucy 1536 Apr 9 15:48 .. + -rw-r--r-- 1 hs0ucy hs0ucy 922 Apr 9 15:48 config.lua + drwxr-xr-x 3 hs0ucy hs0ucy 512 Apr 9 15:48 content + drwxr-xr-x 4 hs0ucy hs0ucy 512 Apr 9 15:48 public_html + drwxr-xr-x 2 hs0ucy hs0ucy 512 Apr 9 15:48 templates + -------------------------------------------------------------------------------------------- + You shoul rename `~/satelito-sample` and edit `~/satelito-sample/config.lua` according to your needs. + -------------------------------------------------------------------------------------------- + +À partir de là, je vous conseille de renommer `~/satelito-sample` et +modifier `~/sample/config.lua` selon vos besoins. + +## Explorer les concepts de base et certaines conventions + +### Un générateur de page + +Je crois que Satelito est designer davantage comme un générateur de +page que comme un générateur de site, puisqu'il est possible, grâce à +la commande `pipe` de construire une page à la fois ou de cibler un +répertoire en particulier sans devoir tout reconstruire le site.