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
Comhtháthú le Weblate describes basic ways to integrate your development with Weblate. Code hosting integrations lists provider-specific setup steps for common code hosting sites.
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).
Changes are pushed back to the upstream repository (see 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.
Use Crúcaí fógra to integrate with the majority of common code hosting services, see Code hosting integrations. You must also Cumasaigh crúcaí for this to work.
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_UPDATEchun na comhpháirteanna go léir ar do shampla Weblate a nuashonrú go huathoibríochRith
updategit(le rogha an tionscadail nó--uilechun 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.
Cothabháil stór¶
Taispeánann an radharc Cothabháil stórtha stádas stórtha tionscadail, comhpháirte nó aistriúcháin agus ligeann sé d'úsáideoirí pribhléideacha oibríochtaí cothabhála a rith ón gcomhéadan úsáideora.
Is féidir na gníomhartha céanna a spreagadh freisin ag baint úsáide as API REST Weblate nó, i gcás an fho-thacar a dtacaítear leis, Cliant Gréasáin.
Braitheann infhaighteacht gníomhartha aonair ar cheadanna, ar an gcóras rialaithe leaganacha cumraithe, ar cibé an bhfuil brú cumraithe, agus ar cibé an féidir an réad roghnaithe a ghlasáil.
Gníomh |
Cad a dhéanann sé |
Úsáid tipiciúil |
|---|---|---|
Tiomantas |
Cuireann sé athruithe atá ar feitheamh atá stóráilte i Weblate i bhfeidhm sa stór áitiúil. |
Glan athruithe Weblate atá ar feitheamh sula ndéantar obair ar an stór in áit eile. |
Brúigh |
Brúitear athruithe tiomnaithe ar an stór áitiúil chuig an uas-sruth cumraithe. |
Seol aistriúcháin tiomanta suas an sruth nuair a bhíonn brú uathoibríoch díchumasaithe nó moillithe. |
Nuashonrú |
Faigheann sé athruithe suas an sruth agus comhtháthaíonn sé iad ag baint úsáide as Cumasc stíl cumraithe an chomhpháirte. |
Tabhair Weblate i sioncrón leis an sruth suas ag baint úsáide as an straitéis chomhtháthaithe réamhshocraithe. |
Nuashonraigh le cumasc |
Faigheann sé athruithe suas an sruth agus comhtháthaíonn sé iad le cumasc follasach. |
Sáraigh an stíl chumasc réamhshocraithe le haghaidh nuashonrú aonair. |
Nuashonraigh le hathbhunú |
Faigheann sé athruithe suas an sruth agus athbhunaíonn sé tiomantais áitiúla Weblate ar bharr an uasshrutha. |
Coinnigh stair líneach nuair a oireann sé sin chun do shreabhadh oibre. |
Nuashonraigh le cumasc gan luasghéarú |
Faigheann sé athruithe suas an sruth agus cruthaíonn sé tiomantas cumasc sainráite fiú nuair a bheadh meascán ar aghaidh indéanta. |
Caomhnaigh gealltanais chumasc ar chúiseanna iniúchóireachta nó bainistíochta brainse. |
Glasáil / Díghlasáil |
Cuireann sé cosc ar aistritheoirí athruithe breise a dhéanamh i Weblate nó tugann sé cead dóibh iad a dhéanamh. |
Reoigh athruithe aistriúcháin agus cothabháil stórtha á déanamh lasmuigh de Weblate. |
Athshocraigh agus caith amach |
Athshocraíonn sé stórlann áitiúil Weblate go dtí an chéad leibhéal eile agus caitheann sé athruithe Weblate atá ar feitheamh i leataobh. |
Úsáid nuair ba chóir don sruth suas an sruth staid an stórtha áitiúil Weblate a athscríobh. |
Athshocraigh agus cuir i bhfeidhm arís |
Athshocraíonn sé stórlann áitiúil Weblate go dtí an leibhéal thuas agus na haistriúcháin atá ar feitheamh á gcaomhnú. Féach Athshocraigh agus cuir an t-iompar aisghabhála i bhfeidhm arís. |
Aisghabháil ó stair éagsúil agus aistriúcháin Weblate atá ar feitheamh a choinneáil. |
Glanadh |
Baintear comhaid neamhrianaithe agus brainsí seanchaite ón tseiceáil amach stórais áitiúil. |
Glan suas comhaid atá fágtha nó seanstaid stórais i seiceáil amach Weblate. |
Sioncrónaigh |
Cuireann sé iallach ar Weblate gach aistriúchán aitheanta a scríobh ar ais chuig comhaid an stórais. |
Deisigh cásanna inar tháinig comhaid an stórais as sioncrón le staid an bhunachar sonraí. |
Athscanadh |
Athléann sé comhaid aistriúcháin ón stór áitiúil isteach i Weblate. |
Iompórtáil athruithe comhaid tar éis obair láimhe ar an stór nó cruthú comhaid. |
Athshocraigh agus cuir an t-iompar aisghabhála i bhfeidhm arís¶
Coinníonn an oibríocht Athshocraigh agus athiarratas aistriúcháin ar feitheamh ó Weblate agus staid an stórais áitiúil á hathshocrú chun go mbeidh sé in oiriúint don réamhtheachta.
Ní féidir leis an oibríocht aistriúcháin atá ar feitheamh a athbhunú ach amháin nuair a bhíonn na comhaid teanga sprice fós ann tar éis an athshocraithe nó nuair is féidir le Weblate iad a chruthú don chomhpháirt, mar shampla trí Teimpléad le haghaidh aistriúcháin nua bailí a úsáid.
Mura gcomhlíontar ceachtar den dá choinníoll seo, coinníonn Weblate na hathruithe atá ar feitheamh ina bhunachar sonraí agus tuairiscíonn sé earráid aisghabhála in ionad teip níos déanaí le hearráid pharsála ghinearálta.
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
Code hosting notifications¶
Provider-specific app and webhook instructions for GitHub, GitLab, Bitbucket, Pagure, Azure Repos, Gitea, Forgejo, and Gitee are covered in Code hosting integrations.
Provider-specific notifications¶
These legacy anchors are kept for compatibility. Current provider-specific app and webhook setup is documented in Code hosting integrations.
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¶
Each translation component can have a push URL set up (see URL bhrú stórais), and in that case Weblate will be able to push changes to the remote repository. Weblate can also be configured to automatically push changes on every commit, see Brúigh ar thiomantas.
For the push options table and provider-specific pull, merge, and review request workflows, see Athruithe a bhrú ó Weblate.
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
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).