À propos de docme
docme (docme.amia.fr) est un convertisseur de documents souverain et
libre : Markdown ou HTML → PDF, diaporama PDF (16:9) ou PowerPoint (PPTX). Aucune donnée n'est
envoyée à un service externe — tout est rendu sur le serveur.
D'où vient docme
De deux pages. RestoTrax — le logiciel de restaurant de l'écosystème — porte une aide
et un à propos écrits en Markdown (pages/aide.md, pages/a-propos.md),
rendus à l'écran par @mostajs/markdown-html. À l'écran, tout allait bien. Il a fallu les
remettre à quelqu'un — un exploitant, un comptable, un formateur — et un écran ne se remet
pas. C'est ce besoin-là, et rien de plus ambitieux, qui a produit cette chaîne.
Ce qu'on a appris en chemin vaut d'être écrit ici, parce que c'est le piège où l'on tombe une fois : la documentation écrite et la documentation engendrée par le code ne se rendent pas avec le même outil.
| Engendrée par le code | Écrite en Markdown | |
|---|---|---|
| Ce que c'est | ce que le logiciel est : modules composés, API, exports | ce qu'on a pensé : études, audits, plans, décisions, articles |
| Sa source | package.json, llms.txt, les en-têtes — jamais une main | un .md versionné, rédigé |
| À l'écran | @mostajs/docs-ui | @mostajs/markdown-html |
| À remettre | on la régénère | docme, cette page-ci |
docs-ui échappe tout ce qu'il reçoit : il attend de la donnée, pas de la prose.
Lui confier un guide rédigé l'afficherait caractère par caractère, balises comprises — ce n'est pas
un manque, c'est sa nature. Symétriquement, une liste de modules recopiée à la main est
fausse dès le module suivant, et personne ne s'en aperçoit. La règle de maison en a tiré son
§9.bis, où docme est nommée chaîne canonique de la documentation écrite.
Technologie — composition, pas réinvention
docme est une simple interface au-dessus de l'écosystème @mostajs/*, assemblée par
composition :
| Brique | Rôle |
|---|---|
@mostajs/markdown-html | Markdown → HTML (zéro-dépendance) |
@mostajs/doc-themes + @mostajs/palette | thèmes à contrastes validés (source : palette.amia.fr) |
@mostajs/doc-export | orchestration (le cœur mince) — et, depuis sa 0.2.1, la commande doc-export |
@mostajs/doc-driver-chrome | HTML → PDF (Chrome headless) |
@mostajs/doc-driver-pandoc | Markdown → PPTX (pandoc) |
Le cœur est zéro-dépendance ; les moteurs lourds (navigateur, pandoc) sont des drivers interchangeables — on adopte le meilleur outil du monde par besoin, jamais on ne le réinvente.
Ce site n'a aucun privilège sur la commande : les deux appellent le même cœur, et c'est ce qui les empêche de diverger. Ce qui est réparé dans le module l'est des deux côtés le même jour.
Les thèmes des documents suivent la même source de marque que la vitrine hadhinat.amia.fr : palette.amia.fr (Palette Studio). La palette du projet est récupérée puis dérivée et validée localement.
Auteur & licence
Conçu et développé par Dr Hamid MADANI <drmdh@msn.com>. Logiciel libre sous licence AGPL-3.0-or-later.