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.
- https://taingram.org/blog/org-mode-blog.html
- https://orgmode.org/worg/org-tutorials/org-publish-html-tutorial.html
- https://orgmode.org/manual/Publishing.html
- https://meganrenae21.github.io/Meg-in-Progress/posts/blogging-with-org-mode.html
- https://opensource.com/article/20/3/blog-emacs
- https://ogbe.net/blog/emacs_org_static_site
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 :
À 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)}}}.
Faire un fichier MakeFile pour coordonner tout ceci ?
(Publié le 19 avril 2025)