Logánú leanúnach¶

Tá infrastruchtúr i bhfeidhm ionas go mbeidh d’aistriúchán ag leanúint go dlúth leis an bhforbairt. Ar an mbealach seo is féidir le haistritheoirí oibriú ar aistriúcháin an t-am ar fad, in ionad oibriú ar mhéid ollmhór téacs nua díreach roimh é a eisiúint.

See also

Déanann Comhtháthú le Weblate cur síos ar bhealaí bunúsacha chun d'fhorbairt a chomhtháthú le Weblate.

Seo é an próiseas:

Déanann forbróirí athruithe agus brú chuig an stór VCS iad.
De rogha air sin, déantar na comhaid aistriúcháin a nuashonrú, féach Teaghráin nua a thabhairt isteach.
Tarraingíonn Weblate athruithe ón stór VCS, parsálann sé comhaid aistriúcháin agus nuashonraíonn sé a bhunachar sonraí, féach Taisclanna á nuashonrú.
Cuireann aistritheoirí aistriúcháin isteach trí úsáid a bhaint as comhéadan gréasáin Weblate, nó uaslódálann siad athruithe as líne.
Nuair a bheidh na haistritheoirí críochnaithe, déanann Weblate na hathruithe ar an stóras áitiúil (féach Geallann leisciúil).
Brúitear athruithe ar ais go dtí an stór in aghaidh an tsrutha (féach Athruithe a bhrú ó Weblate).

Hint

Níl gá le hóstáil cód in aghaidh an tsrutha, is féidir leat Weblate a úsáid le Comhaid áitiúla áit nach bhfuil ach an stór taobh istigh de Weblate.

Taisclanna á nuashonrú¶

Ba cheart duit bealach éigin a shocrú chun stórtha inneall a nuashonrú óna bhfoinse.

Úsáid Crúcaí fógra chun comhtháthú leis an gcuid is mó de na seirbhísí óstála cóid coitianta:
Ní mór duit freisin Cumasaigh crúcaí le go n-oibreoidh sé seo.
Cuir tús le nuashonrú de láimh i mbainistíocht an taisclainne nó trí API REST Weblate nó Cliant Gréasáin a úsáid
Cumasaigh AUTO_UPDATE chun na comhpháirteanna go léir ar do shampla Weblate a nuashonrú go huathoibríoch
Rith updategit (le rogha an tionscadail nó --uile chun gach rud a nuashonrú)

Aon uair a nuashonraíonn Weblate an stór, cuirfear tús leis na breiseáin iar-nuashonraithe, féach Breiseáin.

Coinbhleachtaí cumaisc a sheachaint¶

Eascraíonn na coinbhleachtaí cumaisc ó Weblate nuair a athraíodh an comhad céanna in Weblate agus lasmuigh de. Ag brath ar an gcás, tá roinnt cur chuige a d’fhéadfadh cabhrú anseo:

Coinbhleachtaí cumaisc a sheachaint trí chomhaid aistriúcháin a athrú in Weblate amháin
Coinbhleachtaí cumaisc a sheachaint trí Weblate a ghlasáil agus athruithe seachtracha á ndéanamh
Coinbhleachtaí cumaisc a sheachaint trí dhíriú ar oibríochtaí Git

Coinbhleachtaí cumaisc a sheachaint trí chomhaid aistriúcháin a athrú in Weblate amháin¶

Tá sé éasca athruithe lasmuigh de Weblate a sheachaint le comhaid aonteangacha — is féidir leat teaghráin nua a chur leis laistigh de Weblate agus eagarthóireacht iomlán na gcomhad a fhágáil ann. Maidir le comhaid dhátheangacha, is gnách go mbíonn próiseas eastósctha teachtaireachtaí de chineál éigin ann chun comhaid inaistrithe a ghiniúint ón gcód foinseach. I gcásanna áirithe, is féidir é seo a roinnt ina dhá chuid:

Gineann an t-eastóscadh teimpléad (mar shampla gintear gettext POT le xgettext).
Cumascann próiseas breise é ina haistriúcháin iarbhír (Déantar na comhaid PO gettext a nuashonrú ag baint úsáide as msgmerge).

Is féidir leat an dara céim a dhéanamh laistigh de Weblate agus cinnteoidh sé go gcuirfear gach athrú ar feitheamh san áireamh roimh an oibríocht seo.

Coinbhleachtaí cumaisc a sheachaint trí Weblate a ghlasáil agus athruithe seachtracha á ndéanamh¶

