Налаштування¶

Усі параметри зберігаються у файлі settings.py (звична картина для Django).

Примітка

Після внесення змін до будь-яких з цих параметрів вам слід перезапустити Weblate — обидва процеси, WSGI і Celery.

У випадку, якщо Weblate запущено як mod_wsgi, вам слід перезапустити Apache для перезавантаження налаштувань.

Дивись також

Також, будь ласка, перевірте Django’s documentation для параметрів налаштування самого Django.

ADMINS_CONTACT¶

Визначає, куди форма зв’язку надсилатиме повідомлення електронної пошти. Якщо не вказано, буде використано адреси електронної пошти з ADMINS.

Налаштуйте це як список адрес електронної пошти:

ADMINS_CONTACT = ["admin@example.com", "support@example.com"]

Дивись також

CONTACT_FORM
ADMINS

ALLOWED_ASSET_DOMAINS¶

Added in version 5.14.

Налаштовує, які домени дозволені для отримання ресурсів у Weblate.

Це підвищує безпеку, запобігаючи завантаженню ресурсів з ненадійних джерел. Ресурси завантажуються один раз сервером Weblate і зберігаються локально, а не надаються користувачам безпосередньо з зовнішніх доменів.

Список дозволених адрес застосовується до початкового URL-адреси та до кожного адреса перенаправлення HTTP перед тим, як Weblate перейде за ним. Перенаправлення на хости, що не входять до цього списку дозволених адрес, відхиляються.

Він очікує список імен хостів/доменів. Ви можете використовувати повністю кваліфіковані імена (наприклад, www.example.com) або додавати крапку як символ-замінник, щоб відповідати всім піддоменам (наприклад, .example.com відповідатиме cdn.example.com або static.example.com).

За замовчуванням встановлено значення ["*"], що дозволяє використовувати будь-які домени.

Приклад

ALLOWED_ASSET_DOMAINS = [
    # Allows only cdn.anotherdomain.org
    "cdn.anotherdomain.org",
    # Allows example.com and all its subdomains
    ".example.com",
]

Наразі це використовується в таких місцях:

Завантаження скріншотів, див. Скріншоти та візуальний контекст
Віддалене завантаження HTML-файлів для доповнення CDN локалізації JavaScript

Дивись також

ALLOWED_ASSET_SIZE
ASSET_RESTRICT_PRIVATE
ASSET_PRIVATE_ALLOWLIST

ALLOWED_MACHINERY_DOMAINS¶

Визначає, які власні домени машин перекладу явно дозволено використовувати в налаштуваннях машинного перекладу на рівні проєкту.

Це налаштування застосовується лише до служб обладнання та не впливає на ALLOWED_ASSET_DOMAINS.

Він очікує на список імен хостів/доменів. Ви можете використовувати повні імена або додавати перед ними крапку як символ-замінник, щоб охопити всі піддомени.

За замовчуванням встановлено значення [].

Список дозволених впливає на механізми управління проектами двояко: він дозволяє використання налаштованого кінцевого пункту під час перевірки вихідного трафіку та позначає відповідні хости як надійні під час прийняття рішення про те, чи можна показувати користувачеві деталі помилок віддаленого постачальника або тіло відповіді. Для прямих з’єднань перевірки під час виконання все ще відхиляють пункти призначення, які вирішуються у приватні або інші непублічні адреси. Коли використовується проксі-сервер HTTP(S), перевірка під час виконання переходить до перевірки імені хосту і не виконує тих самих перевірок локального DNS або IP-адреси однорангового вузла.

ALLOWED_ASSET_SIZE¶

Added in version 5.14.

Налаштовує обмеження розміру для отримання ресурсів у Weblate. За замовчуванням – 10 МБ.

Дивись також

ALLOWED_ASSET_DOMAINS

ASSET_PRIVATE_ALLOWLIST¶

Added in version 2025.5.

Defines hostnames or domains exempt from ASSET_RESTRICT_PRIVATE for remote asset downloads that enforce private-target checks. Entries follow Django host matching semantics, so values such as assets.internal.example or .internal.example can be used.

This does not replace ALLOWED_ASSET_DOMAINS; remote assets must still match the asset domain allowlist.

Типова конфігурація:

ASSET_PRIVATE_ALLOWLIST = []

Дивись також

ALLOWED_ASSET_DOMAINS
ASSET_RESTRICT_PRIVATE

ASSET_RESTRICT_PRIVATE¶

Added in version 2025.5.

Reject remote asset URLs pointing to internal or non-public addresses unless the target host is included in ASSET_PRIVATE_ALLOWLIST. On by default.

When enabled, hostnames that cannot be resolved during validation are rejected unless they are explicitly included in ASSET_PRIVATE_ALLOWLIST. This currently applies to screenshot URL uploads and remote HTML downloads for the CDN локалізації JavaScript add-on.

Дивись також

ALTCHA_COST¶

Added in version 5.18.

Argon2id time cost for the ALTCHA proof-of-work challenge. Defaults to 3.

Replaces ALTCHA_MAX_NUMBER, which applied to the removed ALTCHA widget v2.

ALTCHA_MEMORY_COST¶

Added in version 5.18.

Argon2id memory cost in KiB. Defaults to 65536.

ALTCHA_PARALLELISM¶

Added in version 5.18.

Argon2id parallelism factor. Defaults to 1.

Дивись також

Механізм підтвердження роботи ALTCHA

ANONYMOUS_USER_NAME¶

Імена користувачів, які не увійшли до системи.

Дивись також

Керування доступом

AUDITLOG_EXPIRY¶

Максимальна кількість днів, коли Weblate зберігатиме журнали аудиту, що містять інформацію про активність облікового запису.

Типовим є значення у 180 днів.

AUTH_LOCK_ATTEMPTS¶

Максимальна кількість спроб невдалого розпізнавання, перш ніж буде застосовано обмеження швидкості.

У поточній версії застосовується у таких місцях:

Вхід. Вилучає пароль до облікового запису, забороняючи користувачеві входити до системи без запиту щодо введення нового пароля.
Скидання пароля. Забороняє надсилання нових повідомлень електронної пошти, не набридаючи користувачам надто великою кількістю повідомлень щодо скидання пароля.

Типове значення — 10.

Дивись також

Обмеження частоти

AUTO_UPDATE¶

Оновлює усі сховища щоденно.

Підказка

Корисно, якщо ви не використовуєте Обробники сповіщень для автоматичного оновлення сховищ Weblate.

Примітка

Окрім вибору рядка, передбачено значення «увімкнено» і «вимкнено» для зворотної сумісності.

Можливі варіанти:

"none": Без щоденних оновлень.
"remote" також False: Лише оновити віддалені сховища.
"full" також True: Оновити віддалені сховища і злити із робочою копією.

Примітка

Це потребує працездатної Фонові завдання з використанням Celery і набуває чинності після перезапуску.

AVATAR_URL_PREFIX¶

Префікс для побудови адрес аватарів: ${AVATAR_URL_PREFIX}/avatar/${MAIL_HASH}?${PARAMS}. Перевірено працездатність таких служб:

Gravatar (типовий), як на https://gravatar.com/: AVATAR_URL_PREFIX = 'https://www.gravatar.com/'
Libravatar, як на https://www.libravatar.org/: AVATAR_URL_PREFIX = 'https://www.libravatar.org/'

Дивись також

AUTH_TOKEN_VALID¶

Визначає строк дії ключа розпізнавання та тимчасового пароля з повідомлень електронної пошти щодо скидання пароля. Визначається у секундах. Типове значення — 172800 (2 дні).

AUTH_PASSWORD_DAYS¶

Кількість днів, протягом яких Weblate відмовлятиметься повторно використовувати раніше використаний пароль для користувача.

Перевірку засновано на журналі ревізії, AUDITLOG_EXPIRY має бути принаймні таким самим великим, як це значення.

Примітка

