<a id="gettext"></a>

# GNU gettext PO (Portable Object)

<a id="index-0"></a>

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

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

#### SEE ALSO
* [ການແປຊອບແວໂດຍໃຊ້ GNU gettext](https://docs.weblate.org/lo/latest/devel/gettext.md)
* [ການແປເອກະສານໂດຍໃຊ້ Sphinx](https://docs.weblate.org/lo/latest/devel/sphinx.md)
* [Gettext ໃນ Wikipedia](https://en.wikipedia.org/wiki/Gettext)
* [PO Files](https://docs.translatehouse.org/projects/translate-toolkit/en/latest/formats/po.html)
* [ອັບເດດຕົວປ່ຽນ ALL_LINGUAS ໃນໄຟລ໌ "configure"](https://docs.weblate.org/lo/latest/admin/addons.md#addon-weblate-gettext-configure)
* [ປັບແຕ່ງການສະແດງຜົນ gettext](https://docs.weblate.org/lo/latest/admin/addons.md#addon-weblate-gettext-customize)
* [ອັບເດດໄຟລ໌ LINGUAS](https://docs.weblate.org/lo/latest/admin/addons.md#addon-weblate-gettext-linguas)
* [ສ້າງໄຟລ໌ MO](https://docs.weblate.org/lo/latest/admin/addons.md#addon-weblate-gettext-mo)
* [ອັບເດດໄຟລ໌ PO ໃຫ້ກົງກັບ POT (msgmerge)](https://docs.weblate.org/lo/latest/admin/addons.md#addon-weblate-gettext-msgmerge)

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

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

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

ສິ່ງນີ້ຖືກຄວບຄຸມໂດຍພາຣາມິເຕີ `po_keep_previous` [ພາລາມິເຕີຮູບແບບໄຟລ໌](https://docs.weblate.org/lo/latest/formats.md#file-format-params). ມັນບໍ່ມີຜົນຕໍ່ກັບລາຍການທີ່ລ້າສະໄໝ (obsolete) ເຊິ່ງໝາຍດ້ວຍ `#~`.

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

**msgmerge** ຈະເກັບຂໍ້ຄວາມທີ່ຖືກລຶບອອກຈາກໄຟລ໌ POT ໄວ້ເປັນລາຍການ `#~` ທີ່ລ້າສະໄໝໂດຍຄ່າເລີ່ມຕົ້ນ. ໃຫ້ເປີດໃຊ້ພາຣາມິເຕີ `po_remove_obsolete` [ພາລາມິເຕີຮູບແບບໄຟລ໌](https://docs.weblate.org/lo/latest/formats.md#file-format-params) ເພື່ອລຶບລາຍການທີ່ລ້າສະໄໝອອກເມື່ອ Weblate ບັນທຶກໄຟລ໌ PO.

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

ສ່ວນຫົວຂອງໄຟລ໌ PO ຈະຖືກເບິ່ງແຍງໂດຍ Weblate ໂດຍອັດຕະໂນມັດ. ມັນສາມາດຖືກຕັ້ງຄ່າເພື່ອລວມເອົາສ່ວນຫົວ `Language-Team`, `Last-Translator`, `X-Generator` ແລະ `Report-Msgid-Bugs-To` ໂດຍໃຊ້ [ພາລາມິເຕີຮູບແບບໄຟລ໌](https://docs.weblate.org/lo/latest/formats.md#file-format-params).

<a id="gettext-contributor-comments"></a>

### Contributor comments

Use the `po_contributor_comments` [ພາລາມິເຕີຮູບແບບໄຟລ໌](https://docs.weblate.org/lo/latest/formats.md#file-format-params) 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:

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

With `spdx`, the same entry becomes:

```po
# 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`, ເບິ່ງ [ພາລາມິເຕີຮູບແບບໄຟລ໌](https://docs.weblate.org/lo/latest/formats.md#file-format-params).

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

ໃນກໍລະນີທີ່ໄຟລ໌ MO ຖືກເກັບໄວ້ໃນ Repository ຮ່ວມກັບໄຟລ໌ PO, ສາມາດໃຊ້ [ສ້າງໄຟລ໌ MO](https://docs.weblate.org/lo/latest/admin/addons.md#addon-weblate-gettext-mo) ເພື່ອເຮັດໃຫ້ໄຟລ໌ເຫຼົ່ານັ້ນເປັນປັດຈຸບັນກັບໄຟລ໌ PO.

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

ສາມາດໃຊ້ [ອັບເດດໄຟລ໌ PO ໃຫ້ກົງກັບ POT (msgmerge)](https://docs.weblate.org/lo/latest/admin/addons.md#addon-weblate-gettext-msgmerge) ເພື່ອອັບເດດໄຟລ໌ PO ຈາກໄຟລ໌ POT, ເບິ່ງ [ການອັບເດດໄຟລ໌ພາສາເປົ້າໝາຍ](https://docs.weblate.org/lo/latest/devel/integration.md#updating-target-files).

<a id="mono-gettext"></a>

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

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

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

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

```po
#: 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) ໂດຍປົກກະຕິຈະມີລັກສະນະດັ່ງນີ້:

```po
#: 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ý"
```

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

```po
#: 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"
```

<!-- AUTOGENERATED START: format-features po-mono -->
<!-- This section is automatically generated by `./manage.py list_format_features`. Do not edit manually. -->

#### ຄຸນສົມບັດທີ່ຮອງຮັບ

| ນາມສະກຸນໄຟລ໌                                                                                    | `.po`, `.pot`   |
|-------------------------------------------------------------------------------------------------|-----------------|
| ຈຳນວນພາສາ [ⓘ](https://docs.weblate.org/lo/latest/formats.md#bimono)                               | ພາສາດຽວ         |
| ຮອງຮັບພະຫູພົດ [ⓘ](https://docs.weblate.org/lo/latest/formats.md#format-plurals)                   | `Yes`           |
| ຮອງຮັບຄຳອະທິບາຍ [ⓘ](https://docs.weblate.org/lo/latest/formats.md#format-description)             | `Yes`           |
| ຮອງຮັບຄຳຊີ້ແຈງ [ⓘ](https://docs.weblate.org/lo/latest/formats.md#format-explanation)              | `No`            |
| ຮອງຮັບບໍລິບົດ (context) [ⓘ](https://docs.weblate.org/lo/latest/formats.md#format-context)         | `Yes`           |
| ຮອງຮັບຕຳແໜ່ງ [ⓘ](https://docs.weblate.org/lo/latest/formats.md#format-location)                   | `Yes`           |
| ຮອງຮັບທຸງ (flags) [ⓘ](https://docs.weblate.org/lo/latest/formats.md#format-flags)                 | `Yes`           |
| ສະຖານະເພີ່ມເຕີມ [ⓘ](https://docs.weblate.org/lo/latest/formats.md#format-states)                  | `Needs editing` |
| ຕົວລະບຸ API                                                                                     | `po-mono`       |
| ຮອງຮັບຂໍ້ຄວາມແບບອ່ານຢ່າງດຽວ [ⓘ](https://docs.weblate.org/lo/latest/formats.md#read-only-strings)  | `No`            |
| ຮອງຮັບການລຶບຂໍ້ຄວາມທີ່ລ້າສະໄໝ [ⓘ](https://docs.weblate.org/lo/latest/formats.md#obsolete-strings) | `Yes`           |
<!-- AUTOGENERATED END: format-features po-mono -->
<!-- AUTOGENERATED START: format-features po -->
<!-- This section is automatically generated by `./manage.py list_format_features`. Do not edit manually. -->

#### ຄຸນສົມບັດທີ່ຮອງຮັບ

| ນາມສະກຸນໄຟລ໌                                                                                    | `.po`, `.pot`   |
|-------------------------------------------------------------------------------------------------|-----------------|
| ຈຳນວນພາສາ [ⓘ](https://docs.weblate.org/lo/latest/formats.md#bimono)                               | ສອງພາສາ         |
| ຮອງຮັບພະຫູພົດ [ⓘ](https://docs.weblate.org/lo/latest/formats.md#format-plurals)                   | `Yes`           |
| ຮອງຮັບຄຳອະທິບາຍ [ⓘ](https://docs.weblate.org/lo/latest/formats.md#format-description)             | `Yes`           |
| ຮອງຮັບຄຳຊີ້ແຈງ [ⓘ](https://docs.weblate.org/lo/latest/formats.md#format-explanation)              | `No`            |
| ຮອງຮັບບໍລິບົດ (context) [ⓘ](https://docs.weblate.org/lo/latest/formats.md#format-context)         | `Yes`           |
| ຮອງຮັບຕຳແໜ່ງ [ⓘ](https://docs.weblate.org/lo/latest/formats.md#format-location)                   | `Yes`           |
| ຮອງຮັບທຸງ (flags) [ⓘ](https://docs.weblate.org/lo/latest/formats.md#format-flags)                 | `Yes`           |
| ສະຖານະເພີ່ມເຕີມ [ⓘ](https://docs.weblate.org/lo/latest/formats.md#format-states)                  | `Needs editing` |
| ຕົວລະບຸ API                                                                                     | `po`            |
| ຮອງຮັບຂໍ້ຄວາມແບບອ່ານຢ່າງດຽວ [ⓘ](https://docs.weblate.org/lo/latest/formats.md#read-only-strings)  | `No`            |
| ຮອງຮັບການລຶບຂໍ້ຄວາມທີ່ລ້າສະໄໝ [ⓘ](https://docs.weblate.org/lo/latest/formats.md#obsolete-strings) | `Yes`           |
<!-- AUTOGENERATED END: format-features po -->

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

|                            | [ການຕັ້ງຄ່າ Component](https://docs.weblate.org/lo/latest/admin/projects.md#component) ຂອງ Weblate ໂດຍປົກກະຕິສຳລັບ gettext ແບບສອງພາສາ   |
|----------------------------|--------------------------------------------------------------------------------------------------------------------------------|
| ໜ້າກາກໄຟລ໌                 | `po/*.po`                                                                                                                      |
| ໄຟລ໌ພາສາຫຼັກ (Monolingual) | ຫວ່າງເປົ່າ                                                                                                                     |
| ແມ່ແບບສຳລັບການແປໃໝ່        | `po/messages.pot`                                                                                                              |
| ຮູບແບບໄຟລ໌                 | ໄຟລ໌ Gettext PO                                                                                                                |

|                            | [ການຕັ້ງຄ່າ Component](https://docs.weblate.org/lo/latest/admin/projects.md#component) ຂອງ Weblate ໂດຍປົກກະຕິສຳລັບ gettext ແບບພາສາດຽວ   |
|----------------------------|--------------------------------------------------------------------------------------------------------------------------------|
| ໜ້າກາກໄຟລ໌                 | `po/*.po`                                                                                                                      |
| ໄຟລ໌ພາສາຫຼັກ (Monolingual) | `po/en.po`                                                                                                                     |
| ແມ່ແບບສຳລັບການແປໃໝ່        | `po/messages.pot`                                                                                                              |
| ຮູບແບບໄຟລ໌                 | ໄຟລ໌ Gettext PO (ແບບພາສາດຽວ)                                                                                                   |

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

[ພາລາມິເຕີຮູບແບບໄຟລ໌](https://docs.weblate.org/lo/latest/formats.md#file-format-params) ທີ່ມີຮູບແບບ po_\* ສາມາດໃຊ້ເພື່ອຕັ້ງຄ່າພຶດຕິກຳຂອງຮູບແບບ gettext.
