Cliant Gréasáin

Suiteáil

Déantar an Weblate Client a dháileadh ar leithligh agus cuimsítear an modúl Python ann. Coinnítear an cód foinseach i stórlann WeblateOrg/wlc. Chun na horduithe thíos a úsáid, ní mór duit wlc a shuiteáil le pip:

pip install wlc

Is féidir leat é a fhorghníomhú go díreach ag baint úsáide as uvx:

uvx wlc --help

Hint

Is féidir leat an wlc seo a úsáid mar mhodúl Python freisin, féach wlc.

Úsáid docker

Tá an Cliant Weblate ar fáil freisin mar íomhá Docker.

Foilsítear íomhánna ar Docker Hub agus ar GitHub Container Registry. Baintear úsáid as ainm na híomhá ó Docker Hub sna samplaí thíos.

Suiteáil:

docker pull weblate/wlc

Tá na clibeanna seo a leanas ar fáil:

latest

An eisiúint chobhsaí is déanaí.

Leagan iomlán, mar shampla 2.2.0

Eisiúint chobhsaí shonrach.

Príomhleagan, mar shampla 2

An eisiúint chobhsaí is déanaí sa tsraith mhór sin.

edge

An leagan forbartha reatha ón bpríomh-bhrainse.

edge-YYYY-MM-DD-COMMIT

Grianghraf sealadach sonrach den fhorbairt.

Chun íomhá a thógáil ón bhfoinse a tarraingíodh anuas:

docker build -t weblate/wlc .

Úsáideann an coimeádán Docker réamhshocruithe Cliant Weblate agus nascann sé leis an API atá imscartha ar localhost. Cumraigh URL an API agus eochair an API ag baint úsáide as na hargóintí wlc nó na hathróga comhshaoil gnáth, mar shampla --url, --key, WLC_URL, agus WLC_KEY. Diúltaítear eochracha API thar URLanna http://` neamh-áitiúla de réir réamhshocraithe; bain úsáid as HTTPS, HTTP lúbtha siar le haghaidh forbartha áitiúla, nó roghnaigh go sainráite isteach i HTTP neamhshlán.

Úsáideann an t-ordú chun an coimeádán a sheoladh an chomhréir seo a leanas:

docker run --rm weblate/wlc [WLC_ARGS]

Sampla:

docker run --rm weblate/wlc --url https://hosted.weblate.org/api/ list-projects

B’fhéidir gur mhaith leat do Comhaid chumraíochta a chur chuig an gcoimeádán Docker. Nuair a bhíonn cumraíocht tionscadail ar nós .weblate i do stór, is é an cur chuige is fusa ná d’eolaire reatha a chur leis mar an toirt /home/weblate:

docker run --volume $PWD:/home/weblate --rm weblate/wlc show

Nuair a sholáthraíonn an stór feistithe URL an API i gcumraíocht an tionscadail agus nuair a chuireann tú eochair API neamhscóipeáilte ar fáil don choimeádán, socraigh an URL go sainráite freisin: teastaíonn WLC_URL le haghaidh WLC_KEY, agus teastaíonn --url le haghaidh --key. Teastaíonn an péireáil chéanna do na roghanna sáraithe --allow-insecure-http agus --allow-insecure-ssl.

Má úsáideann an URL API cumraithe seoladh http:// nach bhfuil áitiúil agus má chuirtear eochair API ar fáil, diúltóidh an coimeádán an eochair a sheoladh mura gcuirtear HTTP neamhshlán ar chumas go sainráite. Is fearr HTTPS a úsáid; i gcás imlonnuithe oidhreachta, bain úsáid as --allow-insecure-http nó socraigh WLC_ALLOW_INSECURE_HTTP. Déantar deimhnithe TLS a fhíorú i gcónaí de réir réamhshocraithe, lena n-áirítear URLanna lúba-ais (loopback). Ná húsáid --allow-insecure-ssl nó WLC_ALLOW_INSECURE_SSL ach amháin nuair nach féidir fíorú deimhnithe a chur ar chumas.

Ag tosú

