관리 명령어¶

참고

웹 서버를 실행하는 사용자와 다른 사용자로 관리 명령을 실행하면 파일에 잘못된 권한이 부여될 수 있습니다. 자세한 내용은 파일 시스템 권한 를 확인하세요.

기본 관리 명령을 찾을 수 있습니다 (Django 소스의 ./manage.py 로 사용 가능하거나, Weblate 위에 설치 가능한 weblate 라는 스크립트에서 확장 세트로 사용 가능).

관리 명령 호출¶

앞에서 언급했듯이 호출 방법은 Weblate를 어떻게 설치했는지에 따라 다릅니다.

Weblate에 Python 환경을 사용하는 경우 weblate 의 전체 경로를 지정하거나 호출하기 전에 Python 환경을 활성화할 수 있음:

# Direct invocation
~/weblate-env/bin/weblate

# Activating Python environment adds it to search path
. ~/weblate-env/bin/activate
weblate

소스 코드를 직접 사용하는 경우 (tarball 또는 Git 체크아웃에서) 관리 스크립트는 Weblate 소스에서 사용 가능한 ./manage.py 입니다. 실행하려면:

python ./manage.py list_versions

pip 설치 프로그램 또는 ./setup.py 스크립트를 사용하여 Weblate를 설치했다면 weblate 가 경로(또는 Python 환경 경로)에 설치되어 이를 사용하여 Weblate를 제어할 수 있음:

weblate list_versions

Docker 이미지의 경우 위와 같이 스크립트가 설치되며 docker exec 를 사용하여 실행할 수 있음:

docker exec --user weblate <container> weblate list_versions

docker-compose-plugin 의 경우 프로세스가 비슷하며 docker compose exec 를 사용하기만 하면 됨:

docker compose exec --user weblate weblate weblate list_versions

파일을 전달해야 하는 경우 임시로 볼륨을 추가할 수 있음:

docker compose exec --user weblate /tmp:/tmp weblate weblate importusers /tmp/users.json

add_suggestions¶

weblate add_suggestions <project> <component> <language> <file>¶

파일에서 번역을 가져와 해당 번역의 제안으로 사용합니다. 중복된 번역은 건너뛰며, 다른 것만 추가됩니다.

--author USER@EXAMPLE.COM¶: E-mail of author for the suggestions. This user has to exist prior to importing (you can create one in the admin interface if needed).

예시:

weblate --author michal@cihar.com add_suggestions weblate application cs /tmp/suggestions-cs.po

analyze_translator_work¶

weblate analyze_translator_work¶

Analyzes change history to estimate realistic translator throughput per day. The command includes only active human users and unit-backed manual translation changes, and applies daily minimum and maximum thresholds to skip obvious outliers, bots, bulk imports, uploads, and other events that would pollute the result.

--days DAYS¶: Number of recent days to analyze when --since is not specified.

--since YYYY-MM-DD¶: Start date for the analysis.

--until YYYY-MM-DD¶: End date for the analysis.

--project PROJECT¶: Limit the analysis to a project slug.

--component PROJECT/COMPONENT¶: Limit the analysis to a component.

--language LANGUAGE¶: Limit the analysis to a language code.

--min-changes COUNT¶: Minimum translated strings per user day to include.

--max-changes COUNT¶: Maximum translated strings per user day to include.

--max-words COUNT¶: Maximum translated source words per user day to include.

예시:

weblate analyze_translator_work --project weblate --since 2026-01-01

auto_translate¶

weblate auto_translate <project> <component> <language>¶

버전 4.6에서 변경: 번역 모드에 대한 매개변수가 추가되었습니다.

다른 구성요소 번역을 기반으로 자동 번역을 수행합니다.

--source PROJECT/COMPONENT¶: Specifies the component to use as source available for translation. If not specified all components in the project are used.

--user USERNAME¶: Specify username listed as author of the translations. “Anonymous user” is used if not specified.

--overwrite¶: Whether to overwrite existing translations.

--inconsistent¶: Whether to overwrite existing translations that are inconsistent (see 일관성 없음).

