GNU gettext PO (Portable Object)¶

ຮູບແບບທີ່ນິຍົມໃຊ້ຫຼາຍທີ່ສຸດສຳລັບການແປຊອບແວເສລີ.

ຂໍ້ມູນບໍລິບົດທີ່ເກັບໄວ້ໃນໄຟລ໌ ແມ່ນຮອງຮັບໂດຍການປັບແຕ່ງສ່ວນຫົວ ຫຼື ເຊື່ອມໂຍງກັບໄຟລ໌ຕົ້ນສະບັບທີ່ກ່ຽວຂ້ອງ.

ການສະແດງການປ່ຽນແປງຂອງຂໍ້ຄວາມຕົ້ນສະບັບ¶

Weblate ສາມາດສະກັດຂໍ້ຄວາມຕົ້ນສະບັບກ່ອນໜ້ານີ້ອອກຈາກໄຟລ໌ PO ໄດ້ ຖ້າມີ ແລະ ສະແດງຄວາມແຕກຕ່າງຂອງຂໍ້ຄວາມສຳລັບຂໍ້ຄວາມທີ່ຕ້ອງການແກ້ໄຂໂດຍອີງໃສ່ສິ່ງນັ້ນ. ເພື່ອລວມສິ່ງເຫຼົ່ານີ້, ຈະຕ້ອງປະຕິບັດ msgmerge ດ້ວຍ --previous ແລະ ໄຟລ໌ PO ທີ່ໄດ້ຜົນລັດຈະບັນຈຸແຖວຕ່າງໆ ເຊັ່ນ:

#, fuzzy
#| msgid "previous-untranslated-string"
msgid "untranslated-string"
msgstr "translated-string"

ສິ່ງນີ້ຖືກຄວບຄຸມໂດຍພາຣາມິເຕີ po_keep_previous ພາລາມິເຕີຮູບແບບໄຟລ໌. ມັນບໍ່ມີຜົນຕໍ່ກັບລາຍການທີ່ລ້າສະໄໝ (obsolete) ເຊິ່ງໝາຍດ້ວຍ #~.

ຂໍ້ຄວາມທີ່ລ້າສະໄໝ¶

msgmerge ຈະເກັບຂໍ້ຄວາມທີ່ຖືກລຶບອອກຈາກໄຟລ໌ POT ໄວ້ເປັນລາຍການ #~ ທີ່ລ້າສະໄໝໂດຍຄ່າເລີ່ມຕົ້ນ. ໃຫ້ເປີດໃຊ້ພາຣາມິເຕີ po_remove_obsolete ພາລາມິເຕີຮູບແບບໄຟລ໌ ເພື່ອລຶບລາຍການທີ່ລ້າສະໄໝອອກເມື່ອ Weblate ບັນທຶກໄຟລ໌ PO.

ສ່ວນຫົວໄຟລ໌ PO¶

ສ່ວນຫົວຂອງໄຟລ໌ PO ຈະຖືກເບິ່ງແຍງໂດຍ Weblate ໂດຍອັດຕະໂນມັດ. ມັນສາມາດຖືກຕັ້ງຄ່າເພື່ອລວມເອົາສ່ວນຫົວ Language-Team, Last-Translator, X-Generator ແລະ Report-Msgid-Bugs-To ໂດຍໃຊ້ ພາລາມິເຕີຮູບແບບໄຟລ໌.

Contributor comments¶

Use the po_contributor_comments ພາລາມິເຕີຮູບແບບໄຟລ໌ parameter to add contributor names and years to PO header comments. Choose gettext for traditional comments or spdx for SPDX copyright entries. The default, none, disables contributor updates without removing existing comments. This setting works independently of the Last-Translator header setting.

With gettext, contributor comments look like this:

# Jane Doe <jane@example.com>, 2024, 2026.

With spdx, the same entry becomes:

# SPDX-FileCopyrightText: 2024, 2026 Jane Doe <jane@example.com>