Is é an bealach is fusa le tosú ná cumraíocht phearsanta wlc a chruthú i ~/.config/weblate (féach Comhaid chumraíochta le haghaidh na rialacha fionnachtana iomlána agus suíomhanna eile):

[weblate]
url = https://hosted.weblate.org/api/

[keys]
https://hosted.weblate.org/api/ = APIKEY

Is féidir leat orduithe a agairt ansin ar an bhfreastalaí réamhshocraithe:

wlc ls
wlc commit sandbox/hello-world

See also

Comhaid chumraíochta

Cumraíocht oidhreachta

Changed in version 1.17: Ní thacaítear a thuilleadh leis an seanchumraíocht a úsáideann key neamhscóipithe.

Changed in version 2.2.0: Ní thacaítear a thuilleadh leis an gcumraíocht dhomhanda allow_insecure_http. Ina áit sin, cumraigh bunús sa rannán [insecure_http].

Cumraíocht oidhreachta a aistriú:

[weblate]
url = https://hosted.weblate.org/api/
key = YOUR_KEY_HERE

Chuig cumraíocht le heochair atá teoranta do URL API:

[weblate]
url = https://hosted.weblate.org/api/

[keys]
https://hosted.weblate.org/api/ = YOUR_KEY_HERE

Achoimre

wlc [arguments] <command> [options]

Léiríonn orduithe i ndáiríre cén oibríocht ba cheart a dhéanamh.

Cur síos

Is leabharlann Python agus fóntas líne-ordaithe é Weblate Client chun Weblate a bhainistiú go cianda trí úsáid a bhaint as API REST Weblate. Glaoigh ar an bhfóntas líne-ordaithe mar wlc; féach wlc le haghaidh an API Python.

Argóintí

Glacann an clár leis na hargóintí seo a leanas a shainíonn formáid aschuir nó a bhfuil Weblate mar shampla le húsáid. Ní mór iad seo a chur isteach roimh aon ordú.

--format {csv,json,text,html}

Sonraigh an fhormáid aschuir. Is é text an réamhshocrú.

--version

Priontáil leagan an chláir agus scoir. Tacaíonn an t-ordú version le formáidiú aschuir agus is féidir leis uimhir an leagain amháin a phriontáil.

--debug

Priontáil cumarsáid HTTP fholaithe. Déantar luachanna ceanntásca údaraithe a cheilt agus ní logáiltear comhlachtaí na n-iarratas, ach déantar paraiméadair an cheiste; ná cuir rúin i bparaiméadair an cheiste.

--url URL

Sonraigh an URL API. Sáraíonn sé aon luach a fhaightear sa chomhad cumraíochta, féach Comhaid chumraíochta. Ba cheart go gcríochnódh an URL le /api/, mar shampla https://hosted.weblate.org/api/.

--key KEY

Sonraigh an eochair úsáideora API le húsáid. Sáraíonn sé aon luach a fhaightear sa chomhad cumraíochta, féach Comhaid chumraíochta. Is féidir leat d'eochair a fháil i do phróifíl ar Weblate. Nuair a luchtaítear URL an API ó chumraíocht tionscadail a aimsítear go huathoibríoch, ní mór --key a úsáid in éineacht le --url. Diúltaítear d'eochracha API thar URLanna http:// neamh-áitiúla de réir réamhshocraithe.

--allow-insecure-http

Ceadaítear eochracha API a sheoladh trí URLanna http:// nach URLanna áitiúla iad. Is fearr HTTPS nó HTTP lúb-ais (loopback) a úsáid ina n-ionad; níl an rogha seo beartaithe ach le haghaidh imscaradh seanchóras nach bhfuil HTTPS ar fáil iontu. Ní chuireann an rogha seo HTTP neamhshlán ar chumas ach don rith reatha amháin. Nuair a thagann URL an API ó chumraíocht tionscadail a aimsíodh go huathoibríoch, teastaíonn --url leis an rogha seo.

--allow-insecure-ssl

Díchumasaigh fíorú teastais TLS don rith reatha. Déantar teastais a fhíorú de réir réamhshocraithe do gach URL HTTPS, lena n-áirítear URLanna lúb-ais (loopback). Nuair a thagann URL an API ó chumraíocht tionscadail a aimsíodh go huathoibríoch, teastaíonn --url leis an rogha seo.