--add¶: Automatically add language if a given translation does not exist.

--mt MT¶: Use machine translation instead of other components as machine translations.

--threshold THRESHOLD¶: Similarity threshold for machine translation, defaults to 80.

--mode MODE¶: Specify translation mode, default is translate but fuzzy or suggest can be used.

예시:

weblate auto_translate --user nijel --inconsistent --source weblate/application weblate website cs

자동 번역

backup¶

weblate backup¶

Celery를 사용하지 않고 구성된 백업을 동기적으로 실행합니다. 먼저 DATA_DIR 의 설정 및 데이터베이스 백업 덤프를 업데이트한 다음 선택한 Borg 백업 서비스 또는 서비스들을 실행합니다.

--list¶: Lists configured backup service IDs.

--service ID¶: Runs one backup service by ID.

--all¶: Runs all enabled backup services.

백업 서비스 출력을 표시하려면 Django 표준 --verbosity 2 옵션을 사용하세요. 실패한 백업 서비스 출력은 verbosity를 높이지 않아도 표시됩니다.

예시:

weblate backup --list
weblate backup --service 1 --verbosity 2
weblate backup --all

Docker Compose 배포에서는 일반 Weblate 컨테이너를 중지하고 docker compose run 을 사용하여 일회성 컨테이너에서 명령을 실행할 수 있습니다. 데이터베이스와 구성된 백업 저장소는 계속 사용할 수 있어야 합니다.

docker compose stop weblate
docker compose run --rm --user weblate weblate weblate backup --list
docker compose run --rm --user weblate weblate weblate backup --service 1 --verbosity 2

BorgBackup을 사용한 자동 백업

benchmark¶

weblate benchmark¶

주어진 콘텐츠를 Weblate로 가져옵니다. 벤치마킹에 유용합니다.

성능 프로파일링 예시¶

# Run benchmark with a profiling
python -m cProfile -o benchmark.prof ./manage.py benchmark --project benchmark --filemask '*.tbx' --format tbx --zipfile /tmp/MicrosoftTermCollection2.zip

# Convert to SVG for visualization
uvx gprof2dot -f pstats benchmark.prof | dot -Tsvg -o benchmark.svg

# Display SVG
firefox ./benchmark.svg

메모리 프로파일링 예시¶

# Run benchmark under memray
uvx memray run ./manage.py benchmark --project benchmark --filemask '*.tbx' --format tbx --zipfile /tmp/MicrosoftTermCollection2.zip

# Render the profile
uvx memray flamegraph ./memray-manage.py.2554179.bin

# Display it
fixefox memray-flamegraph-manage.py.2554179.html

billing_demo¶

weblate billing_demo¶

Added in version 5.15.

데모 결제 프로젝트를 만듭니다. 추가 청구서 및 결제 이벤트를 추가하기 위해 여러 번 실행할 수 있습니다.

Weblate 개발 시 유용합니다. 결제 이 설치되어 있어야 합니다.

celery_queues¶

weblate celery_queues¶

Celery 작업 큐의 길이를 표시합니다.

백그라운드 작업 내부 구조

checkgit¶

weblate checkgit <project|project/component>¶

백엔드 Git 저장소의 현재 상태를 출력합니다.

업데이트할 프로젝트 또는 구성요소를 정의하거나 (예: weblate/application) --all 을 사용하여 모든 기존 구성요소를 업데이트할 수 있습니다.

commitgit¶

weblate commitgit <project|project/component>¶

백엔드 Git 저장소에 가능한 모든 보류 중인 변경사항을 커밋합니다.

업데이트할 프로젝트 또는 구성요소를 정의하거나 (예: weblate/application) --all 을 사용하여 모든 기존 구성요소를 업데이트하거나, --file-format 을 사용하여 파일 형식별로 필터링할 수 있습니다.

commit_pending¶

weblate commit_pending <project|project/component>¶

주어진 기간보다 오래된 보류 중인 변경사항을 커밋합니다.