Зміни пароля, виконані до Weblate 2.15 не братимуться до уваги у цьому правилі.

Типовим є значення у 180 днів.

AUTOFIX_LIST¶

Список автоматичних виправлено, які слід застосувати при збереженні рядка.

Примітка

Надайте повний шлях до класу Python, який реалізує інтерфейс автоматичного виправлення.

Доступні виправлення описано на сторінці Автоматичні виправлення.

Ви можете вибрати, яким з них скористатися:

AUTOFIX_LIST = (
    "weblate.trans.autofixes.whitespace.SameBookendingWhitespace",
    "weblate.trans.autofixes.chars.ReplaceTrailingDotsWithEllipsis",
)

Дивись також

BACKGROUND_TASKS¶

Added in version 4.5.2.

Визначає частоту, із якою запускатимуться тривалі завдання для складника.

У поточній версії керує такими елементами:

додатком Автоматичний переклад
повторною обробкою Перевірки і виправлення

Можливі варіанти значень:

monthly (щомісяця, типове значення)
weekly
daily
never

Примітка

Не рекомендуємо збільшувати частоту, якщо у Weblate тисячі складників.

BASIC_LANGUAGES¶

Added in version 4.4.

Список мов, які буде запропоновано користувачам при започаткуванні нового перекладу. Якщо не вказано, буде використано вбудований список, до якого включено найпоширеніші мови, але без діалектів певних країн.

Це заборонить додавати небажані мови лише непривілейованим користувачам. Адміністраторам проєкту все одно буде надано повний набір мов, які визначено у Weblate.

Примітка

Це не визначає нових мов для Weblate, лише фільтрує наявні у базі даних.

Приклад:

BASIC_LANGUAGES = {"cs", "it", "ja", "en"}

Дивись також

Визначення мов

BORG_EXTRA_ARGS¶

Added in version 4.9.

Ви можете передати додаткові аргументи borg create, якщо увімкнено вбудоване резервне копіювання.

Приклад:

BORG_EXTRA_ARGS = ["--exclude", "vcs/"]

Дивись також

CACHE_DIR¶

Added in version 4.16.

Каталог, у якому Weblate зберігає файли кешу. Типовим є підкаталог cache у DATA_DIR.

Змініть це на локальну або тимчасову файлову систему, якщо DATA_DIR є каталогом мережевої файлової системи.

Weblate stores generated helper files here and executes some of them, so CACHE_DIR has to be writable and mounted on a filesystem that allows execution. Avoid using noexec mount options for this directory.

Контейнер Docker використовує для цього окремий том, див. Томи контейнера Docker.

Зазвичай, існують такі підкаталоги:

ssh: Generated helper files used for VCS access.
fonts: font-config кеш для Керування шрифтами.
avatar: Кешовані аватари користувачів, див. Аватари.
static: Типове місце для статичних файлів Django, визначається на основі STATIC_ROOT. Див. Обслуговування статичних файлів.
tesseract: Дані, навчені OCR, для Скріншоти та візуальний контекст.

CSP_SCRIPT_SRC, CSP_IMG_SRC, CSP_CONNECT_SRC, CSP_STYLE_SRC, CSP_FONT_SRC, CSP_FORM_SRC¶

Налаштуйте заголовок Content-Security-Policy для Weblate. Заголовок генерується автоматично на основі ввімкнених інтеграцій зі сторонніми сервісами (Matomo, Google Analytics, Sentry тощо).

Усі ці списки за замовчуванням є порожніми.

Приклад:

# Enable Cloudflare Javascript optimizations
CSP_SCRIPT_SRC = ["ajax.cloudflare.com"]

Дивись також

CHECK_LIST¶

Список перевірок якості, які слід виконати над перекладом.

Примітка

Надайте повний шлях до класу Python, який реалізує інтерфейс перевірок.

Скоригувати список перевірок для включення потрібних вам.

Усі вбудовані Перевірки якості типово увімкнено. Ви можете змінити ці параметри. Типово, записи у Зразок налаштувань закоментовано, тому використовуються типові значення. Нові перевірки додаються із кожною новою версією Weblate.

Ви можете вимкнути усі перевірки:

CHECK_LIST = ()

Ви можете увімкнули лише декілька:

CHECK_LIST = (
    "weblate.checks.chars.BeginNewlineCheck",
    "weblate.checks.chars.EndNewlineCheck",
    "weblate.checks.chars.MaxLengthCheck",
)

Примітка

Зміна значення цього параметра стосується лише змінених наново перекладів — наявні перевірки зберігатимуться у базі даних. Щоб зміни було застосовано до вже збережених перекладів, віддайте команду updatechecks.

Дивись також

COMMIT_PENDING_HOURS¶

Кількість годин, протягом яких слід надіслати до сховища зміни з черги разом із фоновим завданням.

Дивись також

COMPONENT_ZIP_UPLOAD_MAX_SIZE¶

Added in version 5.17.1.

Встановлює максимальний розмір (у байтах) для завантажуваних ZIP-файлів компонентів. За замовчуванням — 50 МБ.

In Docker, configure this using the WEBLATE_COMPONENT_ZIP_UPLOAD_MAX_SIZE environment variable.

Дивись також

Налаштовування складників

CONTACT_FORM¶

Added in version 4.6.

Налаштовує спосіб надсилання повідомлення електронної пошти з форми зв’язку. Виберіть налаштування, які відповідають налаштуванням вашого поштового сервера.

"reply-to": The sender is used as Reply-To, this is the default behaviour.
"from": The sender is used as From. Your mail server needs to allow sending such e-mails.
"disabled": Повністю вимикає контактну форму.

Added in version 5.15.

Дивись також

ADMINS_CONTACT

DATA_DIR¶

Тека, у якій Weblate зберігає дані. Тека містить посилання на сховища системи керування версіями, повнотекстовий покажчик та різноманітні файли налаштувань для зовнішніх інструментів.

Зазвичай, існують такі підкаталоги:

home

Домашній каталог, який використовується для виклику скриптів.

ssh

Ключі і налаштування SSH.

media

Типове розташування мультимедійних файлів Django, визначається на основі MEDIA_ROOT. Містить вивантажені знімки вікон, див. Скріншоти та візуальний контекст.

vcs

Сховища систем керування версіями для перекладів.

backups

Дані щоденної резервної копії. Докладніше про це у розділі Дампи даних для резервних копій.

fonts:

Вивантажені користувачем шрифти, див. Керування шрифтами.

cache

Різноманітні кеші, можна розташувати деінде за допомогою CACHE_DIR.

Контейнер Docker використовує для цього окремий том, див. Томи контейнера Docker.

Примітка

Цей каталог має бути доступним для запису Weblate. Запуск як WSGI означає, що користувач www-data повинен мати доступ для запису до нього.

Найпростішим способом досягти результату є надання користувачеві прав власника каталогу:

sudo chown www-data:www-data -R $DATA_DIR

Типове значення — /home/weblate/data, але варто налаштувати все відповідним чином.

Дивись також

DATABASE_BACKUP¶

Чи мають резервні копії зберігатися у форматі звичайного тексту, стисненими чи пропущеними. Коректними значеннями є такі:

"plain"
"compressed"
"none"

Дивись також

Резервне копіювання і пересування Weblate

DEFAULT_ACCESS_CONTROL¶

Типовий параметр керування доступом для нових проєктів:

0: Відкритий
1: Захищений
100: Приватний
200: Нетиповий

Скористайтеся варіантом Нетиповий, якщо ви керуєте ACL вручну, тобто не покладаєтеся на внутрішні механізми керування Weblate.

Дивись також

DEFAULT_AUTO_WATCH¶

Added in version 4.5.

Налаштовує, чи має бути увімкнено Автоматичне спостереження за проєктами із внеском для нових користувачів. Типове значення — True.

Дивись також

Сповіщення

DEFAULT_RESTRICTED_COMPONENT¶

Added in version 4.1.

