Конфигурация¶

Все настройки хранятся в файле settings.py (как обычно для проектов Django).

Примечание

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

В случае, если Weblate работает через mod_wsgi, для перезагрузки конфигурации вам нужно перезапустить Apache.

См. также

Пожалуйста, также обратитесь к документации Django за параметрами, настраивающими сам Django.

ADMINS_CONTACT¶

Настройка, указывающая, куда отправлять электронные письма из контактной формы. Если не настроена, будут использованы адреса электронной почты из ADMINS.

Настройте это как список адресов электронной почты:

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

См. также

CONTACT_FORM
ADMINS

ALLOWED_ASSET_DOMAINS¶

Добавлено в версии 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¶

Добавлено в версии 5.14.

Настраивает ограничение размера при получении ресурсов в Weblate. По умолчанию — 10 МБ.

См. также

ALLOWED_ASSET_DOMAINS

ASSET_PRIVATE_ALLOWLIST¶

Добавлено в версии 2025.5.

Определяет имена хостов или домены, освобождённые от ASSET_RESTRICT_PRIVATE для загрузки удалённых ресурсов, применяющих проверки частных целей. Записи следуют семантике сопоставления хостов Django, поэтому можно использовать такие значения, как assets.internal.example или .internal.example.

Это не заменяет ALLOWED_ASSET_DOMAINS; удалённые ресурсы по-прежнему должны соответствовать списку разрешённых доменов ресурсов.

Стандартная конфигурация:

ASSET_PRIVATE_ALLOWLIST = []

См. также

ALLOWED_ASSET_DOMAINS
ASSET_RESTRICT_PRIVATE

ASSET_RESTRICT_PRIVATE¶

Добавлено в версии 2025.5.

Отклонять URL-адреса удалённых ресурсов, указывающие на внутренние или непубличные адреса, если целевой хост не включён в ASSET_PRIVATE_ALLOWLIST. Включено по умолчанию.

Когда эта функция включена, имена хостов, которые не могут быть разрешены во время проверки, отклоняются, если они явно не включены в ASSET_PRIVATE_ALLOWLIST. В настоящее время это применяется к загрузке снимков экрана по URL-адресу и удалённой загрузке HTML для надстройки CDN локализации JavaScript.

См. также

ALTCHA_COST¶

Добавлено в версии 5.18.

Стоимость времени Argon2id для задачи доказательства выполнения работы ALTCHA. По умолчанию 3.

Заменяет ALTCHA_MAX_NUMBER, который применялся к удалённому виджету ALTCHA v2.

ALTCHA_MEMORY_COST¶

Добавлено в версии 5.18.

Стоимость памяти Argon2id в КиБ. По умолчанию 65536.

ALTCHA_PARALLELISM¶

Добавлено в версии 5.18.

Фактор параллелизма Argon2id. По умолчанию 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¶

