ການພັດທະນາ ແລະ ການນຳໃຊ້

ເອກະສານຂອງ darktable ແມ່ນຖືກເກັບຮັກສາໄວ້ໃນ ຄັງເກັບ dtdocs. ການປ່ຽນແປງຕ່າງໆແມ່ນເຮັດຜ່ານ pull requests (ເບິ່ງ workflow). ສ່ວນການແປພາສາແມ່ນຈັດການຜ່ານ weblate; ເບິ່ງ translations.

🔗ການສ້າງ (Building)

ຊຸດຜົນໄດ້ຮັບທັງໝົດ (ເວັບໄຊ HTML, EPUB, ແລະ PDF ແຕ່ລະພາສາ) ແມ່ນຖືກສ້າງຂຶ້ນໂດຍ ./tools/build-all.sh <base_url>

ສິ່ງນີ້ຈະສ້າງເນື້ອຫາທີ່ແປແລ້ວຈາກໄຟລ໌ PO, ຈາກນັ້ນກໍສ້າງເວັບໄຊ HTML, EPUB, ແລະ PDF ຫນຶ່ງໄຟລ໌ຕໍ່ພາສາທີ່ເປີດໃຊ້. ຜົນໄດ້ຮັບຈະຖືກບັນທຶກ ໄວ້ພາຍໃຕ້ public/, ໂດຍ PDF ຈະຢູ່ທີ່ public/<lang>/darktable_user_manual.pdf.

ຄວາມຕ້ອງການ: Hugo (ຮຸ່ນ extended), weasyprint, ແລະ po4a ສຳລັບ ຂັ້ນຕອນການແປ.

🔗ການນຳໃຊ້ GitHub Pages (ສຳລັບການພັດທະນາ)

ເພື່ອຈຸດປະສົງໃນການພັດທະນາ, ເອກະສານຈະຖືກນຳໃຊ້ໃນ GitHub Pages ທຸກຄັ້ງທີ່ມີການ push: GitHub Action ຈະລັນ tools/build-all.sh ເພື່ອສ້າງ HTML, EPUB ແລະ PDF. ສິ່ງເຫຼົ່ານີ້ຈະຖືກ commit ໄປທີ່ branch gh-pages ຂອງຄັງເກັບ ແລະ ເຜີຍແຜ່ຜ່ານ GitHub Pages ທີ່ https://darktable-org.github.io/dtdocs/. ການສ້າງໜ້າເວັບທີ່ແປພາສາແມ່ນຖືກປິດໄວ້ໃນການນຳໃຊ້ຜ່ານ GitHub pages.

🔗ການນຳໃຊ້ຢ່າງເປັນທາງການໃນ darktable.org

ທີ່ຢູ່ຫຼັກຢ່າງເປັນທາງການຂອງເອກະສານແມ່ນໂຄງສ້າງພື້ນຖານເຊີເວີ pixls.us ທີ່ https://docs.darktable.org/usermanual/development/. ຢູ່ທີ່ນັ້ນ, ຄັງເກັບຈະຖືກ pull ເປັນປະຈຳ ແລະ ເອກະສານຈະຖືກສ້າງດ້ວຍ Hugo, ລວມທັງການແປພາສາ, EPUB ແລະ PDF. ສາມາດເບິ່ງບັນທຶກການສ້າງ (build log) ໄດ້ ທີ່ນີ້.

🔗ການກຳນົດຮຸ່ນຂອງເອກະສານ

ຈົນຮອດຮຸ່ນ 4.6, ເອກະສານແຍກຕາມຮຸ່ນແມ່ນໄດ້ຖືກເກັບຮັກສາໄວ້ (ເຊັ່ນ …/usermanual/4.6/). ຫຼັງຈາກນັ້ນ, ຈະມີພຽງແຕ່ຮຸ່ນດຽວທີ່ບັນທຶກຮຸ່ນກຳລັງພັດທະນາປັດຈຸບັນເທົ່ານັ້ນ (…/usermanual/development/). ລິ້ງສຳລັບຮຸ່ນທີ່ເຜີຍແຜ່ຫຼັງຈາກ 4.6 ຈະຖືກເຊື່ອມຕໍ່ໄປຫາຮຸ່ນພັດທະນາ (ເຊັ່ນ …/usermanual/5.4/ ຈະລິ້ງໄປຫາ …/usermanual/development/).