On the next commit by an eligible contributor, SPDX mode converts all recognized contributor comments, preserves historical contribution years, and adds the current year for that contributor. Anonymous Weblate authors are skipped. Unrelated comments and copyright notices are preserved. Weblate does not infer copyright claims from translated credit strings or add project-specific notices or license identifiers; handle these in custom tooling.

ການຕັດແຖວ¶

ການຕັດແຖວສ່ວນຫຼາຍຈະກົງກັບພຶດຕິກຳຂອງ GNU gettext. ທັງສູດການຕັດແຖວໃນ GNU gettext ແລະ ຂໍ້ມູນ Unicode ທີ່ການຕັດແຖວອີງໃສ່ ມີການພັດທະນາ ເຊິ່ງອາດເຮັດໃຫ້ເກີດຄວາມແຕກຕ່າງໃນບາງກໍລະນີພິເສດ.

ຄວາມກວ້າງໃນການຕັດແຖວສາມາດຕັ້ງຄ່າໄດ້ໂດຍໃຊ້ພາຣາມິເຕີ po_line_wrap, ເບິ່ງ ພາລາມິເຕີຮູບແບບໄຟລ໌.

ການສ້າງໄຟລ໌ MO ທີ່ກົງກັນ¶

ໃນກໍລະນີທີ່ໄຟລ໌ MO ຖືກເກັບໄວ້ໃນ Repository ຮ່ວມກັບໄຟລ໌ PO, ສາມາດໃຊ້ ສ້າງໄຟລ໌ MO ເພື່ອເຮັດໃຫ້ໄຟລ໌ເຫຼົ່ານັ້ນເປັນປັດຈຸບັນກັບໄຟລ໌ PO.

ການອັບເດດໄຟລ໌ PO ຈາກໄຟລ໌ POT¶

ສາມາດໃຊ້ ອັບເດດໄຟລ໌ PO ໃຫ້ກົງກັບ POT (msgmerge) ເພື່ອອັບເດດໄຟລ໌ PO ຈາກໄຟລ໌ POT, ເບິ່ງ ການອັບເດດໄຟລ໌ພາສາເປົ້າໝາຍ.

gettext ແບບພາສາດຽວ¶

ບາງໂຄງການຕັດສິນໃຈໃຊ້ gettext ເປັນຮູບແບບພາສາດຽວ—ພວກເຂົາຂຽນໂຄດພຽງແຕ່ ID ໄວ້ໃນ Source Code ແລະ ຂໍ້ຄວາມນັ້ນຈຶ່ງຕ້ອງຖືກແປເປັນທຸກພາສາ, ລວມທັງພາສາອັງກິດ. ສິ່ງນີ້ໄດ້ຮັບການຮອງຮັບ, ເຖິງຢ່າງໃດກໍຕາມ ທ່ານຕ້ອງເລືອກຮູບແບບໄຟລ໌ນີ້ຢ່າງຊັດເຈນໃນເວລາທີ່ນຳເຂົ້າ (import) Component ເຂົ້າສູ່ Weblate.

ໄຟລ໌ຕົວຢ່າງ¶

ໄຟລ໌ PO ຂອງ gettext ແບບສອງພາສາ (bilingual) ໂດຍປົກກະຕິຈະມີລັກສະນະດັ່ງນີ້:

#: weblate/media/js/bootstrap-datepicker.js:1421
msgid "Monday"
msgstr "Pondělí"

#: weblate/media/js/bootstrap-datepicker.js:1421
msgid "Tuesday"
msgstr "Úterý"

#: weblate/accounts/avatar.py:163
msgctxt "No known user"
msgid "None"
msgstr "Žádný"

ໄຟລ໌ PO ຂອງ gettext ແບບພາສາດຽວ (monolingual) ໂດຍປົກກະຕິຈະມີລັກສະນະດັ່ງນີ້:

#: weblate/media/js/bootstrap-datepicker.js:1421
msgid "day-monday"
msgstr "Pondělí"

#: weblate/media/js/bootstrap-datepicker.js:1421
msgid "day-tuesday"
msgstr "Úterý"

#: weblate/accounts/avatar.py:163
msgid "none-user"
msgstr "Žádný"