--config PATH

Luchtaigh cumraíocht ó PATH amháin in ionad na gcomhad cumraíochta domhanda agus tionscadail a aimsíodh, féach Comhaid chumraíochta.

--config-section SECTION

Roghnaíonn sé an rannán den chomhad cumraíochta le húsáid in áit [weblate]; féach Comhaid chumraíochta.

Conairí réad

Glacann orduithe a oibríonn ar réad le ceann de na cosáin seo:

PROJECT

Aitheantóir an tionscadail.

PROJECT/COMPONENT

Slug an chomhpháirte, lena n-áirítear an tionscadal a bhaineann leis.

PROJECT/COMPONENT/LANGUAGE

Teanga an aistriúcháin, lena n-áirítear an tionscadal agus an comhpháirt a bhaineann léi.

UNIT_ID

Aitheantóir uimhriúil d'aonad aistriúcháin. Ní ghlacann leis an bhfoirm seo ach na horduithe a thacaíonn go sainráite le haonaid.

Úsáideann orduithe a dteastaíonn réad uathu an socrú translation ó Comhaid chumraíochta nuair a fhágtar an cosán ar lár. Úsáideann na horduithe ls agus download an socrú seo freisin sula n-aistríonn siad chuig an modh oibríochta a bhíonn i bhfeidhm nuair nach mbíonn aon réad ann. I gcás list-components agus list-translations, má fhágtar an réad ar lár, iarrtar i gcónaí liosta a bhaineann leis an institiúid ina hiomláine.

Orduithe

Tá na horduithe seo a leanas ar fáil:

version

Priontálann an leagan reatha.

--bare

Ní phriontálann sé ach an uimhir leagain.

list-languages

Liostaíonn sé gach teanga i Weblate.

list-projects

Liostaíonn sé gach tionscadal i Weblate.

list-components

Liostaíonn sé na comhpháirteanna go léir i Weblate, nó na comhpháirteanna sa tionscadal sonraithe.

list-translations

Liostaíonn sé gach aistriúchán i Weblate, nó na haistriúcháin sa chomhpháirt shonraithe.

list-units

Liostaíonn sé aonaid sa aistriúchán sonraithe.

--query QUERY

Déanann sé scagadh ar aonaid ag baint úsáide as comhréir na gceisteanna cuardaigh.

show

Taispeánann sé tionscadal, comhpháirt, aistriúchán nó aonad.

delete

Scriosann sé tionscadal, comhpháirt, aistriúchán nó aonad gan leid dheimhnithe.

ls

Liostaíonn sé gach tionscadal nuair nach sonraítear aon réad, nó comhpháirteanna i dtionscadal, nó aistriúcháin i gcomhpháirt.

commit

Geallann sé athruithe a dhéantar ar réad Weblate (aistriúchán, comhpháirt nó tionscadal).

pull

Tarraingíonn cianathruithe stórtha isteach i réad Weblate (aistriúchán, comhpháirt nó tionscadal).

push

Athraíonn oibiacht Weblate a bhrú isteach i cianthaisc (aistriúchán, comhpháirt nó tionscadal).

reset

Athshocraigh athruithe ar oibiacht Weblate chun cianthaisc a mheaitseáil (aistriúchán, comhpháirt nó tionscadal).

cleanup

Baintear aon athruithe neamhrianaithe i réad Weblate chun teacht leis an gcianstór (aistriúchán, comhpháirt nó tionscadal).

repo

Taispeánann sé stádas stór do réad Weblate ar leith (aistriúchán, comhpháirt nó tionscadal).

stats

Taispeánann sé staitisticí mionsonraithe maidir le réad Weblate ar leith (aistriúchán, comhpháirt nó tionscadal).

lock-status

Taispeánann sé stádas glasála comhpháirte.

lock

Glasáil an chomhpháirt ó aistriúchán breise i Weblate.

unlock

Díghlasáiltear aistriúchán comhpháirt Weblate.

changes

Taispeánann sé athruithe do thionscadal, do chomhpháirt nó d’aistriúchán.

download

