À propos de ce site

Ce site est volontairement simple.

Son objectif est de publier du contenu technique sous une forme qui reste lisible, inspectable et maintenable sans dépendre d'une grosse application web ou d'une plateforme propriétaire de publication.

Principes

Le site suit quelques principes pratiques :

  • le contenu source doit rester en texte brut ;
  • le processus de publication doit être reproductible ;
  • le HTML généré doit fonctionner sans framework applicatif côté client ;
  • la navigation doit dériver d'une structure de contenu explicite ;
  • le style doit rester réduit et compréhensible ;
  • JavaScript doit être facultatif plutôt que fondamental ;
  • les documents doivent rester accessibles par des URL stables ;
  • l'hébergement doit être possible avec un serveur HTTP conventionnel.

Org Mode

Org Mode est utilisé comme format source car il convient bien à la rédaction technique, aux documents structurés, aux blocs de code source, aux liens, tableaux et notes tout en restant directement modifiable comme texte.

Hugo analyse les fichiers Org pendant le build. Emacs reste l'éditeur privilégié, mais il n'est plus nécessaire à la construction du site statique elle-même.

Hugo

Hugo fournit la mécanique de site qui devait auparavant être implémentée autour de l'exporteur Org : sections, templates, métadonnées de pages, ordre, navigation et sortie du site généré.

L'objectif n'est pas de remplacer Org Mode, mais de donner au site un modèle dédié de site statique tout en conservant Org comme langage de rédaction.

Comportement minimal côté client

Le contenu lui-même ne dépend pas de JavaScript pour être lisible.

Aucun système publicitaire ni plateforme d'analytique n'est requis par le site.