ໃນຂະນະທີ່ໄຟລ໌ພາສາພື້ນຖານຈະເປັນ:

#: weblate/media/js/bootstrap-datepicker.js:1421
msgid "day-monday"
msgstr "Monday"

#: weblate/media/js/bootstrap-datepicker.js:1421
msgid "day-tuesday"
msgstr "Tuesday"

#: weblate/accounts/avatar.py:163
msgid "none-user"
msgstr "None"

ຄຸນສົມບັດທີ່ຮອງຮັບ¶
ນາມສະກຸນໄຟລ໌	`.po`, `.pot`
ຈຳນວນພາສາ ⓘ	ພາສາດຽວ
ຮອງຮັບພະຫູພົດ ⓘ	`Yes`
ຮອງຮັບຄຳອະທິບາຍ ⓘ	`Yes`
ຮອງຮັບຄຳຊີ້ແຈງ ⓘ	`No`
ຮອງຮັບບໍລິບົດ (context) ⓘ	`Yes`
ຮອງຮັບຕຳແໜ່ງ ⓘ	`Yes`
ຮອງຮັບທຸງ (flags) ⓘ	`Yes`
ສະຖານະເພີ່ມເຕີມ ⓘ	`Needs editing`
ຕົວລະບຸ API	`po-mono`
ຮອງຮັບຂໍ້ຄວາມແບບອ່ານຢ່າງດຽວ ⓘ	`No`
ຮອງຮັບການລຶບຂໍ້ຄວາມທີ່ລ້າສະໄໝ ⓘ	`Yes`

ຄຸນສົມບັດທີ່ຮອງຮັບ¶
ນາມສະກຸນໄຟລ໌	`.po`, `.pot`
ຈຳນວນພາສາ ⓘ	ສອງພາສາ
ຮອງຮັບພະຫູພົດ ⓘ	`Yes`
ຮອງຮັບຄຳອະທິບາຍ ⓘ	`Yes`
ຮອງຮັບຄຳຊີ້ແຈງ ⓘ	`No`
ຮອງຮັບບໍລິບົດ (context) ⓘ	`Yes`
ຮອງຮັບຕຳແໜ່ງ ⓘ	`Yes`
ຮອງຮັບທຸງ (flags) ⓘ	`Yes`
ສະຖານະເພີ່ມເຕີມ ⓘ	`Needs editing`
ຕົວລະບຸ API	`po`
ຮອງຮັບຂໍ້ຄວາມແບບອ່ານຢ່າງດຽວ ⓘ	`No`
ຮອງຮັບການລຶບຂໍ້ຄວາມທີ່ລ້າສະໄໝ ⓘ	`Yes`

ການຕັ້ງຄ່າ Weblate¶

ການຕັ້ງຄ່າ Component ຂອງ Weblate ໂດຍປົກກະຕິສຳລັບ gettext ແບບສອງພາສາ
ໜ້າກາກໄຟລ໌	`po/*.po`
ໄຟລ໌ພາສາຫຼັກ (Monolingual)	ຫວ່າງເປົ່າ
ແມ່ແບບສຳລັບການແປໃໝ່	`po/messages.pot`
ຮູບແບບໄຟລ໌	ໄຟລ໌ Gettext PO

ການຕັ້ງຄ່າ Component ຂອງ Weblate ໂດຍປົກກະຕິສຳລັບ gettext ແບບພາສາດຽວ
ໜ້າກາກໄຟລ໌	`po/*.po`
ໄຟລ໌ພາສາຫຼັກ (Monolingual)	`po/en.po`
ແມ່ແບບສຳລັບການແປໃໝ່	`po/messages.pot`
ຮູບແບບໄຟລ໌	ໄຟລ໌ Gettext PO (ແບບພາສາດຽວ)

ພາລາມິເຕີຮູບແບບໄຟລ໌¶

ພາລາມິເຕີຮູບແບບໄຟລ໌ ທີ່ມີຮູບແບບ po_* ສາມາດໃຊ້ເພື່ອຕັ້ງຄ່າພຶດຕິກຳຂອງຮູບແບບ gettext.