Íoslódálann sé comhaid aistriúcháin. I gcás aistriúcháin, scríobhann wlc an comhad chuig --output nó chuig an aschur caighdeánach atá atreoraithe. Diúltaíonn sé ábhar amh an chomhaid a scríobh chuig teirminéal idirghníomhach.

I gcás comhpháirte nó tionscadail, tá gá leis an rogha --output agus caitear leis mar eolaire. Scríobhann wlc cartlann ZIP amháin in aghaidh na comhpháirte. Mura sonraítear aon réad, íoslódálann sé gach comhpháirt sa bhunú Weblate ar an gcaoi chéanna.

--convert FORMAT

Iarrtar tiontú go FORMAT ar an bhfreastalaí. Mura sonraítear é, ní dhéantar aon tiontú.

--output PATH

Sonraítear leis an rogha seo an comhad aschuir le haghaidh aistriúcháin, nó an eolaire aschuir le haghaidh comhpháirte, tionscadail nó íoslódála ar leibhéal an tsampla. Bain úsáid as - chun aistriúchán a scríobh chuig an aschur caighdeánach.

--no-glossary

Eisítear comhpháirteanna foclóra ó íoslódálacha ag leibhéal na comhpháirte, an tionscadail agus an tsampla.

upload

Uaslódálann sé comhad aistriúcháin.

--overwrite

Sáraíonn sé teaghráin aistrithe atá ann cheana. Tá sé seo coibhéiseach le --conflicts replace-translated.

--conflicts {ignore,replace-translated,replace-approved}

Roghnaítear leis an gcaoi a láimhseáiltear coinbhleachtaí le haistriúcháin atá ann cheana.

--input PATH

Léitear ábhar ó PATH. Mura sonraítear é, nó má shonraítear -, léitear an t-ábhar ón ionchur caighdeánach.

--method {translate,approve,suggest,fuzzy,replace,source,add}

An modh uaslódála le húsáid; féach Modhanna allmhairithe. Is é translate an réamhshocrú.

--fuzzy {process,approve}

Roghnaíonn sé próiseáil teaghrán doiléir (atá marcáilte le haghaidh eagarthóireachta).

--author-name NAME

Ainm an údair, chun an t-úsáideoir fíordheimhnithe faoi láthair a shárú

--author-email EMAIL

Ríomhphost an údair, chun an t-úsáideoir fíordheimhnithe faoi láthair a shárú

edit-unit

Déanann sé nuashonrú ar aonad aistriúcháin. Teastaíonn rogha nuashonraithe amháin ar a laghad.

--target TARGET [TARGET ...]

Socraíonn sé teaghrán aistrithe amháin nó níos mó.

--state STATE

Socraíonn sé staid an aonaid: 0 le haghaidh folamh, 10 le haghaidh doiléir, 20 le haghaidh aistrithe, nó 30 le haghaidh ceadaithe.

--explanation EXPLANATION

Socraíonn sé an míniú téacs.

--extra-flags FLAGS

Socraíonn sé bratacha breise do shreanga.

Hint

Is féidir leat faisnéis níos mionsonraithe a fháil maidir le horduithe aonair a agairt trí --help a chur isteach, mar shampla: wlc ls --help.

Comhaid chumraíochta

Nuair a chuirtear --config ar fáil, ní luchtóidh wlc ach an comhad sin.

Gan --config, luchtóidh wlc an comhad cumraíochta domhanda a aimsíodh ar dtús ó na suíomhanna caighdeánacha ardáin-shonracha:

C:\Users\NAME\AppData\Roaming\weblate.ini

Comhad cumraíochta domhanda ar Windows sa phróifíl fánaíochta.

C:\Users\NAME\AppData\Local\weblate.ini

Comhad cumraíochta domhanda ar Windows sa phróifíl áitiúil.

~/.config/weblate

Comhad cumraíochta domhanda ar chórais cosúil le Unix.

~/.config/weblate.ini

Ainm comhaid malartach don chumraíocht dhomhanda ar chórais atá cosúil le Unix.

/etc/xdg/weblate

Comhad cumraíochta taca don chóras ar fad.

/etc/xdg/weblate.ini

Ainm comhaid malartach don chóras ar fad le húsáid mar chúltaca.

