Розробка та розгортання
Документація 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: за адресою docs.darktable.org/usermanual/stable/ — для поточного стабільного випуску, а за адресою docs.darktable.org/usermanual/development/ — для поточного стану розробки.
Репозиторії регулярно витягуються, а документація створюється за допомогою Hugo, включаючи переклади, а також виводи у форматах EPUB та PDF.
🔗Версіонування та архівування посібника
З кожним запланованим (щопіврічним) випуском Darktable створюється гілка release-x.x, на основі якої підтримується та розгортається версіонізований знімок посібника (як описано вище).
Старіші версії документації час від часу видаляються з доступу та архівуються у форматах EPUB і PDF як релізи на GitHub:
Для версій у діапазоні від 4.8 до 5.6 знімки відсутні, оскільки в цей період ведення версій посібника було призупинено.