Префикс для генерирования URL-адресов аватаров в выражении ${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¶

Добавлено в версии 4.5.2.

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

В данный момент оно управляет:

Автоматический перевод addon
Перерасчёт: Проверки и исправления

Возможные варианты:

monthly (ежемесячно) (по умолчанию)
weekly
daily
never

Примечание

Увеличение частоты не рекомендуется, если Weblate содержит тысячи компонентов.

BASIC_LANGUAGES¶

Добавлено в версии 4.4.

Список языков, который будет предлагаться пользователям при создании нового перевода. Если не задан, то будет использоваться встроенный список, который включает все распространённые языки, но без добавления вариантов для конкретных стран.

Это не даёт непривилегированным пользователям добавлять нежелательные языки. Это не влияет на администраторов проектов — они всё также могут выбирать из полного списка языков, доступных в Weblate.

Примечание

Это также не определяет новые языки в Weblate, а только фильтрует те, что уже присутствуют в базе данных.

Пример:

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

См. также

Определение языков

BORG_EXTRA_ARGS¶

Добавлено в версии 4.9.

Вы можете передать дополнительные аргументы в команде borg create, когда запускается встроенное резервное копирование.

Пример:

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

См. также

CACHE_DIR¶

Добавлено в версии 4.16.

Каталог, в котором Weblate хранит файлы кэша. По умолчанию используется подпапка cache в DATA_DIR.

Измените это значение на локальную или временную файловую систему, если DATA_DIR находится на сетевой файловой системе.

Weblate хранит здесь сгенерированные вспомогательные файлы и выполняет некоторые из них, поэтому CACHE_DIR должен быть доступен для записи и смонтирован в файловой системе, которая позволяет выполнение. Избегайте использования параметров монтирования noexec для этого каталога.

Docker-контейнер использует для этого отдельный том, смотреть раздел Тома контейнеров Docker’а.

Обычно существуют следующие подкаталоги:

ssh: Сгенерированные вспомогательные файлы, используемые для доступа к СКВ.
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¶

Добавлено в версии 5.17.1.

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

В Docker настройте это с помощью переменной окружения WEBLATE_COMPONENT_ZIP_UPLOAD_MAX_SIZE.

См. также

Настройки компонента

CONTACT_FORM¶

Добавлено в версии 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": Полностью отключает контактную форму.

Добавлено в версии 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: Пользовательский

Используйте Настраиваемый, если списками контроля доступа вы управляете вручную, что означает, что вы не полагаетесь на внутреннее управление Weblate.

См. также

DEFAULT_AUTO_WATCH¶

Добавлено в версии 4.5.

Настраивает, должен ли параметр Автоматически добавлять проект в отслеживаемые при правке быть включён по умолчанию для новых пользователей. Значение по умолчанию: True.

См. также

Уведомления

DEFAULT_RESTRICTED_COMPONENT¶

Добавлено в версии 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¶

Добавлено в версии 4.3.2.

Исходный язык для любых новых компонентов.

По умолчанию — en. Соответствующая запись для данного языка должна присутствовать в базе данных.

См. также

DEFAULT_MERGE_STYLE¶

Стиль слияния для любых новых компонентов.

rebase — по умолчанию
merge

См. также

DEFAULT_SHARED_TM¶

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

DEFAULT_TRANSLATION_REVIEW¶

Добавлено в версии 5.16.

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

DEFAULT_SOURCE_REVIEW¶

Добавлено в версии 5.16.

Настраивает значение по умолчанию для Включить рецензии исходных строк, по умолчанию отключено.

DEFAULT_AUTOCLEAN_TM¶

Добавлено в версии 5.13.

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

DEFAULT_TRANSLATION_PROPAGATION¶

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

См. также

DEFAULT_PULL_MESSAGE¶

Настраивает заголовок и сообщение по умолчанию для запросов на извлечение.

ENABLE_AVATARS¶

Следует ли включать аватары на основе Gravatar для пользователей. По умолчанию включено.

Аватары извлекаются и кэшируются на сервере, что снижает риск утечки персональной информации и ускоряет взаимодействие с пользователем.

См. также

ENABLE_HOOKS¶

Включить ли анонимные удалённые обработчики.

См. также

Обработчики уведомлений

ENABLE_HTTPS¶

Изменено в версии 5.7: Weblate теперь требует https для поддержки WebAuthn.

Отправлять ли ссылки на Weblate по протоколу HTTPS или HTTP. Этот параметр влияет на отправленные сообщения электронной почты и сгенерированные абсолютные URL-адреса.

В конфигурации по умолчанию он также используется для нескольких связанных с HTTPS параметров Django — он включает безопасные куки, переключает 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¶

Добавлено в версии 4.15.

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

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

Предупреждение

Строка не обрабатывается, она вставляется в заголовок HTML как есть.

GET_HELP_URL¶

Добавлено в версии 4.5.2.

URL, где можно найти поддержку для вашего экземпляра Weblate.

GITEA_CREDENTIALS¶

Добавлено в версии 4.12.

Список учётных данных для серверов Gitea.

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

Словарь конфигурации состоит из учётных данных, определённых для каждого сервера API. Структура словаря одинакова практически для всех интеграций с системой управления версиями и описана в Настройка учётных данных контроля версий.

См. также

GITLAB_CREDENTIALS¶

Добавлено в версии 4.3.

Список учётных данных для серверов GitLab.

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

Примечание

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

См. также

GITHUB_CREDENTIALS¶

Добавлено в версии 4.3.

Список учётных данных для серверов GitHub.

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

Примечание

Можно использовать как детализированные, так и классические персональные токены доступа. Детализированные токены ограничены одной организацией, поэтому они не будут работать, если вы хотите, чтобы Weblate создал форк репозитория за пределами организации (обычно в пространство имён пользователя).

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

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

Подсказка

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

См. также

BITBUCKETSERVER_CREDENTIALS¶

Добавлено в версии 4.16.

Список учётных данных для Bitbucket Data Center.

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

См. также

BITBUCKETCLOUD_CREDENTIALS¶

Добавлено в версии 5.8.

Список учётных данных для серверов Bitbucket Cloud.

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

Словарь конфигурации состоит из учётных данных, определённых для каждого сервера API. Сервер API может отличаться от того, который используется в веб-браузере, например, доступ к API GitHub осуществляется по адресу api.github.com.

Для каждого сервера доступна следующая конфигурация:

username: Пользователь API.
workspace: Плашка рабочей области пользователя.
token: Токен API с разрешением pullrequest:write.

Дополнительные настройки, не описанные здесь, можно найти в Настройка учётных данных контроля версий.

См. также

AZURE_DEVOPS_CREDENTIALS¶

Добавлено в версии 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-токен для пользователя API.

Дополнительные настройки, не описанные здесь, можно найти в Настройка учётных данных контроля версий.

См. также

GOOGLE_ANALYTICS_ID¶

Идентификатор Google Analytics для включения мониторинга Weblate с помощью Google Universal Analytics.

Примечание

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

HIDE_REPO_CREDENTIALS¶

Скрыть учётные данные репозитория в веб-интерфейсе. В случае, если в URL репозитория содержится пользователь и пароль, Weblate спрячет их, когда соответствующая информация будет показываться пользователям.

Например, вместо https://user:password@git.example.com/repo.git будет показано просто https://git.example.com/repo.git. Аналогичным образом он пытается очистить и сообщения об ошибках системы контроля версий.

Примечание

Включено по умолчанию.

VERSION_DISPLAY¶

Добавлено в версии 5.17.

Управляет тем, насколько заметно Weblate раскрывает свою собственную версию.

Поддерживаемые значения:

show: Показывать версию в общем интерфейсе, например в нижнем колонтитуле, и раскрывать её в GET /api/metrics/.
soft: Скрывать версию из заметного общего интерфейса, но оставлять её доступной на странице О программе и в GET /api/metrics/.
hide: Скрывать версию из общего интерфейса и GET /api/metrics/. Это также заставляет анонимные ссылки на документацию указывать на последнюю версию документации вместо версии, соответствующей установленному выпуску.

Сокрытие версии является рекомендованной практикой безопасности в некоторых корпорациях, но это не мешает злоумышленнику определить версию, изучая поведение.

Примечание

Значение по умолчанию — show.

HIDE_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-адрес при включении параметра 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/ru-RU/docs/Web/HTTP/Reference/Headers/X-Forwarded-For#security_and_privacy_concerns> для получения более подробной информации.

По умолчанию -1.

См. также

LEGAL_TOS_DATE¶

Добавлено в версии 4.15.

Примечание

Чтобы это работало, необходимо установить Юридический модуль.

Дата последнего обновления условий предоставления услуг. При изменении даты пользователи должны согласиться с обновлёнными условиями обслуживания.

from datetime import date

LEGAL_TOS_DATE = date(2022, 2, 2)

LEGAL_URL¶

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 для разрешения более длинных переводов (до 10 000 символов) независимо от длины исходной строки.

Примечание

По умолчанию установлен в 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.

Подсказка

На Hosted Weblate для этого параметра используется значение https://weblate-cdn.com/.

См. также

MATOMO_SITE_ID¶

Идентификатор (ID) сайта в Matomo (ранее Piwik), который вы хотите использовать для отслеживания Weblate.

Примечание

Эта интеграция не поддерживает Matomo Tag Manager.

См. также

MATOMO_URL

MATOMO_URL¶

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

Подсказка

Эта интеграция не поддерживает Matomo Tag Manager.

Например:

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

См. также

MATOMO_SITE_ID

NEARBY_MESSAGES¶

Количество соседних строк сверху и снизу, показываемых в полном редакторе.

Это всего лишь значение по умолчанию, пользователи могут настроить его в Профиль пользователя.

DEFAULT_PAGE_LIMIT¶

Добавлено в версии 4.7.

Количество элементов по умолчанию, отображаемых при активной нумерации страниц .

PAGURE_CREDENTIALS¶

Добавлено в версии 4.3.2.

Список учётных данных для серверов Pagure.

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

См. также

PASSWORD_MINIMAL_STRENGTH¶

Добавлено в версии 5.10.2.

Минимальный балл надёжности пароля, оцениваемый с помощью zxcvbn.

По умолчанию — 0, что означает отключение проверки надёжности.

См. также

PASSWORD_RESET_URL¶

Добавлено в версии 5.17.

URL-адрес для сброса пароля, когда аутентификация обрабатывается внешним поставщиком удостоверений, таким как LDAP, SAML или OAuth.

При установке ссылка Забыли пароль? на странице входа будет вести на этот URL-адрес вместо встроенной страницы сброса пароля Weblate.

PRIVACY_URL¶

Добавлено в версии 4.8.1.

URL-адрес, по которому ваш экземпляр Weblate показывает свою политику конфиденциальности.

Подсказка

Полезно, если вы размещаете свои юридические документы за пределами Weblate для их встраивания в Weblate, пожалуйста, проверьте Юридический модуль для получения подробной информации.

Пример:

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

См. также

LEGAL_URL

PRIVATE_COMMIT_EMAIL_OPT_IN¶

Добавлено в версии 4.15.

Определяет, является ли личное электронное письмо о фиксации согласия или отказа (по умолчанию это согласие).

Подсказка

Эта настройка применяется только к тем пользователям, которые не выбрали в явном виде эл. почту для коммита.

См. также

Профиль
PRIVATE_COMMIT_EMAIL_TEMPLATE

PRIVATE_COMMIT_EMAIL_TEMPLATE¶

Добавлено в версии 4.15.

Шаблон для создания частного адреса электронной почты для коммитов пользователя. По умолчанию — "{username}@users.noreply.{site_domain}".

Может содержать {user_id}, {username}, {site_title} и {site_domain}.

Установите пустую строку, чтобы отключить.

Примечание

Использование другого адреса электронной почты для коммитов требует согласия пользователя, если не настроено с помощью PRIVATE_COMMIT_EMAIL_OPT_IN. Пользователи могут настроить свой адрес электронной почты для коммитов в Профиль.

PRIVATE_COMMIT_NAME_OPT_IN¶

Добавлено в версии 5.16.

Определяет, требует ли использование частного имени для коммитов согласия или отказа (по умолчанию требуется согласие).

Подсказка

Этот параметр применяется только к пользователям, которые явно не выбрали имя для коммитов.

См. также

Профиль
PRIVATE_COMMIT_NAME_TEMPLATE

PRIVATE_COMMIT_NAME_TEMPLATE¶

Добавлено в версии 5.16.

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

Может содержать {user_id}, {username}, {site_title} и {site_domain}.

Установите пустую строку, чтобы отключить.

Примечание

Использование другого имени для коммитов требует согласия пользователя, если не настроено с помощью PRIVATE_COMMIT_NAME_OPT_IN. Пользователи могут настроить своё имя для коммитов в Профиль.

PROJECT_BACKUP_KEEP_COUNT¶

Добавлено в версии 4.14.

Определяет, сколько резервных копий на проект хранится на сервере. По умолчанию 3.

См. также

Резервные копии на уровне проекта

PROJECT_BACKUP_KEEP_DAYS¶

Добавлено в версии 4.14.

Определяет, как долго резервные копии проекта будут храниться на сервере. По умолчанию 30 дней.

См. также

Резервные копии на уровне проекта

PROJECT_BACKUP_UPLOAD_MAX_SIZE¶

Добавлено в версии 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¶

Добавлено в версии 5.17.

Определяет максимальное количество записей в ZIP-файле, разрешённое при импорте резервной копии проекта.

Это защита от повреждённых или намеренно фрагментированных архивов. По умолчанию — 100000 записей.

In Docker, configure this using the WEBLATE_PROJECT_BACKUP_IMPORT_MAX_MEMBERS environment variable.

См. также

Резервные копии на уровне проекта

PROJECT_BACKUP_IMPORT_MAX_TOTAL_UNCOMPRESSED_SIZE¶

Добавлено в версии 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¶

Добавлено в версии 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¶

Добавлено в версии 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¶

Добавлено в версии 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¶

Добавлено в версии 4.15.

Определяет регулярное выражение для ограничения именования проектов. Все совпадающие имена будут отклонены.

См. также

Название проекта

PROJECT_WEB_RESTRICT_HOST¶

Добавлено в версии 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¶

Добавлено в версии 5.17.

Определяет набор идентификаторов (slug) проектов, освобождённых от 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¶

Добавлено в версии 4.16.2.

Запретить использование числового IP-адреса на сайте проекта. По умолчанию включено.

См. также

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

PROJECT_WEB_RESTRICT_PRIVATE¶

Добавлено в версии 5.17.

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

См. также

PROJECT_WEB_RESTRICT_RE¶

Добавлено в версии 4.15.

Определяет регулярное выражение для ограничения того, что можно ввести в Веб-сайт проекта. Любые соответствующие URL-адреса будут отклонены.

См. также

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

WEBHOOK_PRIVATE_ALLOWLIST¶

Добавлено в версии 5.17.

Определяет имена хостов или домены, освобождённые от WEBHOOK_RESTRICT_PRIVATE при доставке исходящих веб-обработчиков. Записи следуют семантике сопоставления хостов Django, поэтому можно использовать такие значения, как hooks.internal.example или .internal.example.

Стандартная конфигурация:

WEBHOOK_PRIVATE_ALLOWLIST = []

См. также

WEBHOOK_RESTRICT_PRIVATE

WEBHOOK_RESTRICT_PRIVATE¶

Добавлено в версии 5.17.

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

Когда эта функция включена, имена хостов, которые не могут быть разрешены во время проверки, отклоняются, если они явно не включены в WEBHOOK_PRIVATE_ALLOWLIST.

См. также

PUBLIC_ENGAGE¶

Добавлено в версии 5.16.2.

Разрешает публичную страницу вовлечения, даже если установлен REQUIRE_LOGIN.

См. также

Построение сообщества переводчиков

RATELIMIT_NOTIFICATION_LIMITS¶

Добавлено в версии 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¶

Добавлено в версии 4.1.

Список методов авторизации (backends), с помощью которых доступна регистрация. Это вводит ограничения только на новые регистрации. Независимо от данного параметра пользователи смогут добавлять и использовать любые разрешённые в параметрах и настроенные методы авторизации.

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

Пример:

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

Подсказка

Имена бэкэндов совпадают с именами, используемыми в URL-адресах для авторизации.

См. также

REGISTRATION_CAPTCHA¶

Защищать ли регистрацию новых учётных записей с помощью CAPTCHA. По умолчанию значение включено.

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

Регистрация новой учётной записи.
Восстановление пароля.
Добавление в учётную запись адреса электронной почты.
Контактная форма для пользователей, не вошедших в систему.

Защита в настоящее время состоит из следующих шагов:

Математическая капча, которую должен решить пользователь.
Задача «доказательство выполнения работы», вычисляемая браузером. Сложность можно настроить с помощью ALTCHA_COST, ALTCHA_MEMORY_COST и ALTCHA_PARALLELISM.

REGISTRATION_EMAIL_MATCH¶

Позволяет вам отфильтровать допустимые для регистрации адреса электронной почты.

По умолчанию равен .*, что позволяет зарегистрироваться с любым адресом электронной почты.

Вы можете использовать этот параметр для ограничения регистрации одним доменом электронной почты:

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

REGISTRATION_ALLOW_DISPOSABLE_EMAILS¶

Добавлено в версии 5.16.1.

Разрешить регистрацию с использованием одноразовых доменов электронной почты. При включении блокировка одноразовых доменов обходится. По умолчанию False.

См. также

REGISTRATION_OPEN¶

Разрешена ли в данный момент регистрация новых учётных записей. По умолчанию значение включено.

Этот параметр влияет на встроенную авторизацию по адресу электронной почты или через Python Social Auth (при помощи параметра REGISTRATION_ALLOW_BACKENDS вы можете разрешить определённые бэкэнды).

Примечание

При использовании сторонних методов аутентификации, таких как Авторизация через LDAP, этот параметр просто скрывает форму регистрации, но новые пользователи всё равно могут войти в систему и создать учётные записи.

См. также

REGISTRATION_ALLOW_BACKENDS
REGISTRATION_EMAIL_MATCH
Авторизация

REGISTRATION_REBIND¶

Добавлено в версии 4.16.

Разрешить повторную привязку бэкэндов проверки подлинности для существующих пользователей. Включите этот параметр при миграции между поставщиками проверки авторизации.

Примечание

По умолчанию отключено, чтобы не разрешать добавление других бэкэндов авторизации к существующей учётной записи. Повторная привязка может привести к компрометации учётной записи при использовании большего количества сторонних бэкэндов авторизации.

REPOSITORY_ALERT_THRESHOLD¶

Добавлено в версии 4.0.2.

Порог срабатывания предупреждения для устаревших репозиториев или репозиториев, содержащих слишком много изменений. По умолчанию равен 25.

См. также

Предупреждения компонента перевода

REQUIRE_LOGIN¶

Добавлено в версии 4.1.

Это включает django.contrib.auth.middleware.LoginRequiredMiddleware и настраивает REST framework так, чтобы требовать аутентификацию для всех конечных точек API.

Изменено в версии 5.15: Теперь Weblate полагается на встроенное промежуточное ПО Django.

Примечание

Это реализовано в Пример файла настроек. Для Docker используйте WEBLATE_REQUIRE_LOGIN.

SENTRY_DSN¶

DSN Sentry для использования в Сбор отчётов об ошибках и мониторинг производительности.

См. также

Интеграция Sentry c Django

SENTRY_ENVIRONMENT¶

Настраивает окружение для Sentry. По умолчанию devel.

SENTRY_MONITOR_BEAT_TASKS¶

Добавлено в версии 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¶

Использовать простые коды языка для умолчательных комбинаций языка/страны. Например, при переводе ru_RU будет использоваться код языка ru. Обычно это желательное поведение, поскольку для таких умолчательных комбинаций оно упрощает перечисление языков.

Выключите этот параметр, если вы хотите разделять переводы для каждого варианта.

HIDE_SHARED_GLOSSARY_COMPONENTS¶

Добавлено в версии 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-адреса — параметр 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¶

Добавлено в версии 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¶

URL-адрес, по которому ваш экземпляр Weblate сообщает о своем статусе.

SUPPORT_STATUS_CHECK¶

Добавлено в версии 5.5.

Отключает полугодовую проверку статуса поддержки и перенаправление суперпользователей при входе на страницу пожертвований, если отсутствует активная подписка на поддержку.

Подсказка

Улучшите свой опыт работы с Weblate, приобретя подписку на поддержку и помогая развитию Weblate, вместо того чтобы отключать эту функцию.

TRANSLATION_UPLOAD_MAX_SIZE¶

Добавлено в версии 5.17.1.

Настраивает максимальный размер (в байтах) для загружаемых файлов перевода. По умолчанию — 50 МБ.

В Docker настройте это с помощью переменной окружения WEBLATE_TRANSLATION_UPLOAD_MAX_SIZE.

UNUSED_ALERT_DAYS¶

Добавлено в версии 4.17.

Настраивает, когда срабатывает предупреждение «Компонент кажется неиспользуемым».

По умолчанию установлено значение 365 дней, для отключения установите значение 0.

UPDATE_LANGUAGES¶

Добавлено в версии 4.3.2.

Определяет, должна ли база данных языков обновляться во время общей миграции базы данных. По умолчанию включено. Этот параметр никак не влияет на выполнение setuplang.

Предупреждение

При этом отображение языков может стать непоследовательным. Определения языков Weblate со временем расширяются, и он не будет отображать код языка для определённых языков.

См. также

Встроенные определения языков

URL_PREFIX¶

Этот параметр позволяет вам запускать Weblate по какому-либо пути (в противном случае он считает, что запущен из корня веб-сервера).

Примечание

Для использования этого параметра вам также нужно настроить ваш сервер на срезание этого префикса. Например, при использовании WSGI это можно сделать, установив псевдоним WSGIScriptAlias.

Подсказка

Префикс должен начинаться с символа /.

Пример:

URL_PREFIX = "/translations"

Примечание

Этот параметр не работает со встроенным сервером Django, чтобы он реагировал на этот префикс, вам придётся подправить urls.py.

VCS_ALLOW_HOSTS¶

Добавлено в версии 5.15.

Набор хостов, разрешённых при настройке URL-адреса СКВ. По умолчанию — пустой набор, который вообще не выполняет фильтрацию.

Когда VCS_RESTRICT_PRIVATE включён, соответствующие хосты также освобождаются от ограничения на частные цели.

VCS_ALLOW_SCHEMES¶

Добавлено в версии 5.15.

Набор схем URL, разрешённых при настройке URL-адреса СКВ. По умолчанию разрешены только https и ssh.

VCS_RESTRICT_PRIVATE¶

Добавлено в версии 5.17.

Отклонять URL-адреса репозиториев СКВ, указывающие на внутренние или непубличные адреса, если целевой хост не включён в VCS_ALLOW_HOSTS. Включено по умолчанию.

Когда эта функция включена, имена хостов, которые не могут быть разрешены во время проверки, отклоняются, если они явно не включены в VCS_ALLOW_HOSTS.

VCS_API_DELAY¶

Добавлено в версии 4.15.1.

Настраивает минимальную задержку в секундах между сторонними вызовами API в Запрос на извлечение в GitHub, Запросы на слияние в GitLab, Запрос на извлечение в Gitea, Запросы на слияние в Pagure и Запросы на извлечение Azure DevOps.

Эта скорость ограничивает вызовы API из Weblate к этим сервисам, чтобы не перегружать их.

Если вас ограничивает дополнительный ограничитель скорости на GitHub, его увеличение может помочь.

Значение по умолчанию — 10.

VCS_API_TIMEOUT¶

Добавлено в версии 5.15.

Настраивает тайм-аут в секундах для вызовов сторонних API, таких как создание форка или запросов на слияние в Запрос на извлечение в GitHub, Запросы на слияние в GitLab, Запрос на извлечение в Gitea, Запросы на слияние в Pagure и Запросы на извлечение 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¶

Добавлено в версии 5.6.

Настраивает, как долго хранятся журналы активности надстроек. По умолчанию — 180 дней.

WEBLATE_EXPORTERS¶

Добавлено в версии 4.2.

Список доступных экспортеров, предлагающих скачивание переводов или словарей в различных форматах файлов.

См. также

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

WEBLATE_FORMATS¶

Список доступных для использования форматов файлов.

Примечание

В списке по умолчанию уже есть распространённые форматы.

См. также

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

WEBLATE_MACHINERY¶

Добавлено в версии 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¶

Добавлено в версии 5.17.

По умолчанию: True

Определяет, должна ли Weblate проверять доступность веб-сайта проекта и показывать предупреждения для недоступных веб-сайтов проектов.

При установке в False Weblate будет пропускать проверки доступности веб-сайта и не будет генерировать предупреждения о веб-сайте проекта. Это полезно, когда:

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

См. также

WEBSITE_REQUIRED

Настройка учётных данных контроля версий¶

Подсказка

В этом разделе описаны такие переменные учётных данных VCS, как GITHUB_CREDENTIALS, GITLAB_CREDENTIALS, GITEA_CREDENTIALS, PAGURE_CREDENTIALS, BITBUCKETSERVER_CREDENTIALS.

Учётные данные также могут быть переопределены в URL для отправки в репозиторий или Репозиторий исходного кода (если URL-адрес для отправки не настроен); они имеют приоритет над указанными в файле конфигурации.

Для каждого сервера доступна следующая конфигурация:

username: Требуется пользователь API.
token: Требуется API-токен для пользователя API.
scheme: Добавлено в версии 4.18.

Переопределение схемы. Weblate пытается разобрать схему из URL репозитория и возвращается к https. Если вы используете API-сервер внутри компании, то вместо него можно использовать http, но при этом следует учитывать требования безопасности.

Подсказка

В контейнере Docker учетные данные могут быть настроены с помощью переменных окружения, см. Учётные данные сайтов хостинга кода.

Конфигурация¶

ADMINS_CONTACT¶

ALLOWED_ASSET_DOMAINS¶

ALLOWED_MACHINERY_DOMAINS¶

ALLOWED_ASSET_SIZE¶

ASSET_PRIVATE_ALLOWLIST¶

ASSET_RESTRICT_PRIVATE¶

ALTCHA_COST¶

ALTCHA_MEMORY_COST¶

ALTCHA_PARALLELISM¶

ANONYMOUS_USER_NAME¶

AUDITLOG_EXPIRY¶

AUTH_LOCK_ATTEMPTS¶

AUTO_UPDATE¶

AVATAR_URL_PREFIX¶

AUTH_TOKEN_VALID¶

AUTH_PASSWORD_DAYS¶

AUTOFIX_LIST¶

BACKGROUND_TASKS¶

BASIC_LANGUAGES¶

BORG_EXTRA_ARGS¶

CACHE_DIR¶

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

CHECK_LIST¶

COMMIT_PENDING_HOURS¶

COMPONENT_ZIP_UPLOAD_MAX_SIZE¶

CONTACT_FORM¶

DATA_DIR¶

DATABASE_BACKUP¶

DEFAULT_ACCESS_CONTROL¶

DEFAULT_AUTO_WATCH¶

DEFAULT_RESTRICTED_COMPONENT¶

DEFAULT_ADD_MESSAGE, DEFAULT_ADDON_MESSAGE, DEFAULT_COMMIT_MESSAGE, DEFAULT_DELETE_MESSAGE, DEFAULT_MERGE_MESSAGE¶

DEFAULT_ADDONS¶

DEFAULT_COMMITER_EMAIL¶

DEFAULT_COMMITER_NAME¶

DEFAULT_LANGUAGE¶

DEFAULT_MERGE_STYLE¶

DEFAULT_SHARED_TM¶

DEFAULT_TRANSLATION_REVIEW¶

DEFAULT_SOURCE_REVIEW¶

DEFAULT_AUTOCLEAN_TM¶

DEFAULT_TRANSLATION_PROPAGATION¶

DEFAULT_PULL_MESSAGE¶

ENABLE_AVATARS¶

ENABLE_HOOKS¶

ENABLE_HTTPS¶

ENABLE_SHARING¶

EXTRA_HTML_HEAD¶

GET_HELP_URL¶

GITEA_CREDENTIALS¶

GITLAB_CREDENTIALS¶

GITHUB_CREDENTIALS¶

BITBUCKETSERVER_CREDENTIALS¶

BITBUCKETCLOUD_CREDENTIALS¶

AZURE_DEVOPS_CREDENTIALS¶

GOOGLE_ANALYTICS_ID¶

HIDE_REPO_CREDENTIALS¶

VERSION_DISPLAY¶

HIDE_VERSION¶

IP_BEHIND_REVERSE_PROXY¶

IP_PROXY_HEADER¶

IP_PROXY_OFFSET¶

LEGAL_TOS_DATE¶

LEGAL_URL¶

LICENSE_EXTRA¶

LICENSE_FILTER¶

LICENSE_REQUIRED¶

LIMIT_TRANSLATION_LENGTH_BY_SOURCE_LENGTH¶

LOCALIZE_CDN_URL и LOCALIZE_CDN_PATH¶

MATOMO_SITE_ID¶

MATOMO_URL¶

NEARBY_MESSAGES¶

DEFAULT_PAGE_LIMIT¶

PAGURE_CREDENTIALS¶

PASSWORD_MINIMAL_STRENGTH¶

PASSWORD_RESET_URL¶

PRIVACY_URL¶

PRIVATE_COMMIT_EMAIL_OPT_IN¶

PRIVATE_COMMIT_EMAIL_TEMPLATE¶