Leanann an clár sonraíocht XDG, mar sin is féidir leat suíomh na gcomhad cumraíochta a choigeartú de réir athróg timpeallachta XDG_CONFIG_HOME nó XDG_CONFIG_DIRS.

Ar Windows is iad na heolairí APPDATA agus LOCALAPPDATA na suíomhanna is fearr don chomhad cumraíochta.

Tar éis an chumraíocht dhomhanda a luchtú, luchtóidh wlc an comhad cumraíochta tionscadail is gaire ón eolaire reatha nó óna thuismitheoirí:

.weblate, .weblate.ini, weblate.ini

Comhad cumraíochta tionscadail curtha sa stórlann.

Luchtaítear cumraíocht an tionscadail tar éis na cumraíochta domhanda agus sáraíonn sí na socruithe comhfhreagracha. Is féidir léi URL an API, an réad réamhshocraithe, socruithe na n-iarratas agus eochair API (atá nasctha le URL áirithe) a roghnú; ar an gcaoi sin, is féidir le stórtha a chóipeáiltear freastalaí Weblate agus an t-aistriúchán cuí a roghnú go huathoibríoch.

Ní luchtaítear ach an comhad cumraíochta tionscadail is gaire. Déantar neamhaird de chomhaid chumraíochta i gcomhadlanna tuismitheora níos faide i gcéin.

Is féidir na socruithe seo a leanas a chumrú sa rannán [weblate] (is féidir leat é seo a shaincheapadh trí --config-section):

key

Removed in version 1.17: Úsáid an chuid [keys] chun eochracha a shonrú atá raon feidhme do URLanna API aonair, féach Cumraíocht oidhreachta.

url

URL freastalaí API, réamhshocraithe go http://127.0.0.1:8000/api/.

translation

Conair réamhshocraithe an réada le haghaidh orduithe a ghlacann le ceann amháin: tionscadal, comhpháirt, aistriúchán, nó uimhir aitheantais uimhriúil aonaid.

retries, timeout, allowed_methods, backoff_factor, status_forcelist

HTTP request retry and timeout settings. retries defaults to 0 and backoff_factor to 0. status_forcelist is a comma-separated list of HTTP status codes that trigger retries and is empty by default.

Liostaíonn allowed_methods na modhanna ar féidir iad a athiarrachtú, agus iad scartha le camóga nó le spásanna bána. Is iad HEAD, DELETE, OPTIONS, PUT agus GET na luachanna réamhshocraithe. Cuirtear na socruithe athiarrachta seo ar aghaidh chuig urllib3.util.Retry.

Is é timeout an t-am teorann don iarratas (i soicindí) agus is é 300 an luach réamhshocraithe. Úsáideann leaganacha reatha de wlc allowed_methods in áit na rovnaí method_whitelist a bhí ann roimhe seo.

Is comhad INI é an comhad cumraíochta, mar shampla:

[weblate]
url = https://hosted.weblate.org/api/
translation = weblate/application
retries = 3
allowed_methods = PUT,POST,GET
backoff_factor = 0.2
status_forcelist = 429,500,502,503,504
timeout = 30

Stóráiltear eochracha an API sa rannán [keys]:

[keys]
https://hosted.weblate.org/api/ = APIKEY

Cuireann sé seo ar do chumas eochracha a stóráil i do shocruithe pearsanta, agus an chumraíocht .weblate á húsáid ag an am céanna i stórlann VCS ionas go mbeidh a fhios ag wlc cén freastalaí ar cheart dó cumarsáid a dhéanamh leis. Baineann an cuardach [keys] leis an URL API cumraithe ina iomláine, seachas leis an mbunús líonra amháin.

Is féidir le cumraíocht an tionscadail iontráil chomhfhreagrach i [keys] a sholáthar nó a ionadú freisin. Ná cuir eochracha luachmhara API isteach sa chóras rialaithe leaganacha; de ghnáth, coinnigh na heochracha i gcumraíocht phearsanta agus ná fág ach URL an API agus an réad réamhshocraithe i gcumraíocht an tionscadail.

Stóráiltear eisceachtaí iompair neamhdhíslánacha i rannóga atá srianta don bhunús i gcumraíocht úsáideora iontaofa:

