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

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 ar aghaidh chuig an gcoimeádán Docker, is é an cur chuige is éasca ná do chomhadlann reatha a chur leis mar /home/weblate toirt:

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

Ag tosú

Stóráiltear an chumraíocht wlc i ~/.config/weblate (féach Comhaid chumraíochta le haghaidh láithreacha eile), cruthaigh é chun teacht le do thimpeallacht:

[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

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

Sáraíonn sé conair an chomhaid chumraíochta, 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

.weblate, .weblate.ini, weblate.ini

Comhad cumraíochta curtha san eolaire tionscadail.

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

Comhad cumraíochta úsáideora ar Windows sa phróifíl fánaíochta.

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

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

~/.config/weblate

Comhad cumraíochta úsáideora.

/etc/xdg/weblate

Comhad cumraíochta ar fud an chórais.

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.

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

API EOCHAIR chun rochtain a fháil ar Weblate.

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.

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

[weblate]
url = https://hosted.weblate.org/api/
key = APIKEY
translation = weblate/application

Ina theannta sin is féidir eochracha API a stóráil sa rannán [eochracha]:

[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 in úsáid sa stór VCS ionas go mbeidh a fhios ag wlc cén freastalaí ar cheart dó labhairt leis.

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