வலைபெயர்ப்பு கிளையன்ட்

நிறுவல்

The Weblate Client is shipped separately and includes the Python module. To use the commands below, you need to install wlc using pip:

pip install wlc

நீங்கள் அதை நேரடியாக uvx பயன்படுத்தி இயக்கலாம்:

uvx wlc --help

Hint

நீங்கள் இந்த wlc ஐ பைதான் தொகுதியாகவும் பயன்படுத்தலாம், பார்க்க wlc.

கப்பல்துறை பயன்பாடு

வலைபெயர்ப்பு வாங்கி ஒரு கப்பல்துறை படமாகவும் கிடைக்கிறது.

படம் கப்பல்துறை மையத்தில் வெளியிடப்பட்டுள்ளது: https://hub.docker.com/r/weblate/wlc

நிறுவுகிறது:

docker pull weblate/wlc

கப்பல்துறை கொள்கலன் வலைபெயர்ப்புடின் இயல்புநிலை அமைப்புகளைப் பயன்படுத்துகிறது மற்றும் உள்ளக ஓச்டில் பயன்படுத்தப்பட்ட பநிஇ உடன் இணைகிறது. வலைபெயர்ப்பு ஏற்றுக்கொண்ட வாதங்கள் மூலம் பநிஇ முகவரி மற்றும் api_key கட்டமைக்க முடியும்.

கொள்கலனைத் தொடங்குவதற்கான கட்டளை பின்வரும் தொடரியல் பயன்படுத்துகிறது:

docker run --rm weblate/wlc [WLC_ARGS]

உதாரணமாக:

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

நீங்கள் உங்கள் உள்ளமைவு கோப்புகள் ஐ கப்பல்துறை கொள்கலனுக்கு அனுப்ப விரும்பலாம். உங்கள் களஞ்சியத்தில் .weblate போன்ற திட்ட கட்டமைப்பு இருந்தால், உங்கள் தற்போதைய கோப்பகத்தை /home/weblate தொகுதியாக சேர்ப்பதே எளிதான வழி:

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

தொடங்குதல்

தொடங்குவதற்கான எளிதான வழி, தனிப்பட்ட wlc உள்ளமைவை ~/.config/weblate இல் உருவாக்குவது (முழு கண்டுபிடிப்பு விதிகள் மற்றும் பிற இடங்களுக்கு உள்ளமைவு கோப்புகள் ஐப் பார்க்கவும்):

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

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

இயல்புநிலை சேவையகத்தில் கட்டளைகளை நீங்கள் அழைக்கலாம்:

wlc ls
wlc commit sandbox/hello-world

See also

உள்ளமைவு கோப்புகள்

மரபு கட்டமைப்பு

Changed in version 1.17: வரம்பிடாத திறவுகோல் யைப் பயன்படுத்தும் மரபு உள்ளமைவு இனி ஆதரிக்கப்படாது.

மரபு உள்ளமைவை நகர்த்தவும்:

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

பநிஇ முகவரி க்கு விசையைக் கொண்டுள்ள கட்டமைப்பிற்கு:

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

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

சுருக்கம்

wlc [arguments] <command> [options]

கட்டளைகள் உண்மையில் எந்த செயல்பாட்டைச் செய்ய வேண்டும் என்பதைக் குறிக்கின்றன.

விளக்கம்

வலைபெயர்ப்பு வாங்கி என்பது பைதான் நூலகம் மற்றும் வலைபெயர்ப்பு ரெச்ட் பநிஇ ஐப் பயன்படுத்தி வெப்லேட்டை தொலைவிலிருந்து நிர்வகிக்கும் கட்டளை வரி பயன்பாடாகும். கட்டளை வரி பயன்பாடு wlc என அழைக்கப்படலாம் மற்றும் wlc இல் உள்ளமைக்கப்பட்டுள்ளது.

வாதங்கள்

வெளியீட்டு வடிவமைப்பை வரையறுக்கும் அல்லது பயன்படுத்த வேண்டிய வலைபெயர்ப்பு உதாரணத்தை நிரல் பின்வரும் வாதங்களை ஏற்றுக்கொள்கிறது. எந்தவொரு கட்டளைக்கும் முன் இவை உள்ளிடப்பட வேண்டும்.

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