[insecure_http]
http://legacy.example.com:80 = true

[insecure_ssl]
https://legacy.example.com:443 = true

Cuimsíonn bunús (origin) an scéim, an t-ainm óstach normalaithe, agus an port éifeachtach. Déantar neamhaird de chonair an API, agus coinnítear scéimeanna agus poirt dhifriúla scartha óna chéile. Ceadaíonn an rannán [insecure_http] eochracha API a úsáid thar HTTP neamh-áitiúil i gcás bunúsanna a chomhlíonann na critéir. Díchumasaíonn an rannán [insecure_ssl] fíorú teastais TLS i gcás bunúsanna a chomhlíonann na critéir.

Changed in version 2.2.0: Déantar deimhnithe TLS a fhíorú do gach óstach de réir réamhshocraithe. Baineann cumraíocht neamhshlán HTTP agus TLS le bunúsanna (origins). Ní féidir le cumraíocht tionscadail a aimsítear go huathoibríoch iontrálacha a chur leis na rannáin seo ná na socruithe domhanda a baineadh amach a chumasú. Tugtar muinín do chumraíocht an úsáideora agus do chomhaid --config a roghnaíodh go sainráite.

I CI, ní mór d'eochracha neamhscóipeáilte an URL API a phionáil go sainráite: socraigh WLC_URL agus WLC_KEY araon, nó bain úsáid as --url mar aon le --key.

Athróga timpeallachta

Added in version 1.18.0.

Changed in version 2.0.1: Éilíonn eochracha API neamhscóipeáilte URL API sainráite nuair a aimsítear cumraíocht tionscadail go huathoibríoch. Diúltaítear d'eochracha API thar URLanna neamh-áitiúla http:// mura bhfuil HTTP neamhshlán cumasaithe go sainráite.

Changed in version 2.2.0: Éilíonn sáruithe ar an timpeallacht neamhshlán HTTP agus TLS an t-athróg WLC_URL i gcásanna ina dtiocfadh URL an API, murach sin, ó chumraíocht tionscadail a aimsíodh go huathoibríoch.

Is féidir URL agus eochair an API a chumrú ag baint úsáide as athróga comhshaoil freisin. Tá sé seo an-úsáideach go háirithe le haghaidh sreafaí oibre CI ina mbiorann WLC_URL an ceann scríbe agus ina n-instealltar WLC_KEY mar rún:

WLC_URL

URL API

WLC_KEY

Eochair API. Nuair a thiocfadh an URL API ó chumraíocht tionscadail a aimsítear go huathoibríoch murach sin, ní ghlactar le WLC_KEY ach amháin i dteannta WLC_URL. Diúltaítear eochracha API thar URLanna http:// neamh-áitiúla de réir réamhshocraithe.

WLC_ALLOW_INSECURE_HTTP

Socraigh é ar 1, true, yes, nó on chun úsáid eochracha API thar URLanna http:// neamh-áitiúla a cheadú. Is fearr HTTPS nó HTTP lúb-ais (loopback) a úsáid ina ionad sin. Déantar luachanna eile, amhail 0 nó false, a láimhseáil amhail is nach bhfuil aon luach socraithe. I gcásanna ina dtiocfadh URL an API ó chumraíocht tionscadail a aimsíodh go huathoibríoch murach sin, ní ghlactar leis an athróg seo ach amháin i gcomhar le WLC_URL.

WLC_ALLOW_INSECURE_SSL

Socraigh é ar 1, true, yes, nó on chun fíorú deimhnithe TLS a dhíchumasú. Déantar luachanna eile, amhail 0 nó false, a láimhseáil amhail is nach bhfuil aon luach socraithe. I gcásanna ina dtiocfadh URL an API de ghnáth ó chumraíocht tionscadail a aimsíodh go huathoibríoch, ní ghlactar leis an athróg seo ach amháin i gcomhar le WLC_URL.

Baineann an chosaint chéanna le hargóintí na líne orduithe: ní ghlactar leis na roghanna --key, --allow-insecure-http, agus --allow-insecure-ssl i gcomhcheangal le cumraíocht tionscadail a aimsítear go huathoibríoch ach amháin nuair a sholáthraítear --url.

