Emacs et Org Mode

Emacs est au centre de mon environnement de rédaction technique et de développement. Org mode fournit un format source commun pour les notes, la documentation, les exemples exécutables, les matériaux de projet et ce site web.

Pourquoi le texte brut

Le texte brut est durable, interrogeable, diffable, scriptable et indépendant d'un service en ligne particulier. Git peut enregistrer des modifications significatives, les outils Unix standards peuvent inspecter les fichiers, et une migration ne dépend pas d'une fonction d'export propre à un fournisseur.

Org mode ajoute de la structure sans renoncer à ces propriétés. Titres, liens, tableaux, métadonnées, blocs de code, citations et instructions d'export restent lisibles directement dans le fichier source.

Environnement d'édition

Ma configuration Emacs privilégie une interface graphique sobre, un démarrage rapide, une typographie lisible et des commandes explicites pilotées au clavier. Elle utilise les fonctions standard d'Emacs lorsque c'est possible, avec des paquets ajoutés pour des besoins concrets tels que l'intégration Git, la prise en charge des langages, les diagnostics et le retour visuel.

Pour le développement Python, Emacs combine navigation dans les projets, Eglot, analyse statique, tests et gestion de versions. Les modifications externes sont répercutées dans les buffers plutôt que d'obliger tous les outils à s'exécuter dans Emacs.

Org comme source technique

Les documents Org peuvent mêler explications, tableaux de données, formules, références et code. Org Babel est utile pour les exemples et calculs reproductibles lorsque l'exécution est explicite et que les résultats ne sont pas confondus avec des données sources immuables.

L'export permet plusieurs chemins de publication à partir d'une seule source maintenable :

  • HTML pour le site web ;
  • LaTeX et PDF pour les documents composés ;
  • texte brut structuré pour la conservation à long terme ;
  • extraction du code par tangling lorsque la configuration littéraire est utile.

Limites

La syntaxe Org est un format centré sur Emacs plutôt qu'un standard documentaire universel. Les mises en page complexes peuvent nécessiter des réglages d'export spécifiques au backend, et la collaboration avec des utilisateurs de suites bureautiques exige souvent une conversion.

Pour ces raisons, j'utilise Org comme source de travail de référence lorsqu'il est adapté, sans prétendre que chaque document de chaque organisation devrait y être rédigé.

Publication statique

Ce site illustre l'approche : les fichiers Org sont versionnés et exportés vers du HTML statique. La source reste directement lisible, tandis que le résultat public ne nécessite aucun framework côté client ni base de données de gestion de contenu.