வெளியீட்டு வடிவமைப்பைக் குறிப்பிடவும்.

--url URL

பநிஇ முகவரி ஐக் குறிப்பிடவும். உள்ளமைவு கோப்பில் காணப்படும் எந்த மதிப்பையும் மேலெழுதுகிறது, பார்க்கவும் உள்ளமைவு கோப்புகள். முகவரி ஆனது /api/ உடன் முடிவடைய வேண்டும், எடுத்துக்காட்டாக https://hosted.weblate.org/api/.

--key KEY

பயன்படுத்த பநிஇ பயனர் விசையைக் குறிப்பிடவும். உள்ளமைவு கோப்பில் காணப்படும் எந்த மதிப்பையும் மேலெழுதுகிறது, பார்க்கவும் உள்ளமைவு கோப்புகள். வலைபெயர்ப்பு இல் உங்கள் சுயவிவரத்தில் உங்கள் சாவியைக் காணலாம்.

--config PATH

கண்டறியப்பட்ட உலகளாவிய மற்றும் திட்ட உள்ளமைவு கோப்புகளுக்குப் பதிலாக PATH இலிருந்து மட்டுமே உள்ளமைவை ஏற்றவும், பார்க்கவும் உள்ளமைவு கோப்புகள்.

--config-section SECTION

பயன்பாட்டில் உள்ள உள்ளமைவு கோப்பு பிரிவை மேலெழுதுகிறது, பார்க்கவும் உள்ளமைவு கோப்புகள்.

கட்டளைகள்

பின்வரும் கட்டளைகள் கிடைக்கின்றன:

version

தற்போதைய பதிப்பை அச்சிடுகிறது.

list-languages

வலைபெயர்ப்பில் பயன்படுத்தப்பட்ட மொழிகள்.

list-projects

வலைபெயர்ப்பில் திட்டங்களை பட்டியலிடுகிறது.

list-components

வலைபெயர்ப்பில் கூறுகளை பட்டியலிடுகிறது.

list-translations

வலைபெயர்ப்பில் மொழிபெயர்ப்புகளை பட்டியலிடுகிறது.

show

வலைபெயர்ப்பு பொருளைக் காட்டுகிறது (மொழிபெயர்ப்பு, கூறு அல்லது திட்டம்).

ls

வலைபெயர்ப்பு பொருளை பட்டியலிடுகிறது (மொழிபெயர்ப்பு, கூறு அல்லது திட்டம்).

commit

வலைபெயர்ப்பு பொருளில் (மொழிபெயர்ப்பு, கூறு அல்லது திட்டம்) செய்யப்பட்ட மாற்றங்களைச் செய்கிறது.

pull

தொலை களஞ்சிய மாற்றங்களை வலைபெயர்ப்பு பொருளாக (மொழிபெயர்ப்பு, கூறு அல்லது திட்டம்) இழுக்கிறது.

push

வலைபெயர்ப்பு பொருள் மாற்றங்களை தொலை களஞ்சியத்தில் (மொழிபெயர்ப்பு, கூறு அல்லது திட்டம்) தள்ளுகிறது.

reset

தொலைநிலை களஞ்சியத்தை (மொழிபெயர்ப்பு, கூறு அல்லது திட்டம்) பொருத்த வலைபெயர்ப்பு பொருளின் மாற்றங்களை மீட்டமைக்கிறது.

cleanup

தொலைதூர களஞ்சியத்தை (மொழிபெயர்ப்பு, கூறு அல்லது திட்டம்) பொருத்த ஒரு வலைபெயர்ப்பு பொருளின் தடையற்ற மாற்றங்களை நீக்குகிறது.

repo

கொடுக்கப்பட்ட வலைபெயர்ப்பு பொருளுக்கான களஞ்சிய நிலையைக் காட்டுகிறது (மொழிபெயர்ப்பு, கூறு அல்லது திட்டம்).

stats

