Розробка та розгортання
Документація 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 (для розробки)
Для цілей розробки документація розгортається на сторінках GitHub при кожному push: GitHub Action запускає tools/build-all.sh, яка генерує виводи HTML, EPUB та PDF. Вони зберігаються у гілці репозиторію gh-pages та обслуговуються через GitHub Pages за адресою https://darktable-org.github.io/dtdocs/. Генерація перекладених сторінок вимкнена в розгортанні GitHub Pages.
🔗Офіційне розгортання на darktable.org
Офіційним місцем розташування документації є серверна інфраструктура pixls.us за адресою https://docs.darktable.org/usermanual/development/. Там регулярно витягується репозиторій і створюється документація, включаючи переклади, а також виводи у форматах EPUB та PDF.
🔗Версіонування документації
До версії 4.6 підтримувались версіоновані копії документації (наприклад, …/usermanual/4.6/). З цього моменту підтримується лише одна версія, що документує поточну версію розробки (…/usermanual/development/). Посилання на випущені після 4.6 версії скеровуються на версію розробки (наприклад, …/usermanual/5.4/ посилається на …/usermanual/development/).