Типове значення для обмеження на доступ до складника.

Дивись також

DEFAULT_ADD_MESSAGE, DEFAULT_ADDON_MESSAGE, DEFAULT_COMMIT_MESSAGE, DEFAULT_DELETE_MESSAGE, DEFAULT_MERGE_MESSAGE¶

Типові повідомлення про внесок для різних дій. Докладніше про це у розділі Налаштовування складників.

Дивись також

DEFAULT_ADDONS¶

Типові додатки, які слід встановлювати для всіх створених складників.

Примітка

Цей параметр стосується лише новостворених складників.

Приклад:

DEFAULT_ADDONS = {
    # Add-on with no parameters
    "weblate.flags.target_edit": {},
    # Add-on with parameters
    "weblate.autotranslate.autotranslate": {
        "mode": "suggest",
        "filter_type": "todo",
        "auto_source": "mt",
        "component": "",
        "engines": ["weblate-translation-memory"],
        "threshold": "80",
    },
}

Дивись також

DEFAULT_COMMITER_EMAIL¶

Адреса електронної пошти автора внеску. Типове значення — noreply@weblate.org.

Дивись також

DEFAULT_COMMITER_NAME

DEFAULT_COMMITER_NAME¶

Ім’я автора внеску. Типове значення — Weblate.

Дивись також

DEFAULT_COMMITER_EMAIL

DEFAULT_LANGUAGE¶

Added in version 4.3.2.

Початкова мова для усіх нових складників.

Типовим значенням є en. Відповідний об’єкт мови має існувати у базі даних.

Дивись також

DEFAULT_MERGE_STYLE¶

Стиль злиття для усіх нових складників.

rebase — типовий
merge

Дивись також

DEFAULT_SHARED_TM¶

Налаштовує типове значення Використовувати спільну памʼять перекладів і Вносити переклад до у спільної памʼяті перекладів.

DEFAULT_TRANSLATION_REVIEW¶

Added in version 5.16.

Налаштовує значення за замовчуванням для Увімкнути рецензії, яке за замовчуванням вимкнено.

DEFAULT_SOURCE_REVIEW¶

Added in version 5.16.

Налаштовує значення за замовчуванням для Увімкнути рецензування початкових даних, яке за замовчуванням вимкнено.

DEFAULT_AUTOCLEAN_TM¶

Added in version 5.13.

Налаштовує значення за замовчуванням Автоматичне очищення пам’яті перекладів.

DEFAULT_TRANSLATION_PROPAGATION¶

Типовий параметр для надсилання перекладу, типове значення — True.

Дивись також

DEFAULT_PULL_MESSAGE¶

Налаштовує типовий заголовок та повідомлення для запитів щодо об’єднання.

ENABLE_AVATARS¶

Визначає, чи слід вмикати засновані на Gravatar аватари для користувачів. Типово увімкнено.

Зображення аватарів отримуються і кешуються на сервері — це знижує ризик витоку приватних даних і пришвидшує обробку даних для користувача.

Дивись також

ENABLE_HOOKS¶

Чи слід вмикати доступу до анонімних віддалених скриптів обробки.

Дивись також

Обробники сповіщень

ENABLE_HTTPS¶

Змінено в версії 5.7: Для Weblate потрібен https для підтримки WebAuthn.

Визначає, надсилати посилання Weblate як HTTPS або як HTTP. Цей параметр впливає на надіслані повідомлення електронної пошти і створення абсолютних адрес.

У типових налаштуваннях цей параметр також використовується для декількох параметрів Django, які пов’язано із HTTPS — вмикає безпечні куки, перемикає HSTS або вмикає переспрямовування на адресу HTTPS.

У певних випадках переспрямовування HTTPS може викликати проблеми — ви можете зіткнутися із проблемами циклічного переспрямовування, якщо ви використовуєте реверсивний проксі-сервер, який виконує обривання SSL і не передає належним чином заголовки протоколів до Django. Будь ласка, скоригуйте налаштування вашого реверсивного проксі-сервера так, щоб він надсилав заголовки X-Forwarded-Proto або Forwarded, або налаштуйте SECURE_PROXY_SSL_HEADER, щоб надати Django змогу правильно визначати стан SSL.

Якщо це вимкнено, Weblate не зможе запуститися з помилкою otp_webauthn.E031. Ви можете заглушити цю помилку, додавши її до SILENCED_SYSTEM_CHECKS, але все одно WebAuthn не працюватиме для сайтів без HTTPS.

Дивись також

EXTRA_HTML_HEAD¶

Added in version 4.15.

Вставити додаткову розмітку у заголовок HTML. Можна скористатися, наприклад, для перевірки власності сайта:

EXTRA_HTML_HEAD = '<link href="https://fosstodon.org/@weblate" rel="me">'

Попередження

Обробка рядка не виконуватиметься, його буде просто вставлено до заголовка HTML.

GET_HELP_URL¶

Added in version 4.5.2.

Адреса, за якою можна отримати підтримку для вашого екземпляра Weblate.

GITEA_CREDENTIALS¶

Added in version 4.12.

Список реєстраційних даних для серверів Gitea.

GITEA_CREDENTIALS = {
    "try.gitea.io": {
        "username": "weblate",
        "token": "your-api-token",
    },
}

Словник налаштувань складається з реєстраційних даних, які визначено для кожного вузла API. Компонування є таким самим майже для усіх інтеграцій із системами керування версіями. Його описано у розділі Налаштування облікових даних системи керування версіями.

Дивись також

GITLAB_CREDENTIALS¶

Added in version 4.3.

Список реєстраційних даних для серверів GitLab.

GITLAB_CREDENTIALS = {
    "gitlab.com": {
        "username": "weblate",
        "token": "your-api-token",
    },
}

Примітка

Для використання API персональному токену доступу потрібна область видимості api.

Дивись також

GITHUB_CREDENTIALS¶

Added in version 4.3.

Список реєстраційних даних для серверів GitHub.

GITHUB_CREDENTIALS = {
    "api.github.com": {
        "username": "weblate",
        "token": "your-api-token",
    },
}

Примітка

Можна використовувати як детальні персональні токени доступу, так і класичні персональні токени доступу. Детальні токени обмежені однією організацією, тому вони не працюватимуть, якщо ви хочете, щоб Weblate створив репозиторій за межами організації (зазвичай до простору імен користувача).

Для клонування, надсилання та створення пул-реквестів потрібен доступ на читання та запис до Contents та Pull requests.

Administration також може знадобитися для розгалуження сховища, якщо ви збираєтеся використовувати розгалуження, а оригінальне сховище не є публічним.

Підказка

Use api.github.com as an API host for https://github.com/.

Дивись також

BITBUCKETSERVER_CREDENTIALS¶

Added in version 4.16.

Список облікових даних для Bitbucket Data Center.

BITBUCKETSERVER_CREDENTIALS = {
    "git.self-hosted.com": {
        "username": "weblate",
        "token": "http-access-token",
    },
}

Дивись також

BITBUCKETCLOUD_CREDENTIALS¶

Added in version 5.8.

Список реєстраційних даних для серверів Bitbucket Cloud.

BITBUCKETCLOUD_CREDENTIALS = {
    "bitbucket.org": {
        "username": "your-email",
        "workspace": "your-workspace-slug",
        "token": "your-api-token",
    },
}

Словник налаштувань складається з реєстраційних даних, які визначено для кожного вузла API. Вузол API може відрізнятися від того, яким ви користуєтеся у браузері. Наприклад, доступ до програмного інтерфейсу GitHub здійснюється за допомогою api.github.com.

Для кожного вузла доступні такі налаштування:

username: Користувач програмного інтерфейсу.
workspace: Жетон простору користувача.
token: Токен API з дозволом pullrequest:write.

Додаткові параметри, які не описано тут, описано у розділі Налаштування облікових даних системи керування версіями.

Дивись також