업데이트할 프로젝트 또는 구성요소를 정의하거나 (예: weblate/application) --all 을 사용하여 모든 기존 구성요소를 업데이트할 수 있습니다.

--age HOURS¶: Age in hours for committing. If not specified the value configured in 구성요소 설정 is used.

참고

Weblate가 백그라운드에서 자동으로 수행하므로, 구성요소 설정 에 지정된 것보다 이른 커밋을 강제하는 경우가 아니라면 수동으로 호출할 필요가 없습니다.

cleanuptrans¶

weblate cleanuptrans¶

고아 검사 및 번역 제안을 정리합니다. 정리가 백그라운드에서 자동으로 이루어지므로 일반적으로 수동으로 실행할 필요가 없습니다.

유지보수 작업 실행

cleanup_memory¶

weblate cleanup_memory¶

Added in version 5.13.

번역 메모리에서 보류 상태의 모든 오래된 항목을 제거합니다.

cleanup_ssh_keys¶

weblate cleanup_ssh_keys¶

Added in version 4.9.1.

저장된 SSH 호스트 키의 정리를 수행함:

GitHub 연결에 문제를 일으킬 수 있는 더 이상 사용되지 않는 GitHub용 RSA 키를 제거합니다.
호스트 키의 중복 항목을 제거합니다.

SSH 저장소

createadmin¶

weblate createadmin¶

지정하지 않은 경우 무작위 비밀번호로 admin 계정을 생성합니다.

--password PASSWORD¶: Provides a password on the command-line, to not generate a random one.

--no-password¶: Do not set password, this can be useful with –update.

--username USERNAME¶: Use the given name instead of admin.

--email USER@EXAMPLE.COM¶: Specify the admin e-mail address.

--name¶: Specify the admin name (visible).

--update¶: Update the existing user (you can use this to change passwords).

dump_memory¶

weblate dump_memory¶

Weblate 번역 메모리 내용이 포함된 JSON 파일을 내보냅니다.

dumpuserdata¶

weblate dumpuserdata <file.json>¶

importuserdata 에서 나중에 사용할 수 있도록 사용자 데이터를 파일로 덤핑합니다.

힌트

Weblate 인스턴스를 마이그레이션하거나 병합할 때 유용합니다.

import_demo¶

weblate import_demo¶

Added in version 4.1.

<https://github.com/WeblateOrg/demo>를 기반으로 구성요소가 포함된 데모 프로젝트를 만듭니다. 이 명령을 실행하기 전에 Celery 작업이 실행 중인지 확인하세요.

Weblate 개발 시 유용합니다.

--delete¶: Removes existing demo project.

import_json¶

weblate import_json <json-file>¶

JSON 데이터를 기반으로 한 구성요소 일괄 가져오기.

가져온 JSON 파일 구조는 구성요소 객체에 거의 대응합니다 ( GET /api/components/(string:project)/(string:component)/ 참조). name 및 filemask 필드를 포함해야 합니다.

--project PROJECT¶: Specifies where the components will be imported from.

--main-component COMPONENT¶: Use the given VCS repository from this component for all of them.

--ignore¶: Skip (already) imported components.

--update¶: Update (already) imported components.

JSON 파일 예시:

[
  {
    "slug": "po",
    "name": "Gettext PO",
    "file_format": "po",
    "filemask": "po/*.po",
    "new_lang": "none"
  },
  {
    "name": "Android",
    "filemask": "android/values-*/strings.xml",
    "template": "android/values/strings.xml",
    "repo": "weblate://test/test",
    "file_format": "aresource"
  }
]

import_memory

import_memory¶

weblate import_memory <file>¶

파일을 Weblate 번역 메모리로 가져옵니다.

지원되는 파일 형식은 TMX, JSON, XLIFF, PO, CSV입니다.

JSON 및 TMX 이외의 형식의 경우 원문 언어와 대상 언어를 지정해야 할 수 있습니다.

--language-map LANGMAP¶

Allows mapping languages in the TMX to the Weblate translation memory. The language codes are mapped after normalization usually done by Weblate.

--language-map en_US:en will for example import all en_US strings as en ones.

