Journal sphinxcontrib-run: exécuter du code pendant la génération d'une documentation

Posté par  . Licence CC By‑SA.
Étiquettes :
11
6
jan.
2026

Je commence l'année par une petite contribution open-source pour les documentations de projets python: sphinxcontrib-run.

TLDR; une directive qui permet d'exécuter du code à la volée pendant la génération d'une doc.

Cette extension au générateur de documentation sphinx concerne la partie des documentations d'API générées automatiquement à partir des commentaires dans le code source, les "docstrings". Les docstrings sont rédigées au format reStructuredText qui est un peu plus évolué que markdown et permet d'appeler des directives avec des (…)

Journal Static Site Generator

Posté par  . Licence CC By‑SA.
18
28
juil.
2022

Bonjour'nal
Il y a quelques temps je me suis décidé a monter un blog perso pour raconter quelques idées que j'ai en tête. Je me suis donc mis en quête d'un outil qui me conviendrait.

Je ne voulais pas d'un mastodonte lié à une BDD, mes besoins étant modeste je voulais quelque chose de léger et hébergable facilement. Donc j'ai assez rapidement exclu les Wordpress, DotClear et autre supertanker du domaine.

J'ai jeté un œil aux «Flat file CMS», tel (…)

Journal éClaircie : un moteur de blog et de site personnel statique et sans nuage

Posté par  (site web personnel) . Licence CC By‑SA.
31
13
juin
2014

éClaircie est un moteur de blog et de site personnel 100% statique et sans nuage (cloud-less). En effet, les moteurs statiques reposent souvent sur l'utilisation de services externes en ligne pour la gestion des commentaires (ex Disqus), des recherches (ex barre de recherche Google) ou des vidéo (Youtube). Ces services externes posent cependant des problèmes liés à la protection de la vie privée. Par exemple, ils peuvent être utilisés pour tracer les utilisateurs d'un site à l'autre, y compris (…)