AZURE_DEVOPS_CREDENTIALS¶

Added in version 5.2.

Список реєстраційних даних для серверів Azure DevOps.

AZURE_DEVOPS_CREDENTIALS = {
    "dev.azure.com": {
        "username": "project-name",
        "token": "your-api-token",
        "organization": "organization-name",
    },
}

Для кожного вузла доступні такі налаштування:

username: Назва проєкту Azure DevOps. Це не назва сховища.
organization: Назва організації проєкту..
workItemIds: Необов’язковий список ідентифікаторів робочих записів з вашої організації. Буде долучено до наданих нових запитів щодо об’єднання.
token: Жетон для користувача API, має бути вказано обов’язково.

Дивись також

GOOGLE_ANALYTICS_ID¶

Google Analytics ID, щоб увімкнути моніторинг Weblate за допомогою Google Universal Analytics.

Примітка

Інтеграція Google Analytics 4 наразі недоступна для Weblate, див. https://github.com/WeblateOrg/weblate/issues/14015.

HIDE_REPO_CREDENTIALS¶

Приховати реєстраційні дані сховища від показу у вебінтерфейсі. Якщо у адресі сховища міститься ім’я користувача і пароль, Weblate приховає їх при показі відповідних даних користувачам.

Наприклад, замість https://користувач:пароль@git.example.com/repo.git буде показано просто https://git.example.com/repo.git. Програма також намагатиметься вилучити повідомлення про помилки системи керування версіями у подібний же спосіб.

Примітка

Типово увімкнено.

VERSION_DISPLAY¶

Added in version 5.17.

Визначає, наскільки помітно Weblate відображає інформацію про свою версію.

Підтримувані значення:

show: Відобразити версію в загальному інтерфейсі користувача, наприклад у нижньому колонтитулі, та надати доступ до неї за адресою GET /api/metrics/.
soft: Приховати версію з головного інтерфейсу, але залишити її доступною на сторінці Про програму та за адресою GET /api/metrics/.
hide: Приховати версію у спільному інтерфейсі користувача та за адресою GET /api/metrics/. Це також призведе до того, що анонімні посилання на документацію будуть вести на найновішу версію документації, а не на ту, що відповідає встановленому випуску.

Приховування версії є рекомендованою практикою безпеки в деяких компаніях, але це не заважає зловмиснику визначити версію шляхом аналізу поведінки програми.

Примітка

За замовчуванням встановлено значення show.

HIDE_VERSION¶

Added in version 4.3.1.

Застаріло починаючи з версії 5.17.

Псевдонім сумісності для VERSION_DISPLAY. Встановіть для цього параметра значення True, щоб отримати ту саму поведінку, що й при VERSION_DISPLAY = "hide".

IP_BEHIND_REVERSE_PROXY¶

Вказує, чи працює Weblate за реверсивним проксі-сервером.

Якщо встановлено значення True, Weblate отримуватиме IP-адресу з заголовка, який визначено IP_PROXY_HEADER.

Попередження

Переконайтеся, що зворотний проксі-сервер справді використовується, і що він встановлює цей заголовок, інакше користувачі зможуть підробляти IP-адресу.

Примітка

Типово не увімкнено.

Дивись також

IP_PROXY_HEADER¶

Вказує, з якого заголовка Weblate має отримати адресу, коли увімкнено IP_BEHIND_REVERSE_PROXY.

Типове значення — HTTP_X_FORWARDED_FOR.

Дивись також

IP_PROXY_OFFSET¶

Змінено в версії 5.0.1: Типове значення змінено з 1 на -1.

Вказує, яку частину IP_PROXY_HEADER має бути використано як клієнтську IP-адресу.

Залежно від вашої конфігурації, цей заголовок може складатися з декількох IP-адрес (наприклад, X-Forwarded-For: client-ip, proxy-a, proxy-b), і ви можете налаштувати, яку адресу з заголовка буде використано як клієнтську IP-адресу тут.

Попередження

Налаштування цього параметра впливає на безпеку вашої інсталяції. Вам слід налаштувати його лише на використання довірених проксі-серверів для визначення IP-адреси. Будь ласка, перевірте <https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/X-Forwarded-For#security_and_privacy_concerns> для отримання більш детальної інформації.

Типове значення — -1.

Дивись також

LEGAL_TOS_DATE¶

Added in version 4.15.

Примітка

Щоб мати змогу цим скористатися, вам слід встановити Юридичний модуль.

Дата останнього оновлення документів щодо умов надання послуг. Кожного разу, коли змінюється дата, користувачі мають погоджуватися із оновленими умовами надання послуг.

from datetime import date

LEGAL_TOS_DATE = date(2022, 2, 2)

LEGAL_URL¶

Адреса, за якою екземпляр Weblate показуватиме правові документи.

Підказка

Корисний, якщо ви зберігаєте ваші правові документи поза Weblate для вбудовування їх до Weblate. Докладніше про це у розділі Юридичний модуль.

Приклад:

LEGAL_URL = "https://weblate.org/terms/"

Дивись також

PRIVACY_URL

LICENSE_EXTRA¶

Додаткові ліцензії, які слід включити до варіантів ліцензування.

Примітка

Each license definition should be a tuple of its short name, a long name, a URL and a boolean, indicating whether it is a libre license.

Приклад:

LICENSE_EXTRA = [
    (
        "AGPL-3.0",
        "GNU Affero General Public License v3.0",
        "https://www.gnu.org/licenses/agpl-3.0-standalone.html",
        True,
    ),
]

LICENSE_FILTER¶

Змінено в версії 4.3: Відтепер, якщо спорожнити це значення, попередження про ліцензію буде вимкнено.

Фільтрувати перелік ліцензій для показу. Це також вимкне оповіщення про ліцензію, якщо спорожнити значення.

Примітка

У цьому фільтрі використовуються скорочені назви ліцензій.

Приклад:

LICENSE_FILTER = {"AGPL-3.0", "GPL-3.0-or-later"}

Це вимкне попередження про ліцензію:

LICENSE_FILTER = set()

Дивись також

Попередження щодо складників перекладу

LICENSE_REQUIRED¶

Визначає, чи є обов’язковим атрибут ліцензування у записі Налаштовування складників.

Примітка

Типово вимкнено.

LIMIT_TRANSLATION_LENGTH_BY_SOURCE_LENGTH¶

Визначає, чи має бути обмежено довжину вказаного перекладу. Обмеження довжини — довжина початкового рядка × 10 символів.

Підказка

Установіть значення False, щоб уможливити довші переклади (аж до 10000 символів), незалежно від довжини початкового рядка.

Примітка

Типове значення — True.

LOCALIZE_CDN_URL і LOCALIZE_CDN_PATH¶

These settings configure the CDN add-ons, including CDN локалізації JavaScript and Translation files CDN. LOCALIZE_CDN_URL defines root URL where the localization CDN is available and LOCALIZE_CDN_PATH defines path where Weblate should store generated files which will be served at the LOCALIZE_CDN_URL. The files are served by your web server or CDN, not by Weblate; see CDN локалізації for secure serving guidance.

Підказка

На базовому Weblate використано https://weblate-cdn.com/.

Дивись також

MATOMO_SITE_ID¶

Ідентифікатор сайта Matomo (раніше Piwik), яким ви хочете скористатися для стеження за Weblate.

Примітка

У цьому варіанті інтеграції не передбачено підтримки керування мітками Matomo.

Дивись також

MATOMO_URL

MATOMO_URL¶

Повна адреса (разом із кінцевою похилою рискою) встановленого Matomo (раніше Piwik), яким ви хочете скористатися для стеження за використанням Weblate. Будь ласка, ознайомтеся із <https://matomo.org/>, щоб дізнатися більше.

Підказка

У цьому варіанті інтеграції не передбачено підтримки керування мітками Matomo.

Приклад:

MATOMO_SITE_ID = 1
MATOMO_URL = "https://example.matomo.cloud/"