கொடுக்கப்பட்ட வலைபெயர்ப்பு பொருளுக்கான விரிவான புள்ளிவிவரங்களைக் காட்டுகிறது (மொழிபெயர்ப்பு, கூறு அல்லது திட்டம்).

lock-status

பூட்டு நிலையைக் காட்டுகிறது.

lock

வலைபெயர்ப்பில் மேலும் மொழிபெயர்ப்பிலிருந்து கூறு பூட்டுகிறது.

unlock

வலைபெயர்ப்பு கூறுகளின் மொழிபெயர்ப்பைத் திறக்கும்.

changes

கொடுக்கப்பட்ட பொருளுக்கான மாற்றங்களைக் காட்டுகிறது.

download

மொழிபெயர்ப்பு கோப்பை பதிவிறக்குகிறது.

--convert

குறிப்பிடப்படாத கோப்பு வடிவமைப்பை மாற்றவும் சேவையகத்தில் எந்த மாற்றமும் நடக்காது மற்றும் களஞ்சியத்தைப் போலவே கோப்பு பதிவிறக்கம் செய்யப்படுகிறது.

--output

வெளியீட்டைச் சேமிக்க கோப்பைக் குறிப்பிடுகிறது, குறிப்பிடப்படாமல் இருந்தால் அது stdout க்கு அச்சிடப்படுகிறது.

upload

மொழிபெயர்ப்பு கோப்பை பதிவேற்றுகிறது.

--overwrite

பதிவேற்றும்போது இருக்கும் மொழிபெயர்ப்புகளை மேலெழுதவும்.

--input

எந்த உள்ளடக்கத்திலிருந்து படிக்கப்படுகிறது, இது குறிப்பிடப்படாமல் இருந்தால் அது stdin இலிருந்து படிக்கப்படும்.

--method

பதிவேற்ற முறை பயன்படுத்த, பார்க்க இறக்குமதி முறைகள்.

--fuzzy

தெளிவற்ற (திருத்துவதற்காகக் குறிக்கப்பட்டது) சரங்கள் செயலாக்கம் (காலி, செயல்முறை, அனுமதி)

--author-name

ஆசிரியரின் பெயர், தற்போது அங்கீகரிக்கப்பட்ட பயனரை மீறுவதற்கு

--author-email

தற்போது அங்கீகரிக்கப்பட்ட பயனரை மேலெழுத ஆசிரியர் மின்னஞ்சல்

Hint

--help ஐக் கடப்பதன் மூலம் தனிப்பட்ட கட்டளைகளை செயல்படுத்துவது பற்றிய விரிவான தகவல்களைப் பெறலாம், எடுத்துக்காட்டாக: wlc ls --help.

உள்ளமைவு கோப்புகள்

--config வழங்கப்பட்டால், wlc அந்தக் கோப்பை மட்டும் ஏற்றுகிறது.

--config இல்லாமல், wlc கண்டறியப்பட்ட உலகளாவிய உள்ளமைவு கோப்பை முதலில் நிலையான இயங்குதளம் சார்ந்த இடங்களிலிருந்து ஏற்றுகிறது:

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

ரோம் செய்யப்பட்ட சுயவிவரத்தில் சாளரங்களில் உலகளாவிய உள்ளமைவு கோப்பு.

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

உள்ளக சுயவிவரத்தில் சாளரங்கள் இல் உலகளாவிய கட்டமைப்பு கோப்பு.

~/.config/weblate

யூனிக்ச் போன்ற கணினிகளில் உலகளாவிய கட்டமைப்பு கோப்பு.

/etc/xdg/weblate

சிச்டம் முழுவதும் ஃபால்பேக் உள்ளமைவு கோப்பு.

நிரல் XDG விவரக்குறிப்பைப் பின்பற்றுகிறது, எனவே நீங்கள் சூழல் மாறிகள் XDG_CONFIG_HOME அல்லது XDG_CONFIG_DIRS மூலம் கட்டமைப்பு கோப்புகளின் இடத்தை சரிசெய்யலாம்.

சாளரங்கள் இல் APPDATA மற்றும் LOCALAPPDATA கோப்பகங்கள் உள்ளமைவு கோப்பிற்கான விருப்பமான இடங்களாகும்.

