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

நிறுவல்

Weblate Client தனித்தனியாக அனுப்பப்பட்டு, பைதான் தொகுதியும் அடங்கும். கீழே உள்ள கட்டளைகளைப் பயன்படுத்த, நீங்கள் pip ஐப் பயன்படுத்தி wlc ஐ நிறுவ வேண்டும்:

pip install wlc

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

uvx wlc --help

Hint

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

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

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

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

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

docker pull weblate/wlc

The Docker container uses Weblate Client defaults and connects to the API deployed on localhost. Configure the API URL and API key using the normal wlc arguments or environment variables, for example --url, --key, WLC_URL, and WLC_KEY. API keys are rejected over non-local http:// URLs by default; use HTTPS, loopback HTTP for local development, or explicitly opt in to insecure HTTP.

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

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

When the mounted repository provides the API URL in project configuration and you pass an unscoped API key to the container, also pin the URL explicitly: WLC_KEY requires WLC_URL, and --key requires --url.

If the configured API URL uses non-local http:// and an API key is provided, the container refuses to send the key unless insecure HTTP is explicitly enabled. Prefer HTTPS; for legacy deployments, pass --allow-insecure-http or set WLC_ALLOW_INSECURE_HTTP.

தொடங்குதல்

தொடங்குவதற்கான எளிதான வழி, தனிப்பட்ட 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

Specify the API user key to use. Overrides any value found in the configuration file, see உள்ளமைவு கோப்புகள். You can find your key in your profile on Weblate. When the API URL is loaded from automatically discovered project configuration, --key must be used together with --url. API keys are rejected over non-local http:// URLs by default.

--allow-insecure-http

Allow sending API keys over non-local http:// URLs. Prefer HTTPS or loopback HTTP instead; this option is intended only for legacy deployments where HTTPS is not available. This option only enables insecure HTTP for the current run; omitting it does not disable allow_insecure_http from configuration.

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

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

allow_insecure_http

Allow API keys over non-local http:// URLs, defaults to false. Loopback HTTP URLs, such as http://127.0.0.1:8000/api/, remain allowed for local development without this option. Prefer HTTPS instead of enabling this setting. Automatically discovered project configuration files cannot enable this option; set it in user configuration, an explicit --config file, WLC_ALLOW_INSECURE_HTTP, or --allow-insecure-http. The setting is cumulative: any trusted source that enables insecure HTTP is enough, and false or unset values from command-line or environment sources do not disable it.

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
allow_insecure_http = false

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

[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. The [keys] lookup is scoped to the exact API URL.

In CI, unscoped keys must pin the API URL explicitly: set both WLC_URL and WLC_KEY, or use --url together with --key.

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

Added in version 1.18.0.

Changed in version 2.0.1: Unscoped API keys require an explicit API URL when project configuration is discovered automatically. API keys are rejected over non-local http:// URLs unless insecure HTTP is explicitly enabled.

The API URL and key can also be configured using environment variables. This is especially useful for CI workflows where WLC_URL pins the destination and WLC_KEY is injected as a secret:

WLC_URL

பநிஇ முகவரி

WLC_KEY

API key. When the API URL would otherwise come from automatically discovered project configuration, WLC_KEY is accepted only together with WLC_URL. API keys are rejected over non-local http:// URLs by default.

WLC_ALLOW_INSECURE_HTTP

Set to 1, true, yes, or on to allow API keys over non-local http:// URLs. Prefer HTTPS or loopback HTTP instead. Other values, such as 0 or false, are treated as unset and do not disable allow_insecure_http from configuration.

The same protection applies to command-line arguments: --key is accepted with automatically discovered project configuration only when --url is provided.

The API URL and key configuration precedence (highest to lowest) is:

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

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

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

The insecure HTTP opt-in is enable-only rather than a normal precedence setting. It is enabled when --allow-insecure-http is passed, when WLC_ALLOW_INSECURE_HTTP has a true value, or when allow_insecure_http is enabled in trusted configuration. Automatically discovered project configuration cannot enable it; set it in user configuration or pass an explicit --config file instead.

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

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

$ 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