Дивись також

MATOMO_SITE_ID

NEARBY_MESSAGES¶

Кількість близьких рядків, які буде показано у обох напрямках у повній версії редактора.

Це лише стандартне значення, користувачі можуть налаштувати його в Профіль користувача.

DEFAULT_PAGE_LIMIT¶

Added in version 4.7.

Типова кількість показуваних елементів, коли увімкнено розбиття на сторінки.

PAGURE_CREDENTIALS¶

Added in version 4.3.2.

Список реєстраційних даних для серверів Pagure.

PAGURE_CREDENTIALS = {
    "pagure.io": {
        "username": "weblate",
        "token": "your-api-token",
    },
}

Дивись також

PASSWORD_MINIMAL_STRENGTH¶

Added in version 5.10.2.

Мінімальна оцінка пароля за допомогою zxcvbn оцінювача надійності пароля.

За замовчуванням 0, що означає, що перевірку міцності вимкнено.

Дивись також

PASSWORD_RESET_URL¶

Added in version 5.17.

URL-адреса для скидання пароля, коли автентифікація здійснюється зовнішнім постачальником ідентифікації, таким як LDAP, SAML або OAuth.

Якщо встановити Забули пароль? на сторінці входу, посилання буде вести на цю URL-адресу замість вбудованої сторінки Weblate для скидання пароля.

PRIVACY_URL¶

Added in version 4.8.1.

Адреса, за якою екземпляр Weblate показуватиме правила конфіденційності.

Підказка

Приклад:

PRIVACY_URL = "https://weblate.org/terms/"

Дивись також

LEGAL_URL

PRIVATE_COMMIT_EMAIL_OPT_IN¶

Added in version 4.15.

Налаштовує, чи є конфіденційність адреси електронної пошти при внеску такою, з якою погоджуються, чи такою, від якої відмовляються (типово, вважається, що з нею погоджуються).

Підказка

Цей параметр стосується лише користувачів, якими не вибрано явним чином адресу електронної пошти для внесків.

Дивись також

Профіль
PRIVATE_COMMIT_EMAIL_TEMPLATE

PRIVATE_COMMIT_EMAIL_TEMPLATE¶

Added in version 4.15.

Шаблон для створення приватного електронного листа про коміт для користувача. За замовчуванням використовується "{username}@users.noreply.{site_domain}".

Він може містити {user_id}, {username}, {site_title} та {site_domain}.

Встановіть порожні рядок, щоб вимкнути.

Примітка

Використання іншої електронної адреси для комітів є опціональним для користувачів, якщо це не налаштовано за допомогою PRIVATE_COMMIT_EMAIL_OPT_IN. Користувачі можуть налаштувати свою електронну адресу для комітів у Профіль.

PRIVATE_COMMIT_NAME_OPT_IN¶

Added in version 5.16.

Налаштовує, чи буде приватне ім’я коміту опцією «opt-in» чи «opt-out» (за замовчуванням — «opt-in»).

Підказка

Це налаштування застосовується тільки до користувачів, які явно не вибрали ім’я коміту.

Дивись також

Профіль
PRIVATE_COMMIT_NAME_TEMPLATE

PRIVATE_COMMIT_NAME_TEMPLATE¶

Added in version 5.16.

Шаблон для створення приватного імені коміту для користувача. За замовчуванням використовується "{site_title} user {user_id}".

Він може містити {user_id}, {username}, {site_title} та {site_domain}.

Встановіть порожні рядок, щоб вимкнути.

Примітка

Використання іншого імені коміту є опціональним для користувачів, якщо це не налаштовано за допомогою PRIVATE_COMMIT_NAME_OPT_IN. Користувачі можуть налаштувати своє ім’я коміту в Профіль.

PROJECT_BACKUP_KEEP_COUNT¶

Added in version 4.14.

Визначає, скільки резервних копій на проєкт слід зберігати на сервері. Типовим значенням є 3.

Дивись також

Резервне копіювання на рівні проєктів

PROJECT_BACKUP_KEEP_DAYS¶

Added in version 4.14.

Визначає, наскільки довго зберігатимуться резервні копії проєкту на сервері. Типовим значенням є 30 днів.

Дивись також

Резервне копіювання на рівні проєктів

PROJECT_BACKUP_UPLOAD_MAX_SIZE¶

Added in version 5.17.1.

Configures the maximum size, in bytes, for uploaded project backup ZIP files. Defaults to 536870912 bytes (512 MiB).

У Docker це налаштовується за допомогою змінної середовища WEBLATE_PROJECT_BACKUP_UPLOAD_MAX_SIZE. Налаштування Docker також можуть обмежуватися змінною CLIENT_MAX_BODY_SIZE; інші розгортання можуть обмежуватися обмеженням розміру тіла запиту зворотного проксі-сервера.

Дивись також

Резервне копіювання на рівні проєктів

PROJECT_BACKUP_IMPORT_MAX_MEMBERS¶

Added in version 5.17.

Визначає максимальну кількість записів ZIP, дозволених під час імпорту резервної копії проєкту.

Це запобіжний захід проти архівів із помилками у форматі або навмисно роздроблених архівів. За замовчуванням встановлено 100 000 записів.

In Docker, configure this using the WEBLATE_PROJECT_BACKUP_IMPORT_MAX_MEMBERS environment variable.

Дивись також

Резервне копіювання на рівні проєктів

PROJECT_BACKUP_IMPORT_MAX_TOTAL_UNCOMPRESSED_SIZE¶

Added in version 5.17.1.

Defines the maximum total uncompressed size, in bytes, for ZIP entries in an imported project backup. Defaults to 536870912 bytes (512 MiB).

Це обмежує архівні файли, які під час завантаження мають невеликий розмір, але під час перевірки або відновлення збільшуються до значно більшого обсягу даних.

In Docker, configure this using the WEBLATE_PROJECT_BACKUP_IMPORT_MAX_TOTAL_UNCOMPRESSED_SIZE environment variable.

Дивись також

Резервне копіювання на рівні проєктів

PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE¶

Added in version 5.17.

Визначає максимальний розмір у байтах одного сильно стисненого ZIP-елемента в імпортованій резервній копії проєкту.

Це обмеження застосовується лише до записів, які мають достатньо великий розмір і ступінь стиснення, щоб викликати підозру. Великі файли з низьким ступенем стиснення тут дозволені навмисно, і передбачається, що їх розмір буде обмежуватися обмеженням на завантаження по HTTP. За замовчуванням встановлено 262144000 байтів (250 Мб).

In Docker, configure this using the WEBLATE_PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE environment variable.

Дивись також

Резервне копіювання на рівні проєктів

PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE¶

Added in version 5.17.

Визначає мінімальний розмір файлу без стиснення (у байтах), при досягненні якого Weblate починає враховувати ступінь стиснення ZIP під час імпорту резервної копії проєкту.

Файли меншого розміру ігноруються під час перевірки на основі коефіцієнта стиснення, щоб уникнути відхилення файлів прийнятного розміру, які добре стискаються. За замовчуванням встановлено значення 1048576 байт (1 Мб).

In Docker, configure this using the WEBLATE_PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE environment variable.

Дивись також

Резервне копіювання на рівні проєктів

PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_RATIO¶

Added in version 5.17.

Визначає максимально допустиме співвідношення між розміром нестисненого та стисненого файлу для великого елемента ZIP під час імпорту резервної копії проєкту.

Цей параметр використовується разом із PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE та PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE для виявлення записів із підозрілим ступенем стиснення, при цьому дозволяючи використовувати великі файли пакетів репозиторіїв та інший контент із низьким ступенем стиснення. За замовчуванням встановлено значення 250.

In Docker, configure this using the WEBLATE_PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_RATIO environment variable.

Дивись також

Резервне копіювання на рівні проєктів

PROJECT_NAME_RESTRICT_RE¶

Added in version 4.15.