This can be useful in case your TMX file locales happen not to match what you use in Weblate.

--source-language SOURCE_LANG¶: Specifies the source language for imported translations. Typically needed for formats where the languages cannot be determined from the file itself.

--target-language TARGET_LANG¶: Specifies the target language for imported translations. Typically needed for formats where the languages cannot be determined from the file itself.

import_project¶

weblate import_project <project> <gitrepo> <branch> <filemask>¶

파일 마스크를 기반으로 프로젝트에 구성요소를 일괄 가져옵니다. 구성요소 발견 애드온을 기반으로 하므로 대신 이를 사용하는 것이 좋을 수 있습니다.

<project> 는 구성요소를 가져올 기존 프로젝트의 이름입니다.

<gitrepo> 는 사용할 Git 저장소 URL을 정의하고, <branch> 는 Git 브랜치를 표시합니다. 기존 Weblate 구성요소에서 추가 번역 구성요소를 가져오려면 <gitrepo> 에 weblate://<project>/<component> URL을 사용하세요.

<filemask> 는 저장소에 대한 파일 검색을 정의합니다. 와일드카드를 사용하여 간단하게 만들거나 정규 표현식의 모든 기능을 사용할 수 있습니다.

단순 매칭은 구성요소 이름에 **, 언어에 * 를 사용합니다. 예: **/*.po

정규 표현식에는 component 와 language 라는 이름의 그룹이 포함되어야 합니다. 예: (?P<language>[^/]*)/(?P<component>[^-/]*)\.po.

가져오기는 파일을 기반으로 기존 구성요소를 매칭하고 존재하지 않는 것을 추가합니다. 이미 존재하는 것은 변경하지 않습니다.

--name-template TEMPLATE¶

Customize the name of a component using Django template syntax.

For example: Documentation: {{ component }}

--base-file-template TEMPLATE¶

Customize the base file for monolingual translations.

For example: {{ component }}/res/values/string.xml

--new-base-template TEMPLATE¶

Customize the base file for addition of new translations.

For example: {{ component }}/ts/en.ts

--file-format FORMAT¶: You can also specify the file format to use (see 현지화 파일 형식), the default is auto-detection.

--language-regex REGEX¶: You can specify language filtering (see 구성요소 설정) with this parameter. It has to be a valid regular expression.

--main-component¶: You can specify which component will be chosen as the main one—the one actually containing the VCS repository.

--license NAME¶: Specify the overall, project or component translation license.

--license-url URL¶: Specify the URL where the translation license is to be found.

--vcs NAME¶: In case you need to specify which version control system to use, you can do it here. The default version control is Git.

몇 가지 예를 들어 두 프로젝트를 가져오는 방법을 살펴보겠습니다.

먼저 각 언어에 각 장의 번역이 포함된 별도의 폴더가 있는 Debian Handbook 번역:

weblate import_project \
    debian-handbook \
    https://salsa.debian.org/hertzog/debian-handbook.git \
    bullseye/main \
    '*/**.po'

다음으로 파일 형식과 기본 파일 템플릿, 모든 구성요소와 번역이 단일 폴더에 위치하는 방법을 지정해야 하는 Tanaguru 도구:

weblate import_project \
    --file-format=properties \
    --base-file-template=web-app/tgol-web-app/src/main/resources/i18n/%s-I18N.properties \
    tanaguru \
    https://github.com/Tanaguru/Tanaguru \
    master \
    web-app/tgol-web-app/src/main/resources/i18n/**-I18N_*.properties

src/security/Numerous_security_holes_in_0.10.1.de.po 와 같은 파일 이름에서 올바른 구성요소와 언어를 얻기 위한 더 복잡한 파일 이름 파싱 예시:

weblate import_project \
    tails \
    git://git.tails.boum.org/tails master \
    'wiki/src/security/(?P<component>.*)\.(?P<language>[^.]*)\.po$'

선택한 언어의 번역만 필터링:

./manage import_project \
    --language-regex '^(cs|sk)$' \
    weblate \
    https://github.com/WeblateOrg/weblate.git \
    'weblate/locale/*/LC_MESSAGES/**.po'

여러 파일로 분할된 Sphinx 문서 가져오기:

$ weblate import_project --name-template 'Documentation: %s' \
    --file-format po \
    project https://github.com/project/docs.git master \
    'docs/locale/*/LC_MESSAGES/**.po'

여러 파일과 디렉터리로 분할된 Sphinx 문서 가져오기:

$ weblate import_project --name-template 'Directory 1: %s' \
    --file-format po \
    project https://github.com/project/docs.git master \
    'docs/locale/*/LC_MESSAGES/dir1/**.po'
$ weblate import_project --name-template 'Directory 2: %s' \
    --file-format po \
    project https://github.com/project/docs.git master \
    'docs/locale/*/LC_MESSAGES/dir2/**.po'

더 자세한 예시는 국제화 시작하기 장에서 찾을 수 있으며, import_json 을 사용할 수도 있습니다.

import_projectbackup¶

weblate import_projectbackup <project_name> <project_slug> <username> <filename>¶

Added in version 5.10.

프로젝트 수준 백업 를 가져옵니다.

힌트

일반적으로 번역 프로젝트 및 구성요소 추가 를 가져올 때 더 편안합니다.

importuserdata¶

weblate importuserdata <file.json>¶

dumpuserdata 로 만든 파일에서 사용자 데이터를 가져옵니다.

importusers¶

weblate importusers --check <file.json>¶

Django auth_users 데이터베이스의 JSON 덤프에서 사용자를 가져옵니다.

--check¶: With this option it will just check whether a given file can be imported and report possible conflicts arising from usernames or e-mails.

다음을 사용하여 기존 Django 사이트에서 사용자를 덤프할 수 있음:

./manage.py dumpdata auth.User > users.json

힌트

사용자 설정도 포함되므로 다른 Weblate 서버에서 데이터를 덤프하려면 dumpuserdata 를 사용하세요.

Pootle에서 마이그레이션

install_addon¶

weblate install_addon --addon ADDON <project|project/component>¶

일련의 구성요소에 애드온을 설치합니다.

--addon ADDON¶: Name of the add-on to install. For example weblate.gettext.customize.

--configuration CONFIG¶: JSON encoded configuration of an add-on.

--update¶: Update the existing add-on configuration.

애드온을 설치할 프로젝트 또는 구성요소를 정의하거나 (예: weblate/application) --all 을 사용하여 모든 기존 구성요소를 포함할 수 있습니다.

모든 구성요소에 MO 파일 생성 를 설치하려면:

weblate install_addon --addon weblate.gettext.mo --configuration '{"fuzzy": true}' --update --all

애드온

install_machinery¶

Added in version 4.18.

weblate install_machinery --service SERVICE¶

Installs a site-wide automatic suggestion service.

--service SERVICE¶: Name of the service to install. For example deepl.

--configuration CONFIG¶: JSON encoded configuration of a service.

--update¶: Update the existing service configuration.

DeepL 을 설치하려면:

weblate install_machinery --service deepl --configuration '{"key": "x", "url": "https://api.deepl.com/"}' --update

자동 제안

list_addons¶

weblate list_addons¶

애드온 에 대한 템플릿으로 reStructuredText에 애드온을 나열합니다.

--sections {events,addons,parameters}¶: Filter the generated output to just the add-on event sections, the built-in add-on sections, or the shared add-on parameter sections. If omitted, all generated sections are shown.

Weblate 문서에 기여하기

list_automation¶

weblate list_automation¶

Generates the automation reference from the workflow JSON Schema, including action names, parameters, and introduction versions. With --output, replaces generated blocks while preserving manual descriptions and cookbook examples outside those blocks.

list_permissions¶

weblate list_permissions¶

접근 제어 에 대한 템플릿으로 reStructuredText에 권한을 나열합니다.

Weblate 문서에 기여하기

list_checks¶

weblate list_checks¶

검사 및 수정 및 검사 및 수정 에 대한 템플릿으로 reStructuredText에 품질 검사를 나열합니다.

--sections {checks,flags}¶: Filter the generated output to just the quality check sections or the shared check flag sections. If omitted, all generated sections are shown.

참고

--output 을 사용하려면 --sections 에서 정확히 하나의 값을 선택해야 하므로 각 생성된 스니펫이 자체 파일에 기록됩니다. 이는 Weblate 문서에 기여하기 워크플로 및 make -C docs update-docs 대상과 일치합니다.

Weblate 문서에 기여하기

list_languages¶

weblate list_languages <locale>¶

MediaWiki 마크업으로 지원되는 언어를 나열합니다 - 언어 코드, 영어 이름 및 현지화된 이름.

이는 <https://www.l10n.cz/wiki/Slovn%C3%ADky/Slovn%C3%ADk_s_n%C3%A1zvy_jazyk%C5%AF/>를 생성하는 데 사용됩니다.

list_machinery¶

weblate list_machinery¶

자동 제안 에 대한 템플릿으로 reStructuredText에 자동 제안 서비스를 나열합니다.

Weblate 문서에 기여하기

list_translators¶

weblate list_translators <project|project/component>¶

주어진 프로젝트에 대해 기여한 언어별로 번역자를 나열함:

[French]
Jean Dupont <jean.dupont@example.com>
[English]
John Doe <jd@example.com>

--language-code¶: List names by language code instead of language name.

사용할 프로젝트 또는 구성요소를 정의하거나 (예: weblate/application) --all 을 사용하여 모든 기존 구성요소의 번역자를 나열할 수 있습니다.

list_versions¶

weblate list_versions¶

모든 Weblate 종속성과 버전을 나열합니다.

list_file_format_params¶

weblate list_file_format_params¶

파일 형식 매개변수를 나열합니다.

list_change_events¶

weblate list_change_events¶

가능한 모든 변경 이벤트 유형을 나열합니다.

list_format_features¶

weblate list_format_features¶

모든 파일 형식에 대한 지원 기능을 설명하는 RST 문서 스니펫을 생성합니다.

이 명령은 모든 형식에 대해 하나의 파일을 생성하며, 지정된 출력 디렉터리에서 찾을 수 있습니다.

--output PATH¶: Directory where the format feature snippets will be written.

참고

생성된 문서 파일은 현지화 파일 형식 와 같은 문서 소스에 포함되도록 되어 있습니다. 사용자 정의 및 병합 로직은 weblate/formats/management/commands/list_format_features.py 도 참조하세요.

loadpo¶

weblate loadpo <project|project/component>¶

디스크에서 번역을 다시 로드합니다 (예: VCS 저장소에서 일부 업데이트를 수행한 경우).

--force¶: Force update, even if the files should be up-to-date.

--lang LANGUAGE¶: Limit processing to a single language.

업데이트할 프로젝트 또는 구성요소를 정의하거나 (예: weblate/application) --all 을 사용하여 모든 기존 구성요소를 업데이트할 수 있습니다.

참고

이것을 호출하는 경우는 거의 없습니다. Weblate는 모든 VCS 업데이트 시 변경된 파일을 자동으로 로드합니다. 기존 Weblate VCS 저장소를 수동으로 변경한 경우 또는 업그레이드 후 일부 특수한 경우에 필요합니다.

lock_translation¶

weblate lock_translation <project|project/component>¶

구성요소의 추가 번역을 방지합니다.

힌트

기본 저장소에서 유지보수를 수행하려는 경우에 유용합니다.

업데이트할 프로젝트 또는 구성요소를 정의하거나 (예: weblate/application) --all 을 사용하여 모든 기존 구성요소를 업데이트할 수 있습니다.

unlock_translation

metrics¶

weblate metrics¶

Outputs the server metrics exposed by GET /api/metrics/.

--format FORMAT¶: Selects the output format. Supported formats are json, csv, and openmetrics. The default is json.

migrate¶

weblate migrate¶

데이터베이스를 현재 Weblate 스키마로 마이그레이션합니다. 명령줄 옵션은 Django migrate 에 설명되어 있습니다.

힌트

대화형으로 설치를 실행하지 않으려면 Weblate 마이그레이션 --noinput 을 사용한 다음 createadmin 명령을 사용하여 관리자 사용자를 생성할 수 있습니다.

move_language¶

weblate move_language source target¶

언어 콘텐츠를 병합할 수 있습니다. (generated) 접미사로 만들어진 이전에 알 수 없었던 언어에 대한 별칭이 포함된 새 버전으로 업데이트할 때 유용합니다. source 언어의 모든 콘텐츠를 target 언어로 이동합니다.

If both languages have a translation in the same component, or different workflow settings or font overrides for the same scope, the move is skipped without changing either language. Resolve the reported conflict before retrying. Identical workflow settings and font overrides are consolidated. Automatic language updates use the same checks and continue with other languages when a move is skipped.

예시:

weblate move_language cze cs

콘텐츠를 이동한 후 남아 있는 것이 있는지 확인하고 (누군가가 동시에 저장소를 업데이트하는 경우 경쟁 조건이 발생할 수 있음) (generated) 언어를 제거해야 합니다.

pushgit¶

weblate pushgit <project|project/component>¶

커밋된 변경사항을 업스트림 VCS 저장소에 푸시합니다.

--force-commit¶: Force commits any pending changes, prior to pushing.

업데이트할 프로젝트 또는 구성요소를 정의하거나 (예: weblate/application) --all 을 사용하여 모든 기존 구성요소를 업데이트할 수 있습니다.

참고

구성요소 설정 의 커밋 시 푸시 가 켜져 있으면 (기본값) Weblate가 변경사항을 자동으로 푸시합니다.

refresh_github_repositories¶

weblate refresh_github_repositories¶

Added in version 2026.10.1.

Refreshes the repository list of all connected GitHub accounts and retargets components whose repository was renamed or transferred on GitHub.

App webhook URL

unlock_translation¶

weblate unlock_translation <project|project/component>¶

지정된 구성요소의 잠금을 해제하여 번역할 수 있도록 합니다.

힌트

기본 저장소에서 유지보수를 수행하려는 경우에 유용합니다.

업데이트할 프로젝트 또는 구성요소를 정의하거나 (예: weblate/application) --all 을 사용하여 모든 기존 구성요소를 업데이트할 수 있습니다.

lock_translation

setupgroups¶

weblate setupgroups¶

기본 그룹을 설정하고 선택적으로 모든 사용자를 해당 기본 그룹에 할당합니다.

--no-privs-update¶: Turns off automatic updating of existing groups (only adds new ones).

--no-projects-update¶: Prevents automatic updates of groups for existing projects. This allows adding newly added groups to existing projects, see 프로젝트 접근 제어.

권한 목록

setuplang¶

weblate setuplang¶

Weblate에 정의된 언어 목록을 업데이트합니다.

--no-update¶: Turns off automatic updates of existing languages (only adds new ones).

updatechecks¶

weblate updatechecks <project|project/component>¶

모든 문자열에 대한 모든 검사를 업데이트합니다.

힌트

검사에 주요 변경을 하는 업그레이드에 유용합니다.

업데이트할 프로젝트 또는 구성요소를 정의하거나 (예: weblate/application) --all 을 사용하여 모든 기존 구성요소를 업데이트할 수 있습니다.

참고

검사는 Weblate가 백그라운드에서 정기적으로 재계산하며, 빈도는 BACKGROUND_TASKS 를 통해 설정할 수 있습니다.

updategit¶

weblate updategit <project|project/component>¶

원격 VCS 저장소를 가져오고 내부 캐시를 업데이트합니다.

업데이트할 프로젝트 또는 구성요소를 정의하거나 (예: weblate/application) --all 을 사용하여 모든 기존 구성요소를 업데이트할 수 있습니다.

참고

일반적으로 updategit 으로 정기적으로 업데이트를 트리거하는 대신 저장소에서 알림 후크 를 트리거하도록 훅을 설정하는 것이 좋습니다.