உலகளாவிய உள்ளமைவை ஏற்றிய பிறகு, wlc தற்போதைய கோப்பகத்திலிருந்து அல்லது அதன் பெற்றோரிடமிருந்து அருகிலுள்ள திட்ட கட்டமைப்பு கோப்பை ஏற்றுகிறது:

.weblate, .weblate.ini, weblate.ini

திட்ட கட்டமைப்பு கோப்பு களஞ்சியத்தில் வைக்கப்பட்டுள்ளது.

மிக நெருக்கமான திட்ட கட்டமைப்பு கோப்பு மட்டுமே ஏற்றப்பட்டது. தொலைதூர பெற்றோர் கோப்பகங்களில் உள்ள கட்டமைப்பு கோப்புகள் புறக்கணிக்கப்படுகின்றன.

பின்வரும் அமைப்புகளை [weblate] பிரிவில் உள்ளமைக்க முடியும் (இதை நீங்கள் --config-section மூலம் தனிப்பயனாக்கலாம்):

key

Removed in version 1.17: தனிப்பட்ட பநிஇ URLகளுக்கான விசைகளைக் குறிப்பிட [விசைகள்] பிரிவைப் பயன்படுத்தவும், பார்க்கவும் மரபு கட்டமைப்பு.

url

பநிஇ சர்வர் URL, இயல்புநிலையாக http://127.0.0.1:8000/api/.

translation

இயல்புநிலை மொழிபெயர்ப்புக்கான பாதை - கூறு அல்லது திட்டம்.

retries, timeout, allowed_methods, backoff_factor, status_forcelist

Optional HTTP retry and timeout settings passed to urllib3. Use allowed_methods to list the request methods that may be retried. Current wlc releases use this setting name in place of the older method_whitelist option.

உள்ளமைவு கோப்பு ஒரு இனி கோப்பு, எடுத்துக்காட்டாக:

[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

பநிஇ விசைகள் [விசைகள்] பிரிவில் சேமிக்கப்படுகின்றன:

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

This allows you to store keys in your personal settings, while using the .weblate configuration in the VCS repository so that wlc knows which server it should talk to. In CI, keep only the repository configuration in version control and inject the API key using WLC_KEY.

சுற்றுச்சூழல் மாறிகள்

Added in version 1.18.0.

சூழல் மாறிகளைப் பயன்படுத்தி பநிஇ முகவரி மற்றும் விசையையும் கட்டமைக்க முடியும். தொஒ பணிப்பாய்வுகளுக்கு இது மிகவும் பயனுள்ளதாக இருக்கும், அங்கு களஞ்சியம் திட்ட கட்டமைப்பை வழங்குகிறது மற்றும் WLC_KEY ஒரு ரகசியமாக உட்செலுத்தப்படுகிறது:

WLC_URL

பநிஇ முகவரி

WLC_KEY

பநிஇ விசை

உள்ளமைவு முன்னுரிமை (அதிகமானது முதல் குறைந்தது):

1. கட்டளை வரி வாதங்கள் (--url, --key).

2. சுற்றுச்சூழல் மாறிகள் (WLC_URL, WLC_KEY).

3. உள்ளமைவு --config இலிருந்து ஏற்றப்பட்டது, அல்லது கண்டுபிடிக்கப்பட்ட உலகளாவிய உள்ளமைவிலிருந்து மற்றும் --config பயன்படுத்தப்படாதபோது அருகிலுள்ள திட்ட உள்ளமைவு.

எடுத்துக்காட்டுகள்

தற்போதைய நிரல் பதிப்பை அச்சிடுக:

$ wlc version
version: 0.1

அனைத்து திட்டங்களையும் பட்டியலிடுங்கள்:

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

மொழிபெயர்ப்பு கோப்பைப் பதிவேற்றவும்:

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

நீங்கள் எந்த திட்டத்தில் wlc வேலை செய்ய வேண்டும் என்பதையும் குறிப்பிடலாம்:

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

இந்த அமைப்பின் மூலம் தற்போதைய திட்டத்தில் நிலுவையில் உள்ள மாற்றங்களைச் செய்வது எளிது:

$ wlc commit