Is féidir Weblate a chomhtháthú isteach i do phróiseas nuashonraithe ionas go sruthóidh sé athruithe sula nuashonraítear na comhaid lasmuigh de Weblate trí API REST Weblate a úsáid chun iallach a chur ar Weblate gach athrú atá ar feitheamh a bhrú agus an t-aistriúchán a ghlasáil agus tú ag déanamh athruithe ar do thaobh.

Is féidir breathnú mar seo a dhéanamh ar an script chun nuashonruithe a dhéanamh:

# Lock Weblate translation
wlc lock
# Push changes from Weblate to upstream repository
wlc push
# Pull changes from upstream repository to your local copy
git pull
# Update translation files, this example is for Django
./manage.py makemessages --keep-pot -a
git commit -m 'Locale updates' -- locale
# Push changes to upstream repository
git push
# Tell Weblate to pull changes (not needed if Weblate follows your repo
# automatically)
wlc pull
# Unlock translations
wlc unlock

Má tá comhpháirteanna iolracha agat ag roinnt an stór céanna, ní mór duit iad go léir a ghlasáil ar leithligh:

wlc lock foo/bar
wlc lock foo/baz
wlc lock foo/baj

Note

Úsáideann an sampla Cliant Gréasáin, a bhfuil cumraíocht de dhíth air (eochracha API) le bheith in ann Weblate a rialú go cianda. Is féidir leat é seo a bhaint amach freisin trí úsáid a bhaint as aon chliant HTTP in ionad Cliant Gréasáin, mar shampla curl, féach API REST Weblate.

Coinbhleachtaí cumaisc a sheachaint trí dhíriú ar oibríochtaí Git¶

Fiú nuair is é Weblate an fhoinse aonair de na hathruithe sna comhaid aistriúcháin, is féidir coimhlintí a bheith le feiceáil nuair a úsáidtear breiseán Geallann Squash Git, Cumasc stíl cumraithe to Rebase, nó tá tú ag scrúdú tiomanta lasmuigh de Weblate (mar shampla, agus iarratas tarraingthe á chumasc).

Tá an chúis atá le coinbhleachtaí cumaisc difriúil sa chás seo - tá athruithe ar Weblate a tharla tar éis duit tiomantas Weblate a chumasc. Tarlaíonn sé seo go hiondúil mura ndéantar an chumaisc uathoibrithe agus má fhanann sé ar feadh laethanta nó seachtainí ar an duine athbhreithniú a dhéanamh orthu. Uaireanta ní bhíonn Git in ann athruithe in aghaidh an tsrutha a aithint mar athruithe atá ag teacht leis na cinn Weblate a thuilleadh agus diúltaíonn sé rebase a dhéanamh.

Chun é seo a dhéanamh, ní mór duit an méid athruithe atá ar feitheamh i Weblate a íoslaghdú nuair a chumasc tú iarratas tarraingthe, nó seachnóidh tú coinbhleachtaí go hiomlán trí gan athruithe a bhrú.

Seo roinnt roghanna chun é sin a sheachaint:

Ná húsáid ceachtar Geallann Squash Git ná scuaise ag am an chumaisc. Is é seo an bhunchúis nach n-aithníonn git athruithe tar éis an chumaisc.
Lig do Weblate athruithe ar feitheamh a dhéanamh roimh chumasc. Nuashonróidh sé seo an t-iarratas tarraingt lena hathruithe go léir, agus beidh an dá stór á sioncronú.
Bain úsáid as na gnéithe athbhreithnithe in Weblate (féach Sreafaí oibre aistriúcháin) ionas gur féidir leat iarratais ar tharraingt GitHub a chumasc go huathoibríoch tar éis do CI pas a fháil.
Bain úsáid as glasáil in Weblate chun athruithe a sheachaint agus iarratas tarraingthe GitHub á athbhreithniú.

See also

Cliant Gréasáin

Ag fáil athruithe go huathoibríoch ó GitHub¶

Tagann Weblate le tacaíocht dhúchais do GitHub.

Má tá Hosted Weblate á úsáid agat, is é an cur chuige a mholtar ná an aip Weblate app, a shuiteáil, ar an mbealach sin gheobhaidh tú an socrú ceart gan a bheith ort mórán a shocrú. Is féidir é a úsáid freisin chun athruithe a bhrú ar ais.

Chun fógraí a fháil ar gach brú chuig stór GitHub, cuir an Weblate Webhook i socruithe an taisclainne (Webhooks) mar a thaispeántar san íomhá thíos:

Is éard atá sa Payload URL do URL Weblate atá i gceangal le /hooks/github/, mar shampla don tseirbhís Hosted Weblate, is é seo https://hosted.weblate.org/hooks/github/.

Is féidir leat luachanna eile a fhágáil ag socruithe réamhshocraithe (is féidir le Weblate an dá chineál ábhair a láimhseáil agus ní itheann sé ach an t-imeacht brú).

Athruithe a fháil go huathoibríoch ó Bitbucket¶

Tá tacaíocht ag Weblate do webhook Bitbucket, cuir webhook leis a spreagann ar bhrú stórais, le ceann scríbe chuig URL /hooks/bitbucket/ ar do shuiteáil Weblate (mar shampla https://hosted.weblate.org/hooks/bitbucket/).

Ag fáil athruithe go huathoibríoch ó GitLab¶

Tá tacaíocht ag Weblate do chrúcaí GitLab, cuir webhook tionscadail le ceann scríbe le URL /hooks/gitlab/ ar do shuiteáil Weblate (mar shampla https://hosted.weblate.org/hooks/gitlab/).

Athruithe a fháil go huathoibríoch ó Pagure¶

Tá tacaíocht ag Weblate do chrúcaí Pagure, cuir webhook le ceann scríbe le URL /hooks/pagure/ ar do shuiteáil Weblate (mar shampla https://hosted.weblate.org/hooks/pagure/). Is féidir é seo a dhéanamh i Activate Web-hooks faoi Project options:

Athruithe a fháil go huathoibríoch ó Azure Repos¶

Tá tacaíocht ag Weblate do webhook Azure Repos, cuir webhook le haghaidh imeachta Code pushed le ceann scríbe chuig /hooks/azure/ URL ar do shuiteáil Weblate (mar shampla https://hosted.weblate.org/hooks/azure/). Is féidir é seo a dhéanamh i Service hooks faoi Project settings.

Athruithe a fháil go huathoibríoch ó Gitea Repos¶

Tá tacaíocht ag Weblate do ghreamáin gréasáin Gitea, cuir Gitea Webhook le haghaidh Push events Brúigh imeacht imeachtaí leis an gceann scríbe chuig / dubháin/gitea/ URL ar do shuiteáil Weblate (mar shampla https:/ /hosted.weblate.org/hooks/gitea/). Is féidir é seo a dhéanamh i Webhooks faoi stór Settings.

Athruithe a fháil go huathoibríoch ó Gitee Repos¶

Tá tacaíocht ag Weblate do webholes Gitee, cuir a WebHook le haghaidh Push imeacht le ceann scríbe chuig /hooks/gitee/ URL ar do shuiteáil Weblate (mar shampla https://hosted.weblate.org/hooks/gitee/). Is féidir é seo a dhéanamh in WebHooks faoi stór Management.

Na stórtha a nuashonrú go huathoibríoch gach oíche¶

Faigheann Weblate stórtha cianda go huathoibríoch gach oíche chun feidhmíocht a fheabhsú nuair a dhéantar athruithe a chumasc níos déanaí. Is féidir leat cumaisc oíche a dhéanamh de seo go roghnach freisin, trí AUTO_UPDATE a chumasú.

Athruithe a bhrú ó Weblate¶

Is féidir le URL brú a chur ar bun ar gach comhpháirt aistriúcháin (féach URL bhrú stórais), agus sa chás sin beidh Weblate in ann athrú a bhrú chuig an stór iargúlta. Is féidir Weblate a chumrú freisin chun athruithe a bhrú go huathoibríoch ar gach tiomantas (is réamhshocraithe é seo, féach Brúigh ar thiomantas). Mura dteastaíonn uait go ndéanfaí athruithe a bhrú go huathoibríoch, is féidir leat é sin a dhéanamh de láimh fao Repository maintenance nó ag baint úsáide as an API via wlc push.

Tá difríocht idir na roghanna brú bunaithe ar an Comhtháthú rialaithe leagan a úsáidtear, tá tuilleadh sonraí le fáil sa chaibidil sin.

I gcás nach dteastaíonn brú díreach ag Weblate uait, tá tacaíocht ann Iarratais tharraingt GitHub, Iarratais chumasc GitLab, Iarratais tarraingt Gitea, leathanach iarratais chumaisc, Iarratais tarraingthe Azure DevOps pull requests no Gerrit athbhreithnithe, is féidir leat a ghníomhachtú iad seo GitHub, GitLab, Gitea, Gerrit, Azure DevOps, no Pagure mar Córas rialaithe leagan i Cumraíocht na Comhpháirte.

Ar an iomlán, tá na roghanna seo a leanas ar fáil le Git, Mercurial, GitHub, GitLab, Gitea, Pagure, Azure DevOps, Bitbucket Data Center agus Bitbucket Cloud:

Socrú inmhianaithe	Córas rialaithe leagan	URL bhrú stórais	Brainse a bhrú
Gan bhrú	Git	folamh	folamh
Brúigh go díreach	Git	URL SSH	folamh
Brúigh chuig brainse ar leith	Git	URL SSH	Ainm brainse
Gan bhrú	mearcair	folamh	folamh
Brúigh go díreach	mearcair	URL SSH	folamh
Brúigh chuig brainse ar leith	mearcair	URL SSH	Ainm brainse
Iarratas tarraingt GitHub ón bhforc	Iarratais tharraingt GitHub	folamh	folamh
Iarratas tarraingt GitHub ón bhrainse	Iarratais tharraingt GitHub	URL SSH [1]	Ainm brainse
Iarratas cumaisc GitLab ón bhforc	Iarratais chumasc GitLab	folamh	folamh
Iarratas cumaisc GitLab ón bhrainse	Iarratais chumasc GitLab	URL SSH [1]	Ainm brainse
Iarratas chumasc Gitea ón bhforc	Iarratais tarraingt Gitea	folamh	folamh
Iarratas chumasc Gitea ón bhrainse	Iarratais tarraingt Gitea	URL SSH [1]	Ainm brainse
Iarratas cumaisc leathanach ón bhforc	leathanach iarratais chumaisc	folamh	folamh
leathanach iarratas cumaisc ón bhrainse	leathanach iarratais chumaisc	URL SSH [1]	Ainm brainse
Tarraingíonn Azure DevOps iarratas ón bhforc	Iarratais tarraingthe Azure DevOps	folamh	folamh
Tarraingíonn Azure DevOps iarratas ón bhrainse	Iarratais tarraingthe Azure DevOps	URL SSH [1]	Ainm brainse
Iarratas tarraingte ón bhforc ag Ionad Sonraí Bitbucket	Iarratais ar tharraingt Ionad Sonraí Bitbucket	folamh	folamh
Iarratas tarraingte ón mbrainse ag Ionad Sonraí Bitbucket	Iarratais ar tharraingt Ionad Sonraí Bitbucket	URL SSH [1]	Ainm brainse
Iarratas tarraingt Bitbucket Cloud ón bhforc	Iarratais ar tharraingt Bitbucket Cloud	folamh	folamh
Iarratas tarraingt Bitbucket Cloud ón bhrainse	Iarratais ar tharraingt Bitbucket Cloud	URL SSH [1]	Ainm brainse

Note

Is féidir leat athruithe a bhrú go huathoibríoch a chumasú freisin tar éis do Weblate tiomantas, is féidir é seo a dhéanamh in Brúigh ar thiomantas.

See also

Féach Teacht ar stórtha chun eochracha SSH a bhunú, agus Geallann leisciúil le haghaidh faisnéise faoi cathain a chinneann Weblate athruithe a dhéanamh.

Craobhacha cosanta¶

Má tá Weblate á úsáid agat ar bhrainse faoi chosaint, is féidir leat é a chumrú chun iarratais ar tharraingt a úsáid agus athbhreithniú iarbhír a dhéanamh ar na haistriúcháin (rud a d’fhéadfadh a bheith ina fhadhb do theangacha nach bhfuil ar eolas agat). Cur chuige eile is ea an teorannú seo a tharscaoileadh don úsáideoir brú Weblate.

Mar shampla ar GitHub is féidir é seo a dhéanamh sa chumraíocht stór:

Idirghníomhú le daoine eile¶

Déanann Weblate éascaíocht idirghníomhú le daoine eile ag baint úsáide as a API.

See also

API REST Weblate

Geallann leisciúil¶

Is é iompar Weblate gealltanais ón údar céanna a ghrúpáil i dtiomantas amháin más féidir. Laghdaíonn sé seo líon na ngealltanais go mór, ach b'fhéidir go mbeidh ort a rá go sainráite dó na gealltanais a dhéanamh i gcás gur mhaith leat stór VCS a fháil i gcomhréir, m.sh. le haghaidh cumaisc (ceadaítear é seo de réir réamhshocraithe don ghrúpa Managers, féach Liosta pribhléidí).

Déantar na hathruithe ar an modh seo a dhéanamh nuair a chomhlíontar aon cheann de na coinníollacha seo a leanas:

Athraíonn duine éigin eile teaghrán a athraíodh cheana féin.
Tarlaíonn cumasc ó in aghaidh an tsrutha.
Iarrtar gealltanas sainráite.
Iarrtar comhad a íoslódáil.
Tá an t-athrú níos sine ná an tréimhse a shainmhínítear mar Aois na n-athruithe le gealltanas ar Cumraíocht na Comhpháirte.

Hint

Cruthaítear gealltanais do gach comhpháirt. Mar sin ar eagla go bhfuil go leor comhpháirteanna agat feicfidh tú go leor gealltanais fós. D'fhéadfá úsáid a bhaint as Geallann Squash Git breiseán sa chás sin.

Más mian leat athruithe a dhéanamh níos minice agus gan aois a sheiceáil, is féidir leat tasc rialta a sceidealú chun gealltanas a dhéanamh. Is féidir é seo a dhéanamh ag baint úsáide as Tascanna Tréimhsiúla i Comhéadan riaracháin Django. Ar dtús cruthaigh Eatramh (120 soicind mar shampla). Ansin cuir tasc tréimhsiúil nua leis agus roghnaigh weblate.trans.tasks.commit_pending mar Tasc le {"uaireanta": 0} mar Argóintí Eochairfhocal agus an t-eatramh inmhianaithe.

Stór a phróiseáil le scripteanna¶

Is é an bealach chun an chaoi a n-idirghníomhaíonn Weblate leis an stór a shaincheapadh ná Breiseáin. Téigh i gcomhairle Scripteanna a rith ón mbreiseán le haghaidh faisnéise ar conas scripteanna seachtracha a rith trí bhreiseáin.

Aistriúcháin á gcoinneáil mar an gcéanna trasna comhpháirteanna¶

Nuair a bheidh ilchodanna aistriúcháin agat, b'fhéidir gur mhaith leat a chinntiú go bhfuil an t-aistriúchán céanna ar na teaghráin chéanna. Is féidir é seo a bhaint amach ar leibhéil éagsúla.

Iomadú aistriúcháin¶

Le Ceadaigh iomadú aistriúcháin cumasaithe (cad é an réamhshocrú, féach Cumraíocht na Comhpháirte), déantar gach aistriúchán nua go huathoibríoch i ngach comhpháirt le teaghráin mheaitseála. Cuirtear na haistriúcháin sin chun sochair go cuí don úsáideoir atá ag aistriú faoi láthair i ngach comhpháirt.

Réamhchoinníollacha iomadúcháin:

Caithfidh na comhpháirteanna uile a bheith i dtionscadal aonair (ní leor comhpháirt a nascadh).
Cumasaigh Ceadaigh iomadú aistriúcháin chun aistriúcháin a athúsáid go huathoibríoch le haghaidh teaghráin chomhoiriúnacha.
Éilíonn an bolscaireacht aistriúcháin go mbeidh an eochair ag teacht le formáidí aistriúcháin aonteangacha, mar sin coinnigh sin san áireamh agus eochracha aistriúcháin á gcruthú.
Déantar na teaghráin a iomadú agus iad á n-aistriú, ní dhéantar teaghráin a lódálfar ón stór a iomadú.

Tip

Tá teorainneacha leis an ngné seo faoi láthair, agus ba mhaith linn í a dhéanamh níos uilíche. Roinn do chuid aiseolais ag https://github.com/WeblateOrg/weblate/issues/3166 le do thoil.

Seiceáil comhsheasmhachta¶

An Neamh-chomhsheasmhach seiceáil tinte nuair a bhíonn na teaghráin difriúil. Is féidir leat é seo a úsáid chun difríochtaí den sórt sin a athbhreithniú de láimh agus an t-aistriúchán ceart a roghnú.

Aistriúchán uathoibríoch¶

Is féidir aistriúchán uathoibríoch bunaithe ar chomhpháirteanna éagsúla a bheith ina bhealach chun na haistriúcháin a shioncronú trasna comhpháirteanna. Is féidir leat é a spreagadh de láimh (féach Aistriúchán uathoibríoch) nó é a chur ar siúl go huathoibríoch ar nuashonrú stórtha ag baint úsáide as breiseán (féach Aistriúchán uathoibríoch).