Développement et déploiement
La documentation de Darktable est conservée dans le référentiel dtdocs. Les modifications sont introduites via des pull requests (voir flux de travail). Les traductions sont maintenues via weblate ; voir traductions.
🔗Production
L’ensemble complet des productions (site HTML, EPUB et PDF par langue) est construit par ./tools/build-all.sh <base_url>
Cela génère le contenu traduit à partir des fichiers PO, puis construit le
Site HTML, EPUB et un PDF par langue activée. Les productions sont écrites
sous public/, avec des PDF dans public/<lang>/darktable_user_manual.pdf.
Exigences : Hugo (étendu), weasyprint et po4a pour
l’étape de traduction.
🔗Déploiement de pages GitHub (pour le développement)
À des fins de développement, les documents sont déployés sur les pages GitHub à chaque push : une action GitHub exécute tools/build-all.sh, qui génère des sorties HTML, EPUB et PDF. Ceux-ci sont validés dans la branche gh-pages du référentiel et servis via les pages GitHub à https://darktable-org.github.io/dtdocs/. La génération de pages traduites est désactivée dans le déploiement des pages GitHub.
🔗Déploiement officiel sur darktable.org
Le déploiement officiel du manuel se fait sur le serveur pixls.us à l’adresse docs.darktable.org/usermanual/stable/ pour la version courante et docs.darktable.org/usermanual/development/ pour l’instantané de développement de Darktable.
Les dépôts sont régulièrement extraits et la documentation est construite avec Hugo, y compris les traductions ainsi que les sorties EPUB et PDF. Le journal de construction peut être trouvé ici.
🔗Versionnage et archivage du manuel
À chaque version majeure de Darktable, une branche release-xx est créée, à partir de laquelle un instantané versionné du manuel est maintenu et déployé comme décrit ci-dessus.
Les anciennes versions de la documentation sont mises hors ligne de temps à autre et sont archivées au format EPUB et PDF sous forme de versions sur GitHub :
Entre la version 4.8 et la version 5.6, aucun instantané n’est disponible car la gestion des versions du manuel avait été suspendue pendant cette période.