Documenti / Traduci / gettext .po
Traduci file .po gettext
Compila le voci vuote e fuzzy nei file .po di Django, WordPress, PHP e Python, con slot msgstr[n] da Plural-Forms di ciascuna lingua e msgctxt e commenti del traduttore come contesto.
Come funziona
In gettext ogni file .po di una lingua contiene la propria copia del testo sorgente, quindi localize-dev translate tratta ogni file come un catalogo: riempie le voci il cui msgstr è vuoto o contrassegnato come fuzzy e lascia invariate quelle tradotte. Le voci obsolete #~ vengono saltate.
I commenti del traduttore (#.) e msgctxt vanno al modello come contesto, quindi "Archivio" su un pulsante viene tradotto come verbo. Una nuova lingua (--locales pl) ottiene il proprio file accanto a uno esistente, con l'intestazione Language e Plural-Forms. Compila come al solito in seguito: python manage.py compilemessages per Django, msgfmt altrove.
Prima e dopo
Output effettivo di localize-dev translate --locales de,pl sul primo file. Il file tedesco conteneva due voci vuote e una fuzzy. Con --locales de,pl sono state riempite e il file polacco sottostante è stato creato con tre slot per il plurale.
msgid ""
msgstr ""
"Language: de\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
#. Heading on the account page
msgid "Your account"
msgstr ""
#, fuzzy
msgid "Signed in as %(email)s"
msgstr "Angemeldet als"
msgctxt "verb, on a button"
msgid "Archive"
msgstr ""
msgid "%(count)s file uploaded"
msgid_plural "%(count)s files uploaded"
msgstr[0] ""
msgstr[1] ""msgid ""
msgstr ""
"Language: pl\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);\n"
#. Heading on the account page
msgid "Your account"
msgstr "Twoje konto"
msgid "Signed in as %(email)s"
msgstr "Zalogowano jako %(email)s"
msgctxt "verb, on a button"
msgid "Archive"
msgstr "Archiwizuj"
msgid "%(count)s file uploaded"
msgid_plural "%(count)s files uploaded"
msgstr[0] "%(count)s plik przesłany"
msgstr[1] "%(count)s pliki przesłane"
msgstr[2] "%(count)s plików przesłanych"Cosa rimane intatto
- Segnaposto
%(name)s,{name}e printf, controllati - Un
msgstr[n]per slot di Plural-Forms della lingua: 3 per il polacco, 6 per l'arabo - L'intestazione, i commenti del traduttore e l'ordine delle voci
msgctxt, quindi lo stesso msgid può essere tradotto in modo diverso a seconda del contesto
Errori comuni e come vengono evitati
Voci sfocate lasciate indietro
gettext salta le voci sfocate durante la compilazione, quindi una traduzione obsoleta torna silenziosamente al testo di origine. Le voci sfocate vengono ritradotte e il flag viene cancellato.
Il numero errato di slot plurali
Un file copiato dal tedesco ha due slot msgstr[n]; il polacco ne necessita tre. Il Plural-Forms del nuovo file è impostato per la sua lingua e ogni slot riceve la forma per i numeri che vi rientrano.
Segnaposto riordinati
I segnaposto senza nome %s hanno un significato in base alla loro posizione. Una traduzione che li riordina viene rifiutata. Quelli nominati come %(email)s possono spostarsi ovunque la frase ne abbia bisogno.
Esegui
Nella cartella che contiene i file di localizzazione. Le lingue senza un file ne ottengono uno. --dry-run mostra cosa cambierebbe per primo.
npx localize-dev login
# Preview, then write the missing translations
npx localize-dev translate --dry-run -l es,fr,de
npx localize-dev translate -l es,fr,deQuindi tienilo completo in CI. Non richiede alcuna chiave API e fallisce quando a una lingua mancano le traduzioni:
npx localize-dev check --only translationsGratuito per 1000 stringhe al mese. Una stringa conta una volta, indipendentemente da quante lingue includa. Crea un account gratuito
Guide per le app che utilizzano questo formato
Quando il testo è ancora hardcoded nel tuo codice, localize-dev run lo sposta prima in questo formato.