Is é URL an API agus tosaíocht chumraíochta eochrach (ón gceann is airde go dtí an ceann is ísle) ná:

1. Argóintí líne ordaithe (--url, --key).

2. Athróga timpeallachta (WLC_URL, WLC_KEY).

3. Cumraíocht luchtaithe ó --config, nó ón gcumraíocht dhomhanda a aimsíodh móide an chumraíocht tionscadail is gaire nuair nach n-úsáidtear --config.

Ní socruithe gnáth-thosaíochta iad na roghanna iompair neamhshlávúla, ach socruithe a chuirtear i ngníomh amháin. Cuirtear i ngníomh iad trí ordú líne-orduithe nó trí shárú ar an timpeallacht, nó trí bhíthin tionscnaimh (origin) a mheaitseálann sa rannán iontaofa [insecure_http] nó [insecure_ssl]. Ní féidir le cumraíocht tionscadail a aimsítear go huathoibríoch tionscnaimh iontaofa a chur leis.

Múnla slándála

Is cuid de shreabhadh oibre an stórais é cumraíocht an tionscadail, agus tugtar muinín dó d’aon ghnó chun an pointe críche API, an réad réamhshocraithe, socruithe an iarratais, agus eochair API chomhfhreagrach (atá teoranta do URL áirithe) a roghnú. Nuair a rithetar wlc laistigh de stóras, tugtar údarás don chumraíocht tionscadail is gaire dó an freastalaí a roghnú a ghlacann le horduithe agus le h-uaslódálacha, agus a sholáthraíonn an t-ábhar a thaispeántar nó a íoslódáiltear. Bain úsáid as comhad --config sainráite agus iontaofa nuair nach bhfuil sé sin ag teastáil.

Glacann an cliant líne-ordaithe le heochracha API ó --key, WLC_KEY, nó ón rannán [keys]. Ní luchtar fíordheimhniú HTTP ó .netrc ná ón gcomhad a shonraítear le NETRC. Diúltaítear do dhintiúir atá leabaithe i URLanna API; bain úsáid as eochair API ina n-ionad. Fanann comhtháthú eile le timpeallacht Requests — lena n-áirítear athróga seachfhreastalaí agus braisle CA (CA-bundle) — gníomhach.

Déanann an tsamhail bhagairtí wlc doiciméadú ar na teorainneacha iomlána iontaoibhe, ar na hairíonna slándála, ar na nithe nach bhfuil mar spriocanna, agus ar na freagrachtaí iartheachtacha. Cuirtear cóip a fhreagraíonn don leagan san áireamh sna dáileacháin foinse agus 'wheel'. Déan tuairisciú ar shaincheisteanna slándála trí úsáid a bhaint as próiseas tuairiscithe leochaileachtaí Weblate.

Samplaí

Priontáil leagan reatha an chláir:

$ wlc version

Liostaigh gach tionscadal:

$ wlc list-projects
name: Hello
slug: hello
url: http://example.com/api/projects/hello/
web: https://weblate.org/
web_url: http://example.com/projects/hello/

Uaslódáil comhad aistriúcháin:

$ wlc upload project/component/language --input /tmp/hello.po

Is féidir leat a ainmniú freisin cén tionscadal wlc ba chóir a bheith ag obair air:

$ cat .weblate
[weblate]
url = https://hosted.weblate.org/api/
translation = weblate/application

$ wlc show
branch: main
file_format: po
source_language: en
filemask: weblate/locale/*/LC_MESSAGES/django.po
git_export: https://hosted.weblate.org/git/weblate/application/
license: GPL-3.0+
license_url: https://spdx.org/licenses/GPL-3.0+
name: Application
new_base: weblate/locale/django.pot
project: weblate
repo: git://github.com/WeblateOrg/weblate.git
slug: application
template:
url: https://hosted.weblate.org/api/components/weblate/application/
vcs: git
web_url: https://hosted.weblate.org/projects/weblate/application/

Leis an socrú seo is furasta athruithe a dhéanamh ar feitheamh ar an tionscadal reatha:

$ wlc commit