Визначає формальний вираз для обмеження назв проєктів. Усі назви, відповідність яких виразу буде встановлено, буде заборонено.

Дивись також

Назва проєкту

PROJECT_WEB_RESTRICT_HOST¶

Added in version 4.16.2.

Заборонити використання певних хостів на сайті проєкту. Перевіряється будь-який піддомен, тому включення example.com також заблокує test.example.com. Список повинен містити тільки рядки в нижньому регістрі, аналіз домену перед зіставленням починається з нижнього регістру.

Типова конфігурація:

PROJECT_WEB_RESTRICT_HOST = {"localhost"}

Дивись також

Вебсайт проєкту
PROJECT_WEB_RESTRICT_NUMERIC
PROJECT_WEB_RESTRICT_PRIVATE
PROJECT_WEB_RESTRICT_RE
PROJECT_WEB_RESTRICT_ALLOWLIST

PROJECT_WEB_RESTRICT_ALLOWLIST¶

Added in version 5.17.

Визначає набір коротких URL-адрес проектів, на які не поширюються обмеження PROJECT_WEB_RESTRICT_HOST, PROJECT_WEB_RESTRICT_NUMERIC, PROJECT_WEB_RESTRICT_PRIVATE та PROJECT_WEB_RESTRICT_RE під час перевірки веб-сайту проекту. Слуги проектів порівнюються без урахування регістру.

Застереження

Це виключення послаблює захист вихідних URL-адрес для відповідних проєктів, зокрема обмеження щодо приватних цілей, яке застосовується за допомогою параметра PROJECT_WEB_RESTRICT_PRIVATE. Використовуйте його лише для надійних проєктів, що перебувають під управлінням адміністратора, де обхід цих перевірок є навмисним.

Типова конфігурація:

PROJECT_WEB_RESTRICT_ALLOWLIST = set()

Дивись також

Вебсайт проєкту
PROJECT_WEB_RESTRICT_HOST
PROJECT_WEB_RESTRICT_NUMERIC
PROJECT_WEB_RESTRICT_PRIVATE
PROJECT_WEB_RESTRICT_RE

PROJECT_WEB_RESTRICT_NUMERIC¶

Added in version 4.16.2.

Заборонити використання числової IP-адреси на сайті проєкту. Типово ввімкнено.

Дивись також

Вебсайт проєкту
PROJECT_WEB_RESTRICT_HOST
PROJECT_WEB_RESTRICT_PRIVATE
PROJECT_WEB_RESTRICT_RE

PROJECT_WEB_RESTRICT_PRIVATE¶

Added in version 5.17.

Відхиляти URL-адреси веб-сайтів проєктів та браузерів репозиторіїв, що вказують на внутрішні або непублічні адреси. Увімкнено за замовчуванням.

Дивись також

PROJECT_WEB_RESTRICT_RE¶

Added in version 4.15.

Визначає регулярний вираз для обмеження того, що можна ввести як Вебсайт проєкту. Усі відповідні URL-адреси буде відхилено.

Дивись також

Вебсайт проєкту
PROJECT_WEB_RESTRICT_HOST
PROJECT_WEB_RESTRICT_NUMERIC
PROJECT_WEB_RESTRICT_PRIVATE

WEBHOOK_PRIVATE_ALLOWLIST¶

Added in version 5.17.

Визначає імена хостів або домени, на які не поширюється дія параметра WEBHOOK_RESTRICT_PRIVATE при відправленні вихідних веб-хуків. Записи відповідають семантиці зіставлення хостів у Django, тому можна використовувати такі значення, як hooks.internal.example або .internal.example.

Типова конфігурація:

WEBHOOK_PRIVATE_ALLOWLIST = []

Дивись також

WEBHOOK_RESTRICT_PRIVATE

WEBHOOK_RESTRICT_PRIVATE¶

Added in version 5.17.

Відхиляти URL-адреси веб-хуків, що вказують на внутрішні або непублічні адреси, якщо цільовий хост не вказано у WEBHOOK_PRIVATE_ALLOWLIST. Увімкнено за замовчуванням.

Якщо ця опція увімкнена, імена хостів, які не вдається розпізнати під час перевірки, відхиляються, якщо вони явно не вказані у WEBHOOK_PRIVATE_ALLOWLIST.

Дивись також

Дієскрипт
WEBHOOK_PRIVATE_ALLOWLIST

PUBLIC_ENGAGE¶

Added in version 5.16.2.

Дозволяє відкрити сторінку для взаємодії з аудиторією навіть при встановленому параметрі REQUIRE_LOGIN.

Дивись також

Розбудова спільноти перекладачів

RATELIMIT_NOTIFICATION_LIMITS¶

Added in version 5.14.

Обмежує кількість сповіщень, які буде надіслано одному користувачеві.

Налаштування за замовчуванням:

# Multi-level rate limiting for email notifications
# Each tuple contains (max_emails, time_window_seconds)
RATELIMIT_NOTIFICATION_LIMITS = [
    # Prevent burst sends - 3 emails per 2 minutes
    (3, 120),
    # Equalize to avoid getting blocked for too long - 10 emails per hour
    (10, 3600),
    # Daily limit: 50 emails per day
    (50, 86400),
]

RATELIMIT_ATTEMPTS¶

Максимальна кількість спроб розпізнавання, перш ніж буде застосовано обмеження швидкості.

Типове значення — 5.

Дивись також

RATELIMIT_WINDOW¶

Тривалість періоду прийняття розпізнавання після застосування обмеження частоти.

Проміжок часу у секундах, типове значення — 300 (5 хвилин).

Дивись також

RATELIMIT_LOCKOUT¶

Тривалість періоду блокування розпізнавання після застосування обмеження частоти.

Проміжок часу у секундах, типове значення — 600 (10 хвилин).

Дивись також

REGISTRATION_ALLOW_BACKENDS¶

Added in version 4.1.

Список модулів розпізнавання, з яких уможливлено реєстрацію. Обмежує лише нові реєстрації. Користувачі зможуть проходити розпізнавання та додавати розпізнавання за допомогою всіх налаштованих модулів розпізнавання.

Рекомендуємо не вимикати REGISTRATION_OPEN, а обмежити роботу модулів реєстрації. Якщо ви цього не зробите, користувачі зможуть реєструватися, але Weblate не показуватиме посилань на реєстрацію в інтерфейсі користувача.

Приклад:

REGISTRATION_ALLOW_BACKENDS = ["azuread-oauth2", "azuread-tenant-oauth2"]

Підказка

Назви модулів відповідають назвам, використаним у адресі для розпізнавання.

Дивись також

REGISTRATION_CAPTCHA¶

Визначає, чи має бути захищено нові облікові записи за допомогою CAPTCHA. Типово, захист увімкнено.

If turned on, a CAPTCHA is added to all pages where a user enters their e-mail address:

Реєстрація нового облікового запису.
Відновлення пароля.
Додавання адреси електронної пошти до облікового запису.
Контактна форма для користувачів, які не увійшли до системи.

Зараз захист складається з наступних кроків:

Математична капча, яку розгадує користувач.
Proof of work challenge calculated by the browser. The difficulty can be adjusted using ALTCHA_COST, ALTCHA_MEMORY_COST, and ALTCHA_PARALLELISM.

REGISTRATION_EMAIL_MATCH¶

Надає вам змогу фільтрувати, які адреси електронної пошти можна реєструвати.

Типове значення — .*, що надає змогу реєструвати будь-яку адресу електронної пошти.

Ви можете скористатися ним для обмеження реєстрації єдиним доменом електронної пошти:

REGISTRATION_EMAIL_MATCH = r"^.*@weblate\.org$"

REGISTRATION_ALLOW_DISPOSABLE_EMAILS¶

Added in version 5.16.1.

Дозволити реєстрацію з використанням одноразових доменів електронної пошти. Якщо ця опція увімкнена, список заблокованих одноразових доменів ігнорується. За замовчуванням встановлено значення False.

