~sroccaserra/sroccaserra.srht.site

My blog
f Ajoute la garanti 0 % de contenu généré
r Ajoute précision sur modélisation évidente
r Use variables for protocol & base url in rss.xml

refs

main
browse  log 

clone

read-only
https://git.sr.ht/~sroccaserra/sroccaserra.srht.site
read/write
git@git.sr.ht:~sroccaserra/sroccaserra.srht.site

You can also use your local clone with git send-email.

#Site

#Intention

Coder un site pour collecter mes articles avec le moins d'outils possible, si possible ce qui est déjà installé sur un Linux pour développer.

Quelques détails techniques :

  • Les articles sont écrits en gemtext, avec l'extension .gmi.
  • Un convertisseur gemtext -> HTML écrit en C et ne dépendant que de la libc se trouve dans le répertoire gemtext_to_html
  • Le titre et la date des articles sont injectés dans le layout par m4, qui est souvent installé par défaut.
  • Les fichiers HTML complets sont générés par une règle Make, uniquement si leurs dépendances ont changé.
  • La liste des articles dans l'index est générée automatiquement.
  • La liste des items dans le fichier rss.xml est générée automatiquement.
  • Tapper make suffit pour mettre à jour tout ce qui doit l'être.
  • Le site peut être publié en version HTML/HTTP avec la target publish_html, et en version gemtext/Gemini avec la target publish_gmi.
  • Optionel : pour visualiser mes changements, j'utilise Python, installé aussi par défaut, pour démarrer un serveur HTTP local.

#Références

Inspirations pour coder ce site le plus simplement possible :

Refs techniques :