Mise en place du blog

Passage à org-mode

Comment passer à org-mode pour publier un blog ?

Il y a plusieurs articles/tutoriels sur le web, qui ne sont pas tous très clairs, mais à force de les lire et de tester on arrive à voir ce qu’ils signifient. Le manuel d’org-mode est un peu trop dense/spécialisé, donc il n’est pas facile à utiliser sans ces tutoriels.

Ma configuration

Tout est dans : org-publish.el.

Nouveau contenu

Créer un fichier org par article dans [racine du dépôt]/org/.

Publication du site

Il suffit d’exécuter (org-publish "brandelune.srht.site" t) pour convertir la hiérarchie de fichiers org (et les fichiers attenants).

Test local du site

Se mettre dans le dossier où se trouvent les fichiers nouvellement créés (ici /public) et lancer un server http pour tester sur http://localhost.

$ cd [racine du dépôt]/public

$ python3 -m http.server

Le site se trouve sur : http://localhost:8000

Déploiement du site

Je suis sur sr.ht, la procédure à suivre est donc la suivante :

$ cd [racine du dépôt]

$ tar -C public -cvz . > site.tar.gz

$ hut pages publish -d brandelune.srht.site site.tar.gz

Et après quelques secondes, le site mis à jour est disponible ici :

https://brandelune.srht.site/intro.html

À faire

  • ajouter les dates de publications automatiquement à l’index
  • ajouter des balises par thème
  • modifier la feuille de style pour mettre l’index sur chaque page
  • écrire un utilitaire qui prenne en charge toutes les commandes

Suggestions

  • Bastien me suggère d’utiliser une macro pour insérer automatiquement la date :

#+date: <2025-04-19 sam.>

#+macro: pub-by (eval (format "publié par %s" $1))

Un texte {{{pub-by(votre serviteur)}}} le {{{date(%d %B %Y)}}}.

(Publié le 19 avril 2025)