GNU gettext PO (Objeto Portátil)

O formato mais usado para traduzir software livre.

As informações contextuais armazenadas no ficheiro são suportadas a ajustar os cabeçalhos dele ou a vincular-se a ficheiros fonte correspondentes.

A mostrar alteração na cadeia fonte

O Weblate pode extrair cadeias fonte anteriores dos ficheiros PO, se presentes, e mostrar a diferença de cadeias para cadeias que necessitam de edição com base nisso. Para incluí-las, msgmerge precisa ser executado com --previous e o ficheiro PO resultante então contém linhas como:

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

Isto é controlado pelo parâmetro po_keep_previous Parâmetros de formato de ficheiro. Isto não afeta entradas obsoletas marcadas com #~.

Cadeias obsoletas

msgmerge mantém cadeias de carateres obsoletas do ficheiro POT enquanto entradas obsoletas #~ por predefinição. Ative o parâmetro po_remove_obsolete Parâmetros de formato de ficheiro para remover entradas obsoletas quando o Weblate guarda ficheiros PO.

Cabeçalho de ficheiro PO

O cabeçalho do ficheiro PO é automaticamente mantido pelo Weblate. Pode ser configurado para incluir os cabeçalhos Language-Team, Last-Translator, X-Generator e Report-Msgid-Bugs-To usando Parâmetros de formato de ficheiro.

Os comentários do cabeçalho também podem ser atualizador para conter nomes de autor usando Colaboradores em comentários.

Quebra de linhas

A quebra de linha corresponde mais ao comportamento GNU gettext. Ambos o algoritmo de quebra e o GNU gettext e os dados Unicode na qual a quebra é baseada para evoluir podem causar diferenças em alguns casos particulares.

A largura de quebra pode ser configurada usando o parâmetro po_line_wrap, veja Parâmetros de formato de ficheiro.

Gerar ficheiros MO correspondentes

No caso de ficheiros MO serem mantidos no repositório em conjunto com ficheiros PO, Gerar ficheiros MO pode ser usado para mantê-los atualizados com ficheiros PO.

Atualizar ficheiros PO a partir do ficheiro POT

Atualizar ficheiros PO para coincidir com POT (msgmerge) podem ser usados para atualizar ficheiros PO a partir do ficheiro POT, veja Atualizando ficheiros de idioma de destino.

Gettext monolíngue

Alguns projetos decidem usar o gettext como formatos monolingues – eles codificam apenas os IDs no código-fonte deles e a cadeia então precisa ser traduzido para todos os idiomas, que inclui o inglês. É suportado, embora tenha que escolher este formato de ficheiro explicitamente ao importar componentes para o Weblate.

Ficheiro de exemplo

O ficheiro de PO de texto bilíngue normalmente parece-se com este:

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

O ficheiro gettext PO monolíngue normalmente se parece com este:

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

Enquanto o ficheiro de idioma base será:

#: 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"
Recursos suportados

Extensões de ficheiro

.po, .pot

Lingualidade ⓘ

Monolingue

Suporta plural ⓘ

Yes

Suporta descrições ⓘ

Yes

Suporta explicação ⓘ

No

Suporta contexto ⓘ

Yes

Suporta localização ⓘ

Yes

Suporta marcadores ⓘ

Yes

Estados adicionais ⓘ

Needs editing

Identificador API

po-mono

Suporta cadeias de carateres apenas de leitura ⓘ

No

Suporta a remoção de cadeias de careteres obsoletas ⓘ

Yes

Recursos suportados

Extensões de ficheiro

.po, .pot

Lingualidade ⓘ

Bilingue

Suporta plural ⓘ

Yes

Suporta descrições ⓘ

Yes

Suporta explicação ⓘ

No

Suporta contexto ⓘ

Yes

Suporta localização ⓘ

Yes

Suporta marcadores ⓘ

Yes

Estados adicionais ⓘ

Needs editing

Identificador API

po

Suporta cadeias de carateres apenas de leitura ⓘ

No

Suporta a remoção de cadeias de careteres obsoletas ⓘ

Yes

Configuração do Weblate

Configuração de componente típica do Weblate para gettext bilíngue

Máscara de ficheiros

po/*.po

Ficheiro de idioma base monolingue

Vazio

Modelo para novas traduções

po/messages.pot

Formato de ficheiro

Ficheiro Gettext PO

Configuração de componente típica do Weblate para gettext monolíngue

Máscara de ficheiros

po/*.po

Ficheiro de idioma base monolingue

po/en.po

Modelo para novas traduções

po/messages.pot

Formato de ficheiro

Ficheiro Gettext PO (monolíngue)

Parâmetros de formato de ficheiro

Parâmetros de formato de ficheiro com o padrão po_* podem ser usados para configurar o comportamento do formato gettext.