Cliant Gréasáin

Suiteáil

Seoltar an Cliant Weblate ar leithligh agus áirítear leis an modúl Python. Chun na horduithe thíos a úsáid, ní mór duit wlc a shuiteáil ag baint úsáide as 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.

Tá an íomhá foilsithe ar Docker Hub: https://hub.docker.com/r/weblate/wlc

Suiteáil:

docker pull weblate/wlc

Úsáideann an coimeádán Docker socruithe réamhshocraithe Weblate agus nascann sé leis an API a imlonnaítear in localhost. Is féidir URL an API agus API_KEY a chumrú trí na hargóintí a nglacann Weblate leo.

Ú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

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.

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 áirgiúlacht ordú-líne é Weblate Cliant chun Weblate a bhainistiú go cianda ag baint úsáide as API REST Weblate. Is féidir an áirgiúlacht líne ordaithe a agairt mar wlc agus tá sé ionsuite ar wlc.

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.

--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 aimsiú i do phróifíl ar Weblate.

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

Sáraítear an roinn comhaid cumraíochta atá in úsáid, féach Comhaid chumraíochta.

Orduithe

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

version

Priontálann an leagan reatha.

list-languages

Liostaíonn na teangacha a úsáidtear i Weblate.

list-projects

Liostaíonn sé na tionscadail i Weblate.

list-components

Liostaíonn sé comhpháirteanna i Weblate.

list-translations

Liostaíonn sé aistriúcháin i Weblate.

show

Taispeáin réad Weblate (aistriúchán, comhpháirt nó tionscadal).

ls

Liostaíonn réad Weblate (aistriúchán, comhpháirt nó tionscadal).

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

Léiríonn stádas glasála.

lock

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

unlock

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

changes

Taispeáin athruithe do réad ar leith.

download

Íosluchtaigh comhad aistriúcháin.

--convert

Athraíonn sé formáid comhaid, mura dtarlaíonn comhshó ar an bhfreastalaí mura bhfuil sé sonraithe agus íoslódáltar an comhad mar atá chuig an stór.

--output

Sonraítear an comhad chun an t-aschur a shábháil ann, má fhágtar é gan sonraíocht clóitear é chuig stdout.

upload

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

--overwrite

Forscríobh aistriúcháin atá ann cheana féin agus iad á n-uaslódáil.

--input

Comhad óna léitear ábhar, mura bhfuil sé sonraithe léitear é ó stdin.

--method

Modh uaslódáil le húsáid, féach Modhanna allmhairithe.

--fuzzy

Próiseáil teaghráin doiléir (marcáilte le haghaidh eagarthóireachta) (folamh, próiseas, faomh)

--author-name

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

--author-email

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

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.

/etc/xdg/weblate

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

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.

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 chuig an aistriúchán réamhshocraithe - comhpháirt nó tionscadal.

retries, timeout, allowed_methods, backoff_factor, status_forcelist

Socruithe roghnacha athiarrachta agus sos ama HTTP curtha chuig urllib3. Úsáid allowed_methods chun na modhanna iarrata is féidir a athiarracht a liostáil. Úsáideann na heisiúintí reatha wlc an t-ainm socraithe seo in ionad an rogha method_whitelist atá ann cheana.

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

Ligeann sé seo duit eochracha a stóráil i do shocruithe pearsanta, agus an chumraíocht .weblate á húsáid agat sa stór VCS ionas go mbeidh a fhios ag wlc cén freastalaí ba chóir dó labhairt leis. I CI, coinnigh cumraíocht an stórais amháin i rialú leaganacha agus instealladh an eochair API ag baint úsáide as WLC_KEY.

Athróga timpeallachta

Added in version 1.18.0.

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 soláthraíonn an stór cumraíocht an tionscadail agus ina n-instealltar WLC_KEY mar rún:

WLC_URL

URL API

WLC_KEY

Eochair API

Is é seo an tosaíocht chumraíochta (ón gceann is airde go dtí an ceann is ísle):

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.

Samplaí

Priontáil leagan reatha an chláir:

$ wlc version
version: 0.1

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