Comhtháthú rialaithe leagan¶
Weblate currently supports Git (with extended support for Iarratais tharraingt GitHub, Iarratais chumasc GitLab, Iarratais tarraingt Gitea, Gerrit review requests, Treascairt, Iarratais ar tharraingt Bitbucket Cloud, Iarratais ar tharraingt Ionad Sonraí Bitbucket, and Iarratais tarraingthe Azure DevOps) and mearcair as version control back-ends.
For provider-specific setup steps that combine repository access, incoming notifications, and pushing translations back, see Code hosting integrations.
Teacht ar stórtha¶
Caithfidh an stórlann VCS is mian leat a úsáid a bheith inrochtana ag Weblate. Le stórlann atá ar fáil go poiblí, níl le déanamh agat ach an URL ceart a iontráil (mar shampla https://github.com/WeblateOrg/weblate.git), ach i gcás stórlanna príobháideacha nó URLanna brúite, bíonn an socrú níos casta agus teastaíonn fíordheimhniú uaidh.
Teacht ar stórtha ó Hosted Weblate¶
Note
Baineann an chuid seo ach le Weblate Óstáilte (hosted.weblate.org). Má tá tú ag rith do chás féinóstáilte Weblate, féach an chéad chuid eile ina ionad.
Le haghaidh Óstáil Weblate, tá úsáideoir tiomnaithe brúigh cláraithe ar GitHub, Bitbucket, Codeberg, agus GitLab (leis an ainm úsáideora weblate, r-phost hosted@weblate.org, agus ainm nó cur síos próifíle úsáideoir brú gréasáin).
Hint
Is féidir go mbeadh níos mó úsáideoirí Weblate ar na hardáin, ainmnithe do chásanna eile Weblate. Moltar cuardach a dhéanamh trí ríomhphost hosted@weblate.org chun an t-úsáideoir ceart a aimsiú le haghaidh Hosted Weblate.
Ní mór duit an t-úsáideoir seo a chur leis mar chomhoibrí agus ceadanna cuí a thabhairt dó le do stór (tá inléite amháin ceart go leor le haghaidh clónála, tá scríobh riachtanach le haghaidh brú). Ag brath ar an tseirbhís agus ar shocruithe d’eagraíochta, tarlaíonn sé seo láithreach, nó teastaíonn deimhniú ón taobh Weblate.
Ar GitHub, ní mór duit an t-úsáideoir Hosted Weblate weblate a chur leis nó cuireadh a thabhairt dó/di, le rochtain scríbhneoireachta, fiú nuair a úsáideann tú aip GitHub Hosted Weblate. Láimhseálann an aip fógraí isteach ó GitHub, ach úsáideann sé/sí an t-úsáideoir Hosted Weblate weblate fós agus athruithe á gcur siar.
Glacann an t-úsáideoir weblate ar GitHub cuireadh go huathoibríoch laistigh de chúig nóiméad. D'fhéadfadh go mbeadh gá le próiseáil láimhe ar na seirbhísí eile, mar sin bí foighneach.
Nuair a chuirtear an t-úsáideor weblate le do stór, is féidir leat Stór cód foinse agus URL bhrú stórais a chumrú ag baint úsáide as an bprótacal SSH (mar shampla git@github.com:WeblateOrg/weblate.git).
Rochtain a fháil ar stórtha ar shuíomhanna óstála cód (GitHub, GitLab, Bitbucket, Azure DevOps, ...)¶
Note
Baineann an chuid seo le cásanna Weblate féinóstáilte. Má tá tú ag úsáid Weblate Óstáilte (hosted.weblate.org), féach Teacht ar stórtha ó Hosted Weblate ina ionad.
For self-hosted Weblate, accessing repositories on code hosting sites is typically done by creating a dedicated user who is associated with a Weblate SSH key (see Eochracha gréasáin SSH). This way you associate Weblate SSH key with a single user (platforms frequently enforce single use of an SSH key) and grant this user access to the repository. You can then use SSH URL to access the repository (see stórtha SSH).
stórtha SSH¶
Tá an modh is minice a úsáidtear chun rochtain a fháil ar stórtha príobháideacha bunaithe ar SSH. Údaraigh an eochair phoiblí Weblate SSH (féach Eochracha gréasáin SSH) chun rochtain a fháil ar an stór in aghaidh an tsrutha ar an mbealach seo.
Warning
On GitHub, each key can only be used once, see GitHub repository access and Teacht ar stórtha ó Hosted Weblate.
Stórálann Weblate méarloirg an eochair óstach freisin ar an gcéad nasc, agus teipeann sé ceangal leis an óstach má athraítear é níos déanaí (féach Eochracha óstaigh SSH á bhfíorú).
Sa chás go bhfuil gá le coigeartú, déan é sin ó chomhéadan riaracháin Weblate:
Eochracha gréasáin SSH¶
Changed in version 4.17: Gineann Weblate eochracha RSA agus Ed25519 SSH araon. Moltar Ed25519 a úsáid le haghaidh socruithe nua.
Tá eochair phoiblí Weblate le feiceáil ag gach úsáideoir a bhrabhsálann an leathanach About.
Is féidir le riarthóirí an eochair phoiblí a úsáideann Weblate faoi láthair a ghiniúint nó a thaispeáint sa nasc (ó SSH keys) ar leathanach tuirlingthe an chomhéadain riaracháin.
Note
Ní féidir focal faire a bheith ag an eochair phríobháideach SSH comhfhreagrach faoi láthair, mar sin cinntigh go bhfuil sé cosanta go maith.
Hint
Déan cúltaca den eochair phríobháideach Weblate SSH a ghintear.
Eochracha óstaigh SSH á bhfíorú¶
Stórálann Weblate na heochracha óstaigh SSH go huathoibríoch ar an gcéad rochtain agus cuimhnítear orthu le haghaidh tuilleadh úsáide.
Ar eagla go dteastaíonn uait an eochair-mhéarloirg a fhíorú sula ndéanann tú ceangal leis an stór, cuir isteach eochracha óstach SSH na bhfreastalaithe a bhfuil tú chun rochtain a fháil orthu in Cuir leis an eochair óstaigh, ón gcuid chéanna den chomhéadan riaracháin. Cuir isteach an t-óstainm a bhfuil tú chun rochtain a fháil air (m.sh. gitlab.com), agus brúigh Cuir isteach. Fíoraigh go dtagann a mhéarloirg leis an bhfreastalaí a chuir tú leis.
Taispeántar na heochracha breise le méarloirg sa teachtaireacht deimhnithe:
Ag nascadh le freastalaithe SSH oidhreachta¶
Díchumasaigh eisiúintí OpenSSH le déanaí (mar shampla an ceann a úsáidtear i gcoimeádán Weblate Docker) sínithe RSA ag baint úsáide as an algartam hash SHA-1 de réir réamhshocraithe. Rinneadh an t-athrú seo toisc go bhfuil an t-algartam hash SHA-1 briste go cripteagrafach, agus is féidir imbhuailtí hais réimír roghnaithe a chruthú do <USD$50K.
I gcás fhormhór na n-úsáideoirí, ba cheart go mbeadh an t-athrú seo dofheicthe agus ní gá eochracha ssh-rsa a athsholáthar. Thacaigh OpenSSH le sínithe RFC8332 RSA/SHA-256/512 ó scaoileadh 7.2 agus úsáidfidh eochracha ssh-rsa atá ann cheana an algartam níos láidre go huathoibríoch nuair is féidir.
Is dóichí go bhfuil neamh-chomhoiriúnacht nuair a cheanglaítear le feidhmiúcháin SSH níos sine nach bhfuil uasghrádaithe nó nach bhfuil feabhsuithe rianaithe go dlúth sa phrótacal SSH. Teipfidh ar an gceangal SSH le freastalaí dá leithéid le:
no matching host key type found. Their offer: ssh-rsa
Maidir leis na cásanna seo, b'fhéidir go mbeadh sé riachtanach RSA/SHA1 a athchumasú chun ceangal agus/nó fíordheimhniú úsáideora a cheadú tríd na roghanna HostKeyAlgorithms agus PubKeyAcceptedAlgorithMS. Mar shampla, cumasóidh an stanza seo a leanas i DATA_DIR/ssh/config RSA/SHA1 le haghaidh fíordheimhniú óstach agus úsáideora d'óstach ceann scríbe amháin:
Host legacy-host
HostkeyAlgorithms +ssh-rsa
PubkeyAcceptedAlgorithms +ssh-rsa
Molaimid RSA/SHA1 a chumasú mar bheart stopála amháin go dtí gur féidir feidhmithe oidhreachta a uasghrádú nó a athchumrú le cineál eochrach eile (amhail ECDSA nó Ed25519).
Taisclanna GitHub¶
Detailed GitHub repository access is covered in GitHub repository access.
Stórais GitLab¶
Detailed GitLab repository access is covered in GitLab repository access.
URLanna inmheánacha an Ghréasáin¶
Roinn socrú stór amháin idir comhpháirteanna éagsúla trí thagairt a dhéanamh dá socrúchán mar weblate://project/component i gcomhpháirteanna eile (nasctha). Ar an mbealach seo úsáideann comhpháirteanna nasctha cumraíocht stór VCS na príomh-chomhpháirte (tagartha).
Warning
Má bhaintear an phríomh-chomhpháirt, baintear comhpháirteanna nasctha freisin.
Déanann Weblate URL an taisclainne a choigeartú go huathoibríoch agus comhpháirt á chruthú aige má aimsíonn sé comhpháirt le socrú taisclainne meaitseála. Is féidir leat é seo a shárú sa chéim dheireanach de chumraíocht an chomhpháirte.
Cúiseanna é seo a úsáid:
Sábhálann sé spás diosca ar an bhfreastalaí, stóráiltear an stór ach uair amháin.
Déanann sé na nuashonruithe níos tapúla, ní nuashonraítear ach stór amháin.
Níl ann ach stór amháin easpórtála le haistriúcháin Weblate (féach Onnmhaireoir Git).
Is féidir le roinnt breiseán oibriú ar chomhpháirteanna iolracha agus stór amháin á roinnt acu, mar shampla Geallann Squash Git.
Stórtha HTTPS¶
Chun rochtain a fháil ar stórtha HTTPS faoi chosaint, cuir an t-ainm úsáideora agus an pasfhocal san URL. Ná bíodh imní ort, bainfidh Weblate an fhaisnéis seo nuair a thaispeánfar an URL d'úsáideoirí (má cheadaítear fiú URL an taisclainne a fheiceáil ar chor ar bith).
Mar shampla, d'fhéadfadh URL GitHub agus fíordheimhniú curtha leis breathnú mar seo a leanas: https://user:your_access_token@github.com/WeblateOrg/weblate.git.
Mura soláthraíonn tú dintiúir san URL agus má éilíonn an stór é, teipfidh ar Git le hearráid:
fatal: could not read Username for 'https://github.com': terminal prompts disabled
Changed in version 5.10.2: Úsáideann Weblate fíordheimhniú réamhghníomhach le Git 2.46.0 agus níos nuaí nuair a sholáthraítear dintiúir HTTP.
Fágann sé seo gur féidir rochtain a fháil ar stórtha Azure DevOps agus déanann sé rochtain ar stórtha fíordheimhnithe níos tapúla.
Note
Má tá carachtair speisialta ag d'ainm úsáideora nó do phasfhocal, caithfear iad sin a ionchódú URL, mar shampla https://user%40example.com:%24password%23@bitbucket.org/....
Ag baint úsáide as seachfhreastalaí¶
Más gá duit rochtain a fháil ar stórtha HTTP/HTTPS VCS ag baint úsáide as seachfhreastalaí, cumraigh an VCS chun é a úsáid.
Is féidir é seo a dhéanamh ag baint úsáide as na hathróga timpeallachta http_proxy, https_proxy, agus all_proxy, (mar a thuairiscítear i gcáipéisíocht cURL) nó trína fhorfheidhmiú sa chumraíocht VCS, mar shampla:
git config --global http.proxy http://user:password@proxy.example.com:80
Note
Ní mór an chumraíocht seachfhreastalaí a dhéanamh faoi Weblate a reáchtáil úsáideora (féach freisin Ceadanna córas comhaid) agus le HOME=$DATA_DIR/home (féach DATA_DIR), ar shlí eile ní úsáidfidh Git a fhorghníomhaíonn Weblate é.
Git¶
Hint
Tá Git 2.28 nó níos nuaí de dhíth ar Weblate.
See also
Féach Teacht ar stórtha le haghaidh faisnéise ar conas rochtain a fháil ar chineálacha éagsúla stórtha.
Git le brú fórsa¶
Iompraíonn sé seo díreach cosúil le Git féin, agus is é an t-aon difríocht amháin ná go ndéanann sé brú i gcónaí. Níl sé seo beartaithe ach amháin i gcás stór ar leith a úsáid le haghaidh aistriúcháin.
Warning
Bí cúramach, mar go n-eascraíonn sé seo go héasca gealltanais caillte i do stór in aghaidh an tsrutha.
Cumraíocht Git a shaincheapadh¶
Déanann Weblate gach ordú VCS a agairt le HOME=$DATA_DIR/home (see DATA_DIR), mar sin ní mór an chumraíocht úsáideora a chur in eagar i DATA_DIR/home/.git.
Iarratais tharraingt GitHub¶
Detailed GitHub pull request setup is covered in Iarratais tharraingt GitHub.
Iarratais chumasc GitLab¶
Detailed GitLab merge request setup is covered in Iarratais chumasc GitLab.
Iarratais tarraingt Gitea¶
Detailed Gitea pull request setup is covered in Iarratais tarraingt Gitea.
Iarratais ar tharraingt Ionad Sonraí Bitbucket¶
Detailed Bitbucket Data Center pull request setup is covered in Iarratais ar tharraingt Ionad Sonraí Bitbucket.
Iarratais ar tharraingt Bitbucket Cloud¶
Detailed Bitbucket Cloud pull request setup is covered in Iarratais ar tharraingt Bitbucket Cloud.
leathanach iarratais chumaisc¶
Detailed Pagure merge request setup is covered in leathanach iarratais chumaisc.
Gerrit¶
Detailed Gerrit review request setup is covered in Gerrit review requests.
Iarratais tarraingthe Azure DevOps¶
Detailed Azure DevOps pull request setup is covered in Iarratais tarraingthe Azure DevOps.
mearcair¶
Is VCS eile é Mercurial is féidir leat a úsáid go díreach in Weblate.
Note
Ba cheart go n-oibreodh sé le haon leagan Mercurial, ach uaireanta bíonn athruithe neamh-chomhoiriúnacha ar an gcomhéadan ordú-líne a bhriseann comhtháthú Weblate.
See also
Féach Teacht ar stórtha le haghaidh faisnéise ar conas rochtain a fháil ar chineálacha éagsúla stórtha.
Treascairt¶
Úsáideann Weblate git-svn chun idirghníomhú le stórtha fo-leagan. Script Perl is ea é a ligeann do chliant Git úsáid a bhaint as an bhfoshraith, rud a chuireann ar chumas úsáideoirí clón iomlán den stór inmheánach a choinneáil agus gealltanas a thabhairt go háitiúil.
Note
Déanann Weblate iarracht leagan amach stórtha Subversion a bhrath go huathoibríoch - tacaíonn sé le URLanna díreacha le haghaidh brainse nó stórtha le leagan amach caighdeánach (brainsí/, clibeanna/ agus stoc/). Tá tuilleadh eolais faoi seo le fáil sa cháipéisíocht git-svn. Mura bhfuil leagan amach caighdeánach ar do stór agus má bhíonn earráidí agat, déan iarracht ainm an bhrainse a áireamh i URL an taisc agus fág an brainse folamh.
Dintiúir Subversion¶
Tá Weblate ag súil go mbeidh an teastas glactha agat roimh ré (agus le do dhintiúir más gá). Féachfaidh sé chun iad a chur isteach sa DATA_DIR eolaire. Glac leis an teastas trí svn a úsáid uair amháin leis an athróg timpeallachta $HOME socraithe don DATA_DIR:
# Use DATA_DIR as configured in Weblate settings.py, it is /app/data in the Docker
HOME=${DATA_DIR}/home svn co https://svn.example.com/example
See also
Comhaid áitiúla¶
Hint
Anseo thíos, úsáideann sé seo Git. Éilíonn sé Git a shuiteáil agus ceadaíonn sé duit aistriú chuig Git a úsáid go dúchais le stair iomlán d’aistriúcháin.
Is féidir le Weblate oibriú freisin gan VCS cianda. Iompórtáiltear na haistriúcháin tosaigh trí iad a uaslódáil. Níos déanaí is féidir leat comhaid aonair a uaslódáil in ionad comhaid aonair, nó teaghráin aistriúcháin a chur leis go díreach ó Weblate (ar fáil faoi láthair le haghaidh aistriúcháin aonteangacha amháin).
Sa chúlra cruthaíonn Weblate stór Git duit agus déantar gach athrú a rianú isteach. Sa chás go gcinnfidh tú níos déanaí VCS a úsáid chun na haistriúcháin a stóráil, tá stór agat cheana féin laistigh de Weblate ar féidir leat do chomhtháthú a bhunú air.