ການແປເອກະສານໂດຍໃຊ້ Sphinx

Sphinx ເປັນເຄື່ອງມືສຳລັບການສ້າງເອກະສານທີ່ສວຍງາມ. ມັນໃຊ້ Syntax reStructuredText ງ່າຍໆ ແລະ ສາມາດສ້າງຜົນລັດຖະໃນຫຼາຍຮູບແບບ. ຖ້າເຈົ້າກຳລັງຊອກຫາຕົວຢ່າງ, ເອກະສານນີ້ກໍຖືກສ້າງຂຶ້ນໂດຍໃຊ້ມັນຄືກັນ. ຄູ່ຮ່ວມທີ່ເປັນປະໂຫຍດຫຼາຍສຳລັບການໃຊ້ Sphinx ຄືບໍລິການ Read the Docs, ເຊິ່ງຈະສ້າງ ແລະ ເຜີຍແຜ່ເອກະສານຂອງເຈົ້າຟຣີ.

ຂ້ອຍຈະບໍ່ເນັ້ນໃສ່ການຂຽນເອກະສານເອງ, ຖ້າເຈົ້າຕ້ອງການຄຳແນະນຳໃນເລື່ອງນັ້ນ, ພຽງແຕ່ປະຕິບັດຕາມຄຳແນະນຳໃນເວັບໄຊ Sphinx. ເມື່ອເຈົ້າມີເອກະສານພ້ອມແລ້ວ, ການແປມັນກໍຂ້ອນຂ້າງງ່າຍ ເພາະ Sphinx ມາພ້ອມກັບການຮອງຮັບສິ່ງນີ້ ແລະ ມັນໄດ້ຖືກກວມເອົາຢ່າງດີໃນ Internationalization ຂອງພວກເຂົາ. ມັນເປັນພຽງເລື່ອງຂອງ Directive ການຕັ້ງຄ່າສອງສາມຢ່າງ ແລະ ການເອີ້ນໃຊ້ເຄື່ອງມື sphinx-intl.

ຖ້າເຈົ້າກຳລັງໃຊ້ບໍລິການ Read the Docs, ເຈົ້າສາມາດເລີ່ມສ້າງເອກະສານທີ່ແປແລ້ວໃນ Read the Docs. Localization and Internationalization ຂອງພວກເຂົາກວມເອົາທຸກສິ່ງທີ່ເຈົ້າຕ້ອງການ - ການສ້າງໂຄງການອື່ນ, ການຕັ້ງຄ່າພາສາຂອງມັນ, ແລະ ການເຊື່ອມໂຍງມັນຈາກໂຄງການຫຼັກເປັນການແປ.

ຕອນນີ້ສິ່ງທີ່ເຈົ້າຕ້ອງການຄືການແປເນື້ອຫາເອກະສານ. Sphinx ສ້າງໄຟລ໌ PO ສຳລັບແຕ່ລະ Directory ຫຼື ໄຟລ໌ລະດັບສູງສຸດ, ເຊິ່ງອາດນຳໄປສູ່ການມີໄຟລ໌ຫຼາຍຢ່າງທີ່ຕ້ອງແປ (ຂຶ້ນກັບການຕັ້ງຄ່າ gettext_compact). ເຈົ້າສາມາດນຳເຂົ້າ index.po ເຂົ້າໄປໃນ Weblate ເປັນ Component ເບື້ອງຕົ້ນ ແລະ ຈາກນັ້ນຕັ້ງຄ່າ Add-on ການຄົ້ນຫາສ່ວນປະກອບ ເພື່ອຄົ້ນພົບອັນອື່ນໆທັງໝົດໂດຍອັດຕະໂນມັດ.

ການຕັ້ງຄ່າ Component

ຊື່ຄອມໂພເນນ

Documentation

ໜ້າກາກໄຟລ໌

docs/locales/*/LC_MESSAGES/index.po

ແມ່ແບບສຳລັບການແປໃໝ່

docs/locales/index.pot

ຮູບແບບໄຟລ໌

gettext PO file

ແຟລັກການແປ

rst-text
ການຕັ້ງຄ່າການຄົ້ນພົບ Component

Regular expression ສຳລັບໃຊ້ຈັບຄູ່ກັບໄຟລ໌ການແປ

docs/locales/(?P<language>[^/.]*)/LC_MESSAGES/(?P<component>[^/]*)\.po

ປັບແຕ່ງຊື່ສ່ວນປະກອບ

Documentation: {{ component|title }}

ກຳນົດໄຟລ໌ພື້ນຖານສຳລັບການແປໃໝ່

docs/locales/{{ component }}.pot

Hint

ເຈົ້າຕ້ອງການໃຫ້ Sphinx ສ້າງໄຟລ໌ PO ດຽວບໍ? ຕັ້ງແຕ່ Sphinx 3.3.0 ເປັນຕົ້ນໄປ ເຈົ້າສາມາດເຮັດສິ່ງນີ້ໄດ້ໂດຍໃຊ້:

gettext_compact = "docs"

ເຈົ້າສາມາດພົບເຫັນໂຄງການເອກະສານຫຼາຍໂຄງການທີ່ກຳລັງຖືກແປໂດຍໃຊ້ວິທີນີ້: