Rang teagaisc¶

Téann an leathanach seo ó chomhadlann fholamh go clár a bheannaíonn i Seapáinis. Cúig chéim, ní ghlactar le haon taithí ar gettext, agus taispeántar gach ordú leis an aschur a chruthaíonn sé i ndáiríre — ionas go mbeidh a fhios agat ag gach céim an bhfuil tú ar an mbóthar ceart.

Teastaíonn Python 3.14 nó níos nuaí uait, mar gur comhréir nua i 3.14 iad na t-strings. Is í an tSeapáinis sprioc shamplach an leathanaigh seo, ach níl aon rud ag brath ar an rogha sin. Chun teanga eile a úsáid, cuir rud éigin in ionad ja i gcéim 4 — níl ach an cód logánaithe sin á hainmniú.

1. Suiteáil¶

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

Tugann an breiseán [babel] isteach Babel, an uirlis a bhailíonn do chuid teachtaireachtaí i gcomhaid chatalóige i gcéim 3. Uirlis ama forbartha atá inti: rindreáileann cód táirgthe leis an leabharlann chaighdeánach amháin.

2. Marcáil teachtaireacht i do chód¶

Cruthaigh app.py:

from gettext_tstrings import tr

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

Tá cuma f-string ar t"Hello {name}", ach coinníonn an réimír t an téacs agus an luach scartha óna chéile in ionad iad a chumasc láithreach. Is í an deighilt sin a ligeann do tr() aistriúchán a lorg don abairt iomlán Hello {name} agus an luach a chur isteach ina dhiaidh sin.

Rith anois é:

$ python app.py
Hello Ada

Níl aon aistriúchán suiteáilte fós, mar sin rindreáiltear an téacs foinseach mar atá. Ní theastaíonn catalóg riamh ó chlár a úsáideann an leabharlann seo chun rith — is é an Béarla (nó cibé teanga fhoinseach atá agat) an cúltaca ionsuite.

3. Eastósc na teachtaireachtaí¶

Is gnách go n-oibríonn aistritheoirí ó chatalóga seachas ón gcód foinseach, mar sin taistealaíonn comhad beag ar a dtugtar catalóg idir tú féin agus iad. Is é an chéad chéim i dtreo catalóige gach teachtaireacht mharcáilte a bhailiú amach as an gcód.

Inis do Babel conas do chuid teachtaireachtaí a aimsiú trí babel.cfg a chruthú:

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

Ansin eastósc iad go comhad teimpléid (.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

Tá iontráil amháin in aghaidh na teachtaireachta i locales/messages.pot anois:

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

Is é msgid an eochair a lorgóidh do chód. Is san msgstr folamh a théann aistriúchán — ach ní sa chomhad seo: teimpléad is ea .pot, agus déanann an chéad chéim eile cóip de uair amháin in aghaidh na teanga.

4. Aistrigh agus tiomsaigh¶

Cruthaigh an chatalóg Sheapáinise ón teimpléad:

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

Oscail locales/ja/LC_MESSAGES/messages.po agus líon isteach an msgstr:

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

Coinnigh {name} díreach mar atá sé — is tríd an sealbhóir ionaid a aimsíonn an luach a áit laistigh den abairt aistrithe, agus tá cead ag an aistriúchán é a bhogadh cibé áit a theastaíonn ón sprioctheanga. I bhfíorthionscadal, is é an comhad .po seo a shíneann tú chuig aistritheoir nó a uaslódálann tú chuig ardán aistriúcháin; is í an fhormáid chéanna í ar aon chuma.

Cuirtear catalóga in eagar mar théacs ach luchtaítear i bhfoirm dhénártha (.mo) iad, mar sin tiomsaigh:

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

Is líontán sábhála an t-ordú seo freisin. Dá mbeadh an sealbhóir ionaid millte ag an aistriúchán — {nome} in ionad {name}, cuir i gcás — dhiúltódh sé é a ligean tríd:

$ 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.

Rabhadh amháin is fiú a bheith ar eolas anois: tuairiscíonn sé an earráid agus scoireann sé le stádas neamhnialasach, ach scríobhann sé an .mo mar sin féin. Ar fhíorthionscadal is é CI a chaithfidh stopadh ar an stádas scoir sin — socraíonn I dtáirgeadh é sin.

5. Rith é¶

Bhain céimeanna 2–4 úsáid as tr(), a lorgaíonn catalóg agus nach bhfaigheann ceann ar bith. Anois agus ceann ann, luchtaigh é agus ceangail uair amháin é: coinníonn Translator catalóg ionas nach gá do na láithreáin ghlaonna í a ainmniú, agus is é _ an gnáthainm gettext ar an toradh.

Dírigh app.py ar an gcatalóg thiomsaithe. Cliceáil na marcóirí le feiceáil cad tá ar siúl ag gach líne:

import gettext

from gettext_tstrings import Translator

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

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

1. Luchtaíonn an leabharlann chaighdeánach an .mo tiomsaithe, agus ceanglaíonn Translator le hoibiacht inghairthe é. Is é _ an gnáthainm gettext ar "aistrigh é seo" — gairid mar go bhfeictear ar gach teaghrán a fheiceann an t-úsáideoir é. Déanann sé an t-aistriúchán céanna le tr, ceangailte le catalóg amháin.
2. Ag an nglao: éiríonn téacs an t-string ina eochair chuardaigh Hello {name}, freagraíonn an chatalóg le こんにちは {name}, seiceáiltear an freagra i gcoinne sealbhóirí ionaid na foinse, agus ansin amháin a chuirtear an luach isteach.

$ python app.py
こんにちは Ada

Sin an lúb ar fad, agus is fiú í a fheiceáil mar phictiúr amháin:

flowchart LR
  mark["1–2 marcáil<br>t-strings sa chód"] --> extract["3 eastósc<br>messages.pot"]
  extract --> translate["4 aistrigh<br>ja/…/messages.po"]
  translate --> compile["4 tiomsaigh<br>ja/…/messages.mo"]
  compile --> run["5 rith<br>こんにちは Ada"]

Marcáil → eastósc → aistrigh → tiomsaigh → rith. Níl i ngach rud eile ar an suíomh seo ach mionchoigeartú ar cheann de na cúig chéim sin.

Cá háit anois¶

• Cén fáth t-strings — cad uaidh a chosnaíonn an dearadh seo tú, i gcomparáid le %(name)s, .format() agus $-strings.
• Treoir — iolraí, teangacha in aghaidh an iarratais, teaghráin iarchurtha, agus a tharlaíonn ag am rite nuair a bhíonn catalóg mícheart mar sin féin.
• I dtáirgeadh — an lúb chéanna seo mar a ritheann foireann í, seachtain i ndiaidh seachtaine: catalóga a nuashonrú, geataí CI, agus ardáin aistriúcháin.
• Eastóscadh — an tagairt iomlán do pybabel: ainmneacha feidhme saincheaptha, mód dian CI, agus na seiceálacha a chosnaíonn do chatalóga.
• Aistriú anonn — má tá catalóga gettext cheana féin ag an tionscadal ar mhaith leat é seo a dhéanamh ann i ndáiríre.
• D'aistritheoirí — an leathanach amháin le tabhairt do cibé duine a líonann isteach na línte msgstr sin.