Kennsluefni¶

Þessi síða fer úr tómri möppu í forrit sem heilsar á japönsku. Fimm skref, engrar gettext-reynslu krafist, og hver skipun er sýnd með því úttaki sem hún skilar í raun — svo að í hverju skrefi veistu hvort þú ert á réttri leið.

Þú þarft Python 3.14 eða nýrri, því t-strengir eru ný málskipan í 3.14. Japanska er markmál dæmisins á þessari síðu, en ekkert veltur á því vali. Til að nota annað tungumál skaltu skipta ja út í skrefi 4 — sá staðfærslukóði er það eina sem nefnir það.

1. Uppsetning¶

python -m pip install "gettext-tstrings[babel]"

Aukapakkinn [babel] dregur inn Babel, tólið sem safnar skilaboðunum þínum í þýðingaskrár í skrefi 3. Það er tól þróunartímans: kóði í rekstri birtir texta með staðalsafninu einu saman.

2. Merktu skilaboð í kóðanum þínum¶

Búðu til app.py:

from gettext_tstrings import tr

name = "Ada"
print(tr(t"Hello {name}"))

t"Hello {name}" lítur út eins og f-strengur, en t-forskeytið heldur textanum og gildinu aðskildum í stað þess að steypa þeim saman á staðnum. Sá aðskilnaður er það sem gerir tr() kleift að fletta upp þýðingu á heilli setningunni Hello {name} og skjóta gildinu inn á eftir.

Keyrðu það núna:

$ python app.py
Hello Ada

Engar þýðingar eru uppsettar enn, svo frumtextinn birtist óbreyttur. Forrit sem notar þetta safn krefst aldrei þýðingaskrár til að keyra — enskan (eða hvert það mál sem frumtextinn þinn er á) er innbyggða vararleiðin.

3. Dragðu skilaboðin út¶

Þýðendur vinna yfirleitt út frá þýðingaskrám fremur en frumkóða, svo lítil skrá sem kallast þýðingaskrá ferðast milli ykkar. Fyrsta skrefið að slíkri skrá er að safna hverjum merktum skilaboðum út úr kóðanum.

Segðu Babel hvernig eigi að finna skilaboðin þín með því að búa til babel.cfg:

[gettext_tstrings: **.py]
encoding = utf-8

Dragðu svo út í sniðmátsskrá (.pot):

$ mkdir -p locales
$ pybabel extract -F babel.cfg -c "Translators:" -o locales/messages.pot .
extracting messages from app.py (encoding="utf-8")
writing PO template file to locales/messages.pot

locales/messages.pot inniheldur nú eina færslu fyrir hver skilaboð:

#. gettext-tstrings
#: app.py:4
#, python-brace-format
msgid "Hello {name}"
msgstr ""

msgid er lykillinn sem kóðinn þinn mun fletta upp. Tóma msgstr-ið er þar sem þýðingin á að fara — en ekki í þessari skrá: .pot er sniðmát, og næsta skref afritar það einu sinni fyrir hvert tungumál.

4. Þýddu og vistþýddu¶

Búðu til japönsku þýðingaskrána út frá sniðmátinu:

$ pybabel init -i locales/messages.pot -d locales -l ja
creating catalog locales/ja/LC_MESSAGES/messages.po based on locales/messages.pot

Opnaðu locales/ja/LC_MESSAGES/messages.po og fylltu út msgstr:

msgid "Hello {name}"
msgstr "こんにちは {name}"

Haltu {name} nákvæmlega eins og hann er — staðgengillinn er leiðin sem gildið finnur sér stað eftir inni í þýddu setningunni, og þýðingunni er frjálst að færa hann þangað sem markmálið þarf. Í raunverulegu verkefni er þessi .po-skrá það sem þú réttir þýðanda eða hleður upp á þýðingavettvang; sniðið er hið sama hvort heldur er.

Þýðingaskrár eru ritaðar sem texti en lesnar inn á tvíundarformi (.mo), svo vistþýddu:

$ pybabel compile -d locales
compiling catalog locales/ja/LC_MESSAGES/messages.po to locales/ja/LC_MESSAGES/messages.mo

Þessi skipun er líka öryggisnet. Hefði þýðingin skemmt staðgengilinn — {nome} í stað {name}, til dæmis — hefði hún neitað að hleypa henni í gegn:

$ pybabel compile -d locales
error: locales/ja/LC_MESSAGES/messages.po:24: translation does not match the
source placeholders: {name} is missing; {nome} is not in the source message
1 errors encountered.

Einn fyrirvari sem vert er að þekkja strax: það tilkynnir villuna og hættir með stöðu sem er ekki núll, en skrifar .mo-skrána samt sem áður. Í raunverulegu verkefni er það CI sem verður að stöðvast á þeirri stöðu — Í rekstri setur það upp.

5. Keyrðu það¶

Skref 2–4 notuðu tr(), sem leitar að þýðingaskrá og finnur enga. Nú þegar slík skrá er til skaltu lesa hana inn og binda hana einu sinni: Translator heldur utan um þýðingaskrá svo að köllunarstaðirnir þurfi ekki að nefna hana, og _ er hefðbundna gettext-heitið á niðurstöðunni.

Beindu app.py að vistþýddu þýðingaskránni. Smelltu á merkin til að sjá hvað hver lína er að gera:

import gettext

from gettext_tstrings import Translator

_ = Translator(gettext.translation("messages", localedir="locales", languages=["ja"]))  # (1)!

name = "Ada"
print(_(t"Hello {name}"))  # (2)!

1. Staðalsafnið les inn vistþýddu .mo-skrána og Translator bindur hana við kallanlegt fall. _ er venjubundna gettext-nafnið fyrir „þýddu þetta“ — stutt af því að það kemur fyrir við hvern einasta streng sem notandi sér. Það framkvæmir sömu þýðingu og tr, bundið einni þýðingaskrá.
2. Við kallið: texti t-strengsins verður uppflettilykillinn Hello {name}, þýðingaskráin svarar こんにちは {name}, svarið er borið saman við staðgengla frumtextans, og fyrst þá er gildinu skotið inn.

$ python app.py
こんにちは Ada

Þetta er öll hringrásin, og hún er þess virði að sjá í einni mynd:

flowchart LR
  mark["1–2 merkja<br>t-strengi í kóða"] --> extract["3 draga út<br>messages.pot"]
  extract --> translate["4 þýða<br>ja/…/messages.po"]
  translate --> compile["4 vistþýða<br>ja/…/messages.mo"]
  compile --> run["5 keyra<br>こんにちは Ada"]

Merkja → draga út → þýða → vistþýða → keyra. Allt annað á þessum vef er útfærsla á einhverju þessara fimm skrefa.

Hvert næst¶

• Hvers vegna t-strings — hverju þessi hönnun ver þig fyrir, borið saman við %(name)s, .format() og $-strengi.
• Handbók — fleirtala, tungumál eftir beiðni, frestaðir strengir, og hvað gerist á keyrslutíma þegar þýðingaskrá er engu að síður röng.
• Í rekstri — sama hringrás eins og teymi keyrir hana, viku eftir viku: að uppfæra þýðingaskrár, CI-hlið og þýðingavettvangar.
• Útdráttur — heildarheimildin um pybabel: eigin fallanöfn, strangur CI-hamur og athuganirnar sem gæta þýðingaskránna þinna.
• Yfirfærsla — ef verkefnið sem þú vilt í raun gera þetta í hefur nú þegar gettext-þýðingaskrár.
• Fyrir þýðendur — eina síðan til að rétta þeim sem fyllir út þessar msgstr-línur.