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épôt officiel de la documentation est l’infrastructure du serveur pixls.us à https://docs.darktable.org/usermanual/development/. Là, le référentiel est extrait régulièrement 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.
🔗Versioning of the docs
Jusqu’à la version 4.6 des copies des versions des documents ont été conservées (par exemple …/usermanual/4.6/). À partir de là, une seule version documentant la version de développement actuelle est maintenue (…/usermanual/development/). Les liens vers les versions publiées après 4.6 sont liés à la version de développement (par exemple …/usermanual/5.4/ liens vers …/usermanual/development/).