Розробка та розгортання
Документація Darktable зберігається в репозиторії dtdocs. Зміни вносяться через пул-реквести (див. робочий процес). Переклади підтримуються через Weblate; див. переклади.
🔗Збірка
Повний набір виводів (сайт у форматі HTML, EPUB та PDF-файли для кожної мови) створюється за допомогою ./tools/build-all.sh <базова_адреса>
Це генерує перекладений контент з PO-файлів, потім створює HTML-сайт, EPUB та один PDF-файл для кожної увімкненої мови. Вихідні дані записуються в теку public/, а PDF-файли — у public/<мова>/darktable_user_manual.pdf.
Вимоги: Hugo (розширений), weasyprint та po4a для кроку перекладу.
🔗Розгортання на GitHub Pages (для розробки)
For development purposes, the docs are deployed to GitHub Pages on every push: A GitHub Action runs tools/build-all.sh, which generates HTML, EPUB and PDF outputs. These are committed to the repository’s gh-pages branch and served via GitHub Pages at https://darktable-org.github.io/dtdocs/. Generation of translated pages is disabled in the GitHub pages deployment.
🔗Офіційне розгортання на darktable.org
Офіційним місцем розташування документації є серверна інфраструктура pixls.us за адресою https://docs.darktable.org/usermanual/development/. Там регулярно витягується репозиторій і створюється документація, включаючи переклади, а також виводи у форматах EPUB та PDF.
🔗Версіонування документації
Up to 4.6 versioned copies of the docs were maintained (e.g. …/usermanual/4.6/). From there on only one version documenting the current development version is maintained (…/usermanual/development/). Links to the released versions following 4.6 are linked to the development version (e.g. …/usermanual/5.4/ links to …/usermanual/development/).