Дивись також

REGISTRATION_OPEN¶

Визначає, чи дозволено реєстрацію нових облікових записів. Типово увімкнено.

Цей параметр впливає на вбудовану автентифікацію за адресою електронної пошти або через соціальну автентифікацію Python (ви можете дозволити певні бек-енди за допомогою REGISTRATION_ALLOW_BACKENDS).

Примітка

Якщо використано сторонні способи розпізнавання, зокрема Розпізнавання за допомогою LDAP, це просто призводить до приховування реєстраційної форми, але нові користувачі попри це зможуть входити до системи і створювати облікові записи.

Дивись також

REGISTRATION_ALLOW_BACKENDS
REGISTRATION_EMAIL_MATCH
Розпізнавання

REGISTRATION_REBIND¶

Added in version 4.16.

Уможливлює повторну прив’язку модулів розпізнавання для наявних користувачів. Увімкніть при перенесенні між різними надавачами засобів для розпізнавання.

Примітка

Типово, вимкнено, щоб заборонити додавання інших модулів розпізнавання до наявного облікового запису. Повторна прив’язка може призвести до компрометації облікового запису при використанні додаткових сторонніх модулів розпізнавання.

REPOSITORY_ALERT_THRESHOLD¶

Added in version 4.0.2.

Порогове значення для вмикання попередження щодо застарілих сховищ, у яких міститься надто багато змін. Типове значення — 25.

Дивись також

Попередження щодо складників перекладу

REQUIRE_LOGIN¶

Added in version 4.1.

Це вмикає django.contrib.auth.middleware.LoginRequiredMiddleware та налаштовує REST framework на вимогу автентифікації для всіх кінцевих точок API.

Змінено в версії 5.15: Weblate тепер покладається на вбудоване проміжне програмне забезпечення Django.

Примітка

Це реалізовано у Зразок налаштувань. Для Docker скористайтеся WEBLATE_REQUIRE_LOGIN.

SENTRY_DSN¶

Sentry DSN, яким слід скористатися для Збирання звітів щодо помилок та стеження за швидкодією.

Дивись також

Інтеграція Django із Sentry

SENTRY_ENVIRONMENT¶

Налаштовує середовище для Sentry. Типовим є devel.

SENTRY_MONITOR_BEAT_TASKS¶

Added in version 5.13.

Налаштуйте, чи слід моніторити завдання Celery Beat за допомогою Sentry. За замовчуванням — True.

SENTRY_PROFILES_SAMPLE_RATE¶

Налаштувати частоту спостереження за швидкодією. Встановіть значення 1 для стеження за усіма подіями, 0 (типове значення) вимикає трасування.

Дивись також

Моніторинг продуктивності Sentry

SENTRY_SEND_PII¶

Дозволити Sentry збирання певних даних особистої ідентифікації. Типово вимкнено.

Змінено в версії 5.7: У поточній версії типово вимкнено, раніше було увімкнено.

SENTRY_TRACES_SAMPLE_RATE¶

Налаштувати частоту спостереження за профілюванням. Встановіть значення 1 для стеження за усіма подіями, 0 (типове значення) вимикає трасування.

Дивись також

Профілювання Sentry

SIMPLIFY_LANGUAGES¶

Використовувати прості коди мов для типових комбінацій мова-країна. Наприклад, для перекладу fr_FR буде використано код мови fr. Зазвичай, така поведінка є бажаною, оскільки спрощує побудову списку мов для цих типових комбінацій.

Вимкніть, якщо вам потрібні різні переклади для кожного з варіантів.

HIDE_SHARED_GLOSSARY_COMPONENTS¶

Added in version 5.16.

Компоненти глосарію зазвичай передаються в інші проекти, щоб зробити їх доступними для перекладацької роботи. Коли вони відображаються у списку компонентів проектів, які їх використовують, це може спричинити плутанину або відволікти перекладачів від фактичних компонентів, які призначені для перекладу.

За замовчуванням це вимкнено, що робить спільні компоненти глосарію видимими.

SITE_DOMAIN¶

Налаштовує домен сайта. Домен потрібен для створення правильних абсолютних посилань у багатьох областях застосування (наприклад, для повідомлень активації, сповіщень та стрічок RSS).

Якщо Weblate запущено на нестандартному порту, допишіть його до вказаної адреси.

Приклади:

# Production site with domain name
SITE_DOMAIN = "weblate.example.com"

# Local development with IP address and port
SITE_DOMAIN = "127.0.0.1:8000"

Примітка

Цей параметр має містити лише назву домену. Для налаштованого протоколу (увімкнутого і примусово встановленого HTTPS) скористайтеся ENABLE_HTTPS, а для зміни адреси скористайтеся URL_PREFIX.

Підказка

У контейнері Docker домен сайта можна налаштувати за допомогою WEBLATE_ALLOWED_HOSTS.

Дивись також

SITE_TITLE¶

Назва сайта, яку буде використано для сайта і надсилання повідомлень електронною поштою.

SPECIAL_CHARS¶

Додаткові символи, які слід включити на візуальну клавіатуру, Візуальна клавіатура.

Типове значення:

SPECIAL_CHARS = ("\t", "\n", "\u00a0", "…")

SINGLE_PROJECT¶

Переспрямовує користувачів безпосередньо до проєкту або складника замість показу панелі приладів. Ви можете встановити значення True — у цьому випадку це працюватиме, лише якщо на Weblate є лише один проєкт. У протилежному випадку встановіть ідентифікатор проєкту, і він безумовно переспрямовуватиме до цього проєкту.

Приклад:

SINGLE_PROJECT = "test"

SSH_EXTRA_ARGS¶

Added in version 4.9.

Уможливлює додавання нетипових параметрів, якщо Weblate викликає SSH. Це корисно, при встановленні з’єднання із серверами з використанням застарілого шифрування або іншими нестандартними можливостями.

Наприклад, при встановленні з’єднання SSH у Weblate з’являється повідомлення про помилку Unable to negotiate with legacyhost: no matching key exchange method found. Their offer: diffie-hellman-group1-sha1, ви можете увімкнути потрібні можливості за допомогою такого:

SSH_EXTRA_ARGS = "-oKexAlgorithms=+diffie-hellman-group1-sha1"

Підказка

Рядок буде оброблено командною оболонкою, тому слід взяти у лапки усі пробіли і спеціальні символи.

Дивись також

Застарілі параметри OpenSSH

STATUS_URL¶

Адреса, на яку екземпляр Weblate повідомляє про свій стан.

SUPPORT_STATUS_CHECK¶

Added in version 5.5.

Вимикає піврічну перевірку стану підтримки та перенаправлення суперкористувачів під час входу на сторінку фінансування у разі відсутності активної передплати підтримки.

Підказка

Удоскональте роботу з Weblate, придбавши передплату на підтримку і прискорюючи прогрес Weblate замість того, щоб вимкнути її.

TRANSLATION_UPLOAD_MAX_SIZE¶

Added in version 5.17.1.

Встановлює максимальний розмір завантажуваних файлів перекладу в байтах. За замовчуванням — 50 МБ.

У Docker налаштуйте це за допомогою змінної середовища WEBLATE_TRANSLATION_UPLOAD_MAX_SIZE.

UNUSED_ALERT_DAYS¶

Added in version 4.17.

Налаштовує часову умову для появи нагадування Здається, складником не користуються.

Типовим значенням є 365 днів. Встановіть 0, щоб вимкнути обмеження.

UPDATE_LANGUAGES¶

Added in version 4.3.2.

Керує тим, чи слід оновлювати базу даних мови під час перенесення бази даних. Типово увімкнено. Цей параметр не впливає на підсумки виклику setuplang.

Попередження

З цим параметром показ мов може стати неоднорідним. Визначення мов Weblate з часом розширюють, і код мови для визначених мов не буде показано.

Дивись також

Вбудовані визначення мов

URL_PREFIX¶

За допомогою цього параметра ви можете запускати Weblate з певним значенням шляху (якщо параметр не вказано, програма покладатиметься на те, що її запущено з кореневого каталогу вебсервера).

Примітка

Щоб скористатися цим параметром, вам також слід налаштувати ваш сервер на вилучення цього префікса. Наприклад, для WSGI вилучення можна досягти встановленням параметра WSGIScriptAlias.

Підказка

Префікс має розпочинатися з /.

Приклад:

URL_PREFIX = "/translations"

Примітка

Цей параметр не працює із вбудованим сервером Django. Вам доведеться скоригувати urls.py так, щоб у ньому містився цей префікс.

VCS_ALLOW_HOSTS¶

Added in version 5.15.

Набір хостів, які слід дозволити під час налаштування URL-адреси VCS. За замовчуванням використовується порожній набір, що означає відсутність будь-якої фільтрації.

Якщо встановлено параметр VCS_RESTRICT_PRIVATE, відповідні хости також звільняються від обмеження щодо приватних цілей.

VCS_ALLOW_SCHEMES¶

Added in version 5.15.

Набір схем URL-адрес, які слід дозволити під час налаштування URL-адреси VCS. За замовчуванням дозволено лише https та ssh.

VCS_RESTRICT_PRIVATE¶

Added in version 5.17.

Відхиляти URL-адреси репозиторіїв VCS, що вказують на внутрішні або непублічні адреси, якщо цільовий хост не вказано у VCS_ALLOW_HOSTS. Увімкнено за замовчуванням.

Якщо ця опція увімкнена, імена хостів, які не вдається розпізнати під час перевірки, відхиляються, якщо вони явно не вказані в VCS_ALLOW_HOSTS.

VCS_API_DELAY¶

Added in version 4.15.1.

Configures minimal delay in seconds between third-party API calls in Запити щодо злиття GitHub, Запити щодо об’єднання GitLab, Запити щодо злиття Gitea, Запити щодо об’єднання Pagure, and Запити щодо об’єднання Azure DevOps.

Це обмежує частоту викликів програмного інтерфейсу з Weblate до цих служб, щоб уникнути перевантаження.

Якщо вашу роботу обмежує вторинний засіб обмеження частоти на GitHub, може допомогти збільшення цього значення.

Типове значення: 10.

VCS_API_TIMEOUT¶

Added in version 5.15.

Configures timeout in seconds for third-party API calls such as forking or creating merge requests in Запити щодо злиття GitHub, Запити щодо об’єднання GitLab, Запити щодо злиття Gitea, Запити щодо об’єднання Pagure, and Запити щодо об’єднання Azure DevOps.

Типове значення: 10.

VCS_BACKENDS¶

Налаштовування доступних модулів систем керування версіями.

Примітка

Weblate намагається скористатися усіма підтримуваними модулями, для яких є відповідні інструменти.

Підказка

За допомогою цього ви можете обмежити варіанти і додавати нетипові модулі систем керування версіями.

VCS_BACKENDS = ("weblate.vcs.git.GitRepository",)

Дивись також

Інтеграція з системою керування версіями

VCS_CLONE_DEPTH¶

Визначає, наскільки глибоким має бути клонування сховищ у Weblate.

Примітка

У поточній версії підтримку передбачено лише у Git. Типово, Weblate створює поверхневі клони сховищ, щоб пришвидшити клонування і заощадити місце на диску. Залежно від ваших підходів до користування (наприклад, використання нетипових Додатки), у вас може виникнути потреба у збільшенні глибини або вимиканні поверхневих клонів повністю встановленням значення 0.

Підказка

Якщо при записі з Weblate ви отримуєте повідомлення fatal: protocol error: expected old/new/ref, got 'shallow <commit hash>', вимкніть поверхневі клонування повністю:

VCS_CLONE_DEPTH = 0

WEBLATE_ADDONS¶

Список додатків, якими можна скористатися. Щоб скористатися ними, їх слід увімкнути для певного складника перекладу. Типово, до списку буде включено всі вбудовані додатки. За розширення списку вам, імовірно, слід зберегти наявні додатки ввімкненими. Приклад:

WEBLATE_ADDONS = (
    # Built-in add-ons
    "weblate.addons.gettext.GenerateMoAddon",
    "weblate.addons.gettext.UpdateLinguasAddon",
    "weblate.addons.gettext.UpdateConfigureAddon",
    "weblate.addons.gettext.MsgmergeAddon",
    "weblate.addons.gettext.GettextAuthorComments",
    "weblate.addons.cleanup.CleanupAddon",
    "weblate.addons.consistency.LanguageConsistencyAddon",
    "weblate.addons.discovery.DiscoveryAddon",
    "weblate.addons.flags.SourceEditAddon",
    "weblate.addons.flags.TargetEditAddon",
    "weblate.addons.flags.SameEditAddon",
    "weblate.addons.flags.BulkEditAddon",
    "weblate.addons.generate.GenerateFileAddon",
    "weblate.addons.properties.PropertiesSortAddon",
    "weblate.addons.git.GitSquashAddon",
    "weblate.addons.removal.RemoveComments",
    "weblate.addons.removal.RemoveSuggestions",
    "weblate.addons.resx.ResxUpdateAddon",
    "weblate.addons.autotranslate.AutoTranslateAddon",
    "weblate.addons.cdn.CDNJSAddon",
    # Add-on you want to include
    "weblate.addons.example.ExampleAddon",
)

Примітка

Вилучення додатка зі списку не призводить до видалення його зі складників. У цьому випадку стається збій Weblate. Вилучте додаток з усіх складників, перш ніж вилучати його зі списку.

Дивись також

ADDON_ACTIVITY_LOG_EXPIRY¶

Added in version 5.6.

Дозволяє налаштувати тривалість зберігання журналів діяльності додатків. Типовим значенням є 180 днів.

WEBLATE_EXPORTERS¶

Added in version 4.2.

Список доступних засобів експортування, які надають змогу отримувати переклади або глосарії у різноманітних форматах.

Дивись також

Формати файлів локалізації

WEBLATE_FORMATS¶

Список форматів файлів, якими ви можете скористатися.

Примітка

У типовому списку вже є загальновживані формати.

Дивись також

Формати файлів локалізації

WEBLATE_MACHINERY¶

Added in version 4.13.

Список служб комп’ютерного перекладу, якими можна скористатися.

Дивись також

WEBLATE_GPG_IDENTITY¶

Профіль, який буде використано Weblate для підписування Git. Приклад:

WEBLATE_GPG_IDENTITY = "Weblate <weblate@example.com>"

Програма виконає пошук у сховищі ключів GPG Weblate відповідного ключа (home/.gnupg у DATA_DIR). Якщо ключа не буде знайдено, ключ буде створено. Будь ласка, ознайомтеся із розділом Підписування внесків Git за допомогою GnuPG, щоб дізнатися більше.

Дивись також

Підписування внесків Git за допомогою GnuPG

WEBSITE_REQUIRED¶

Визначає, чи має бути вказано Вебсайт проєкту при створенні проєкту. Типово увімкнено, оскільки це відповідає налаштуванням загальнодоступних серверів.

WEBSITE_ALERTS_ENABLED¶

Added in version 5.17.

Типове значення: True

Визначає, чи повинен Weblate перевіряти доступність веб-сайтів проектів і показувати сповіщення про недоступні веб-сайти проектів.

Якщо встановити значення False, Weblate пропустить перевірку доступності веб-сайту та не створюватиме сповіщення щодо веб-сайту проекту. Це корисно в таких випадках:

Ваші веб-сайти захищені брандмауерами, які блокують запити Weblate
Ви хочете уникнути помилок типу 403/503, пов’язаних із захистом від ботів
Доступність веб-сайту проекту не впливає на вашу інсталяцію

Дивись також

WEBSITE_REQUIRED