Entwicklung und Veröffentlichung
darktables Handbuch wird über das dtdocs Repository gepflegt. Änderungen werden über Pull Requests eingepflegt (siehe Arbeitsablauf). Übersetzungen werden über Weblate gepflegt. Siehe auch hier.
🔗Bauen
Der vollständige Output (HTML Seite, EPUB und PDFs) wird mit ./tools/build-all.sh <base_url> gebaut.
Dies generiert die übersetzten Dateien aus den PO-Dateien und dann anschließend die HTML-Seite, EPUB und ein PDF pro aktivierter Übersetzung. Die Ausgabe wird unter public/ abgelegt, die PDFs unter public/<lang>/darktable_user_manual.pdf.
Anforderungen: Hugo (extended), weasyprint, und po4a für die Übersetzungen.
🔗GitHub Pages Veröffentlichung (zu Entwicklungszwecken)
Für Entwicklungszwecke werden die Docs mit jedem Push auf GitHub Pages gebaut: Eine GitHub Aktion führt tools/build-all.sh aus, was , die HTML-, EPUB- und PDF-Ausgaben generiert. Diese werden in den Branch gh-pages committed und sind über GitHub Pages unter https://darktable-org.github.io/dtdocs/ verfügbar. Die Erstellung von übersetzten Seiten ist in der GitHub-Pages-Bereitstellung deaktiviert.
🔗Offizielle Veröffentlichung auf darktable.org
Die offizielle Heimat der Docs ist die pixls.us Server-Infrastruktur unter https://docs.darktable.org/usermanual/development/. Dort wird das Repository regelmäßig gezogen und die Dokumentation wird mit Hugo, einschließlich Übersetzungen sowie EPUB und PDF-Ausgaben, neu gebaut. Das Build-Log ist hier einsehbar.
🔗Versonierung der Dokumentation
Bis zur Version 4.6 wurden die Docs versioniert gepflegt (z.B. …/usermanual/4.6/). Seit dem wird nur noch die aktuelle Entwicklungsversion dokumentiert (…/usermanual/Entwicklung/). Die URLs zu den Docs für Versionen nach 4.6 sind mit der Entwicklungsversion verknüpft (z.B. …/usermanual/5.4/ verlinkt auf …/usermanual/development/).