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

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

Примечание

After changing any of these settings, you need to restart Weblate — both WSGI and Celery processes.

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

См.также

Также, пожалуйста, ознакомьтесь с документацией Django по настройке параметров самого Django.

AKISMET_API_KEY#

Weblate может использовать Akismet для проверки входящих анонимных предложений на спам. Посетите akismet.com, чтобы приобрести ключ API и связать его с сайтом.

ANONYMOUS_USER_NAME#

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

См.также

Управление доступом

AUDITLOG_EXPIRY#

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

How many days Weblate should keep audit logs (which contain info about account activity).

По умолчанию установлен в 180 дней.

AUTH_LOCK_ATTEMPTS#

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

В настоящее время оно применяется в следующих местах:

Страница входа. Удаляет пароль учётной записи, не позволяя пользователю войти в систему без запроса нового пароля.
Password reset. Prevents new e-mails from being sent, avoiding spamming users with too many password-reset attempts.

По умолчанию установлен в 10.

См.также

Ограничение частоты запросов

AUTO_UPDATE#

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

Изменено в версии 3.11: Первоначальные возможные значения параметра включено/выключено были изменены для дифференциации принимаемых строк.

Обновление всех репозиториев на ежедневной основе.

Подсказка

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

Примечание

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

The options are:

"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/'

См.также

Кеширование аватаров, ENABLE_AVATARS, Аватары

AUTH_TOKEN_VALID#

Сколько времени действует токен аутентификации и временный пароль из писем сброса пароля. Устанавливается в количество секунд, по умолчанию равен 172800 (2 дня).

AUTH_PASSWORD_DAYS#

How many days Weblate rejects reusing a previously used password for a user.

The checking is based on the audit log, AUDITLOG_EXPIRY needs to be at least same as this.

Примечание

Смена паролей, сделанная в версиях Weblate до версии 2.15, в этой политике учтена не будет.

По умолчанию установлен в 180 дней.

AUTOFIX_LIST#

Список автоматических исправлений, применяемых при сохранении строки.

Примечание

Provide a fully-qualified path to the Python class that implements the autofixer interface.

Доступные исправления:

weblate.trans.autofixes.whitespace.SameBookendingWhitespace: Выравнивает количество начальных и конечных пробельных символов в переводе с исходной строкой.
weblate.trans.autofixes.chars.ReplaceTrailingDotsWithEllipsis: Заменяет конечные точки (…) на многоточие (…), если оно есть в исходной строке.
weblate.trans.autofixes.chars.RemoveZeroSpace: Удаляет пробельные символы нулевой ширины, если исходная строка их не содержит.
weblate.trans.autofixes.chars.RemoveControlChars: Удаляет управляющие символы, если исходная строка их не содержит.
weblate.trans.autofixes.chars.DevanagariDanda: Replaces sentence full stop in Bangla by the devanagari danda character.
weblate.trans.autofixes.html.BleachHTML: Удаляет небезопасную HTML-разметку из строк, помеченных флагом safe-html (смотрите проверку Небезопасный HTML-код).

Вы можете выбрать, какие исправления использовать:

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

См.также

Автоматические исправления, Пользовательские автоматические исправления

BACKGROUND_TASKS#

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

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

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

addon-weblate.autotranslate.autotranslate.autotranslate addon
Перерасчёт: Проверки и исправления

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

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

Примечание

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

BASIC_LANGUAGES#

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

List of languages to offer users for starting a new translation. When not specified, a built-in list is used (which includes all commonly used languages, but without country specific variants).

This only limits non privileged users to add unwanted languages. Project admins are still presented with the full selection of languages defined in Weblate.

Примечание

This does not define new languages for Weblate — it only filters existing ones in the database.

Пример:

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

См.также

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

BORG_EXTRA_ARGS#

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

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

Пример:

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

См.также

Резервное копирование и перенос Weblate, borg create

CACHE_DIR#

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

Directory where Weblate stores cache files. Defaults to cache subfolder in DATA_DIR.

Change this to local or temporary filesystem if DATA_DIR is on a network filesystem.

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

CSP_SCRIPT_SRC, CSP_IMG_SRC, CSP_CONNECT_SRC, CSP_STYLE_SRC, CSP_FONT_SRC#

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

Все они по умолчанию установлены в пустой список.

Пример:

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

См.также

Политика безопасности содержимого, Политика безопасности содержимого (Content Security Policy — CSP)

CHECK_LIST#

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

Примечание

Предоставьте полный путь к классу Python, реализующему интерфейс проверки.

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

All built-in Проверки качества are turned on by default, from where you can change these settings. By default they are commented out in Пример файла настроек so that default values are used. New checks are then carried out for each new Weblate version.

Вы можете отключить все проверки:

CHECK_LIST = ()

Можете включить только некоторые:

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

Примечание

Changing this setting only affects newly changed translations. Existing checks will still be stored in the database. To also apply changes to the stored translations, run weblate updatechecks.

См.также

Проверки качества, Настройка поведения с помощью флагов

COMMENT_CLEANUP_DAYS#

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

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

COMMIT_PENDING_HOURS#

Количество часов до коммита ожидающих изменений фоновой задачей.

См.также

Настройки компонента, Возраст изменений для коммита, Выполнение задач технического обслуживания, weblate commit_pending

CONTACT_FORM#

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

Configures how e-mail from the contact form is being sent. Choose a configuration that matches the configuration of your mail server.

``»reply-to»``(ответить): Отправитель используется в качестве :mailheader:`Reply-To`(ответить), это поведение по умолчанию.
``»from»``(от): Отправитель используется в качестве :mailheader:`From`(от). Ваш почтовый сервер должен разрешать отправку таких писем.

DATA_DIR#

Каталог, в котором Weblate хранит все свои данные. Он содержит ссылки на репозитории систем контроля версий, индекс для полнотекстового поиска и различные файлы настроек для внешних инструментов.

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

home

Домашний каталог, используемый при вызове скриптов.

ssh

Ключи и конфигурация SSH.

static

Расположение статических файлов Django по умолчанию, определяемых переменной STATIC_ROOT. Смотреть раздел Обслуживание статических файлов.

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

media

Расположение медиа-файлов Django по умолчанию, определяемых переменной MEDIA_ROOT. Содержит загруженные снимки экрана, смотреть раздел Визуальный контекст для строк.

vcs

Version-control repositories for translations.

backups

Daily backup data. Please check Дампы данных для резервного копирования for details.

fonts:

Шрифты, загруженные пользователем, смотреть раздел Управление шрифтами.

cache

Various caches. Can be placed elsewhere using CACHE_DIR.

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

Примечание

Этот каталог должен быть доступен для записи Weblate. Запуск его как uWSGI означает, что пользователь www-data должен иметь к нему доступ с правами на запись.

Простейший способ этого достичь — сделать пользователя владельцем каталога:

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

По умолчанию /home/weblate/data, но ожидается, что это будет настроено.

См.также

Права доступа к файлам, Резервное копирование и перенос Weblate, CACHE_DIR

DATABASE_BACKUP#

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

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

"plain"
"compressed"
"none"

См.также

Резервное копирование и перенос Weblate

DEFAULT_ACCESS_CONTROL#

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

The default access-control setting for new projects:

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 add-ons to install for every created component.

Примечание

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

Пример:

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",
    },
}

См.также

weblate install_addon, Надстройки, WEBLATE_ADDONS

DEFAULT_COMMITER_EMAIL#

Committer e-mail address, defaulting to noreply@weblate.org.

См.также

DEFAULT_COMMITER_NAME

DEFAULT_COMMITER_NAME#

Committer name, defaulting to Weblate.

См.также

DEFAULT_COMMITER_EMAIL

DEFAULT_LANGUAGE#

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

Исходный язык for any new components.

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

См.также

Определение языков, Исходный язык

DEFAULT_MERGE_STYLE#

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

Стиль слияния for any new components.

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

См.также

Настройки компонента, Стиль слияния

DEFAULT_SHARED_TM#

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

Configures the default value of Использовать совместную память переводов and Вносить вклад в совместную память переводов.

DEFAULT_TRANSLATION_PROPAGATION#

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

См.также

Настройки компонента, Разрешить распространение перевода

DEFAULT_PULL_MESSAGE#

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

ENABLE_AVATARS#

Whether to turn on Gravatar-based avatars for users. On by default.

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

См.также

Кеширование аватаров, AVATAR_URL_PREFIX, Аватары

ENABLE_HOOKS#

Whether to turn on anonymous remote hooks.

См.также

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

ENABLE_HTTPS#

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

In the default configuration this is also used for several Django settings related to HTTPS — it enables secure cookies, toggles HSTS or enables redirection to a HTTPS URL.

The HTTPS redirection might be problematic in some cases and you might hit an issue with infinite redirection in case you are using a reverse proxy doing an SSL termination which does not correctly pass protocol headers to Django. Please tweak your reverse proxy configuration to emit X-Forwarded-Proto or Forwarded headers or configure SECURE_PROXY_SSL_HEADER to let Django correctly detect the SSL status.

См.также

SESSION_COOKIE_SECURE, CSRF_COOKIE_SECURE, SECURE_SSL_REDIRECT, SECURE_PROXY_SSL_HEADER Установка правильного домена сайта

EXTRA_HTML_HEAD#

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

Insert additional markup into the HTML header. Can be used for verification of site ownership, for example:

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

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

No sanitization is performed on the string. It is inserted as-is into the HTML header.

GET_HELP_URL#

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

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

GITEA_CREDENTIALS#

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

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

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

The configuration dictionary consists of credentials defined for each API host. The API host might be different from what you use in the web browser, for example GitHub API is accessed as api.github.com.

The following configuration is available for each host:

username: API user, required.
token: API token for the API user, required.
scheme: Добавлено в версии 4.18.

Scheme override. Weblate attempts to parse scheme from the repository URL and falls backs to https. If you are running the API server internally, you might want to use http instead, but consider security.

Подсказка

In the Docker container, the credentials are configured in three variables and the credentials are built out of that. An example configuration for GitHub might look like:

WEBLATE_GITHUB_USERNAME=api-user
WEBLATE_GITHUB_TOKEN=api-token
WEBLATE_GITHUB_HOST=api.github.com

Will be used as:

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

См.также

Запрос на извлечение в Gitea, Creating a Gitea personal access token

GITLAB_CREDENTIALS#

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

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

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

The following configuration is available for each host:

username: API user, required.
token: API token for the API user, required.
scheme: Добавлено в версии 4.18.

Scheme override. Weblate attempts to parse scheme from the repository URL and falls backs to https. If you are running the API server internally, you might want to use http instead, but consider security.

Подсказка

In the Docker container, the credentials are configured in three variables and the credentials are built out of that. An example configuration for GitHub might look like:

WEBLATE_GITHUB_USERNAME=api-user
WEBLATE_GITHUB_TOKEN=api-token
WEBLATE_GITHUB_HOST=api.github.com

Will be used as:

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

См.также

Запросы на слияние в GitLab, GitLab: Personal access token

GITHUB_CREDENTIALS#

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

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

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

The following configuration is available for each host:

username: API user, required.
token: API token for the API user, required.
scheme: Добавлено в версии 4.18.

Scheme override. Weblate attempts to parse scheme from the repository URL and falls backs to https. If you are running the API server internally, you might want to use http instead, but consider security.

Подсказка

In the Docker container, the credentials are configured in three variables and the credentials are built out of that. An example configuration for GitHub might look like:

WEBLATE_GITHUB_USERNAME=api-user
WEBLATE_GITHUB_TOKEN=api-token
WEBLATE_GITHUB_HOST=api.github.com

Will be used as:

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

См.также

Запрос на извлечение в GitHub, Creating a GitHub personal access token

BITBUCKETSERVER_CREDENTIALS#

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

List for credentials for Bitbucket servers.

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

The following configuration is available for each host:

username: API user, required.
token: API token for the API user, required.
scheme: Добавлено в версии 4.18.

Scheme override. Weblate attempts to parse scheme from the repository URL and falls backs to https. If you are running the API server internally, you might want to use http instead, but consider security.

Подсказка

In the Docker container, the credentials are configured in three variables and the credentials are built out of that. An example configuration for GitHub might look like:

WEBLATE_GITHUB_USERNAME=api-user
WEBLATE_GITHUB_TOKEN=api-token
WEBLATE_GITHUB_HOST=api.github.com

Will be used as:

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

См.также

Bitbucket Server pull requests, Bitbucket: HTTP access token

GOOGLE_ANALYTICS_ID#

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

HIDE_REPO_CREDENTIALS#

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

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

Примечание

On by default.

HIDE_VERSION#

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

Hides version info from unauthenticated users. This also makes all documentation links point to the latest version instead of the documentation matching the currently installed version.

Hiding the version is a recommended security practice in some corporations, does not prevent an attacker from figuring out version by probing behavior.

Примечание

По умолчанию этот параметр выключен.

INTERLEDGER_PAYMENT_POINTERS#

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

Список указателей платежей Interledger (ILP) для веб-монетизации.

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

Пожалуйста, посетите <https://webmonetization.org/> для получения подробной информации.

Подсказка

Значение по умолчанию позволяет пользователям финансировать Weblate.

IP_BEHIND_REVERSE_PROXY#

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

Если установлен в ``True`, то Weblate получает IP адрес из заголовка, определённого параметром IP_PROXY_HEADER.

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

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

Примечание

По умолчанию этот параметр не включён.

См.также

Работа за обратным прокси, Ограничение частоты запросов, IP_PROXY_HEADER, IP_PROXY_OFFSET

IP_PROXY_HEADER#

Указывает, из какого заголовка Weblate должен получить IP-адрес при включении параметра IP_BEHIND_REVERSE_PROXY.

По умолчанию установлен в HTTP_X_FORWARDED_FOR.

См.также

Работа за обратным прокси, Ограничение частоты запросов, SECURE_PROXY_SSL_HEADER, IP_BEHIND_REVERSE_PROXY, IP_PROXY_OFFSET

IP_PROXY_OFFSET#

Указывает, какая часть параметра IP_PROXY_HEADER используется в качестве IP-адреса клиента.

В зависимости от вашей установки, этот заголовок может состоять из нескольких IP адресов (например, X-Forwarded-For: a, b, client-ip), и здесь вы можете настроить, какой адрес из заголовка используется в качестве IP адреса клиента.

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

Setting this affects the security of your installation. You should only configure it to use trusted proxies for determining the IP address.

По умолчанию установлен в 0.

См.также

Работа за обратным прокси, Ограничение частоты запросов, SECURE_PROXY_SSL_HEADER, IP_BEHIND_REVERSE_PROXY, IP_PROXY_HEADER

LEGAL_TOS_DATE#

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

Примечание

You need Правовые вопросы installed to make this work.

Date of last update of terms of service documents. Whenever the date changes, users are required to agree with the updated terms of service.

from datetime import date

LEGAL_TOS_DATE = date(2022, 2, 2)

LEGAL_URL#

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

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

Подсказка

Useful if you host your legal documents outside Weblate for embedding them inside Weblate. Please check Правовые вопросы for details.

Пример:

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

См.также

PRIVACY_URL

LICENSE_EXTRA#

Дополнительные лицензии для включения в список вариантов лицензий.

Примечание

Описание каждой лицензии должно быть кортежем, состоящим из её краткого наименования, длинного наименования и URL-адреса.

Например:

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

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#

Эти параметры конфигурируют надстройку CDN локализации JavaScript. Параметр LOCALIZE_CDN_URL определяет корневой URL-адрес, по которому доступен CDN локализации, а параметр LOCALIZE_CDN_PATH определяет путь, по которому Weblate должен сохранять сгенерированные файлы, которые затем будут раздаваться с LOCALIZE_CDN_URL.

Подсказка

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

См.также

CDN локализации JavaScript

LOGIN_REQUIRED_URLS#

Список URL-адресов, для посещения которых требуется выполнить вход. (Помимо встроенных в Weblate стандартных правил).

Подсказка

Он позволяет вам защитить паролем всю установку:

LOGIN_REQUIRED_URLS = (r"/(.*)$",)
REST_FRAMEWORK["DEFAULT_PERMISSION_CLASSES"] = [
    "rest_framework.permissions.IsAuthenticated"
]

Подсказка

Также желательно заблокировать доступ к API, как показано в примере выше.

См.также

REQUIRE_LOGIN

LOGIN_REQUIRED_URLS_EXCEPTIONS#

List of exceptions for LOGIN_REQUIRED_URLS. If not specified, users are allowed to access the sign-in page.

Некоторые исключения, которые вы, возможно, захотите включить:

LOGIN_REQUIRED_URLS_EXCEPTIONS = (
    r"/accounts/(.*)$",  # Required for sign-in
    r"/static/(.*)$",  # Required for development mode
    r"/widgets/(.*)$",  # Allowing public access to widgets
    r"/data/(.*)$",  # Allowing public access to data exports
    r"/hooks/(.*)$",  # Allowing public access to notification hooks
    r"/api/(.*)$",  # Allowing access to API
    r"/js/i18n/$",  # JavaScript localization
)

MATOMO_SITE_ID#

ID of the site in Matomo (formerly Piwik) you want to use for tracking 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",
    },
}

The following configuration is available for each host:

username: API user, required.
token: API token for the API user, required.
scheme: Добавлено в версии 4.18.

Scheme override. Weblate attempts to parse scheme from the repository URL and falls backs to https. If you are running the API server internally, you might want to use http instead, but consider security.

Подсказка

In the Docker container, the credentials are configured in three variables and the credentials are built out of that. An example configuration for GitHub might look like:

WEBLATE_GITHUB_USERNAME=api-user
WEBLATE_GITHUB_TOKEN=api-token
WEBLATE_GITHUB_HOST=api.github.com

Will be used as:

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

См.также

Запросы на слияние в Pagure, Pagure API

PRIVACY_URL#

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

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

Подсказка

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

Пример:

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

См.также

LEGAL_URL

PRIVATE_COMMIT_EMAIL_OPT_IN#

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

Configures whether the private commit e-mail is opt-in or opt-out (by default it is opt-in).

См.также

Профиль, PRIVATE_COMMIT_EMAIL_TEMPLATE

PRIVATE_COMMIT_EMAIL_TEMPLATE#

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

Template to generate private commit e-mail for an user. Defaults to "{username}@users.noreply.{site_domain}".

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

Примечание

Using different commit e-mail is opt-in for users unless configured by PRIVATE_COMMIT_EMAIL_OPT_IN. Users can configure commit e-mail in the Профиль.

PROJECT_BACKUP_KEEP_COUNT#

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

Defines how many backups per project are kept on the server. Defaults to 3.

См.также

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

PROJECT_BACKUP_KEEP_DAYS#

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

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

См.также

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

PROJECT_NAME_RESTRICT_RE#

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

Defines a regular expression to restrict project naming. Any matching names will be rejected.

См.также

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

PROJECT_WEB_RESTRICT_HOST#

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

Reject using certain hosts in project website. Any subdomain is matched, so including example.com will block test.example.com as well. The list should contain lower case strings only, the parsed domain is lower cased before matching.

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

PROJECT_WEB_RESTRICT_HOST = {"localhost"}

См.также

Веб-сайт проекта PROJECT_WEB_RESTRICT_NUMERIC, PROJECT_WEB_RESTRICT_RE,

PROJECT_WEB_RESTRICT_NUMERIC#

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

Reject using numeric IP address in project website. On by default.

См.также

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

PROJECT_WEB_RESTRICT_RE#

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

Defines a regular expression to restrict project websites. Any matching URLs will be rejected.

См.также

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

RATELIMIT_ATTEMPTS#

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

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

По умолчанию установлен в 5.

См.также

Ограничение частоты запросов, RATELIMIT_WINDOW, RATELIMIT_LOCKOUT

RATELIMIT_WINDOW#

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

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

An amount of seconds, defaulting to 300 (5 minutes).

См.также

Ограничение частоты запросов, RATELIMIT_ATTEMPTS, RATELIMIT_LOCKOUT

RATELIMIT_LOCKOUT#

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

Как долго аутентификация будет заблокирована после применения ограничения частоты запросов.

Количество секунд, по умолчанию равен 600 (10 минут).

См.также

Ограничение частоты запросов, RATELIMIT_ATTEMPTS, RATELIMIT_WINDOW

REGISTRATION_ALLOW_BACKENDS#

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

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

It is recommended to keep REGISTRATION_OPEN on while limiting registration backends, otherwise users will be able to register, but Weblate will not show links to register in the user interface.

Пример:

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

Подсказка

The backend names match names used in the URL for authentication.

См.также

REGISTRATION_OPEN, Аутентификация

REGISTRATION_CAPTCHA#

Whether registration of new accounts is protected by a CAPTCHA. Defaults to enabled.

Если он включён, ко всем страницам, на которых пользователь вводит свой адрес электронной почты, добавляется капча:

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

REGISTRATION_EMAIL_MATCH#

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

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

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

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

REGISTRATION_OPEN#

Whether registration of new accounts is currently permitted. Defaults to enabled.

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

Примечание

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

См.также

REGISTRATION_ALLOW_BACKENDS, REGISTRATION_EMAIL_MATCH, Аутентификация

REGISTRATION_REBIND#

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

Allow rebinding authentication backends for existing users. Turn this on when migrating between authentication providers.

Примечание

Off by default to not allow adding other authentication backends to an existing account. Rebinding can lead to account compromise when using more third-party authentication backends.

REPOSITORY_ALERT_THRESHOLD#

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

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

См.также

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

REQUIRE_LOGIN#

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

Этот параметр включает LOGIN_REQUIRED_URLS и настраивает его так, что будет запрашиваться авторизация пользователя для всех API-вызовов REST.

Примечание

Этот параметр реализован в примере файла настроек. В Docker’е используйте переменную. WEBLATE_REQUIRE_LOGIN.

SENTRY_DSN#

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

DSN Sentry для сбора отчетов об ошибках.

См.также

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

SIMPLIFY_LANGUAGES#

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

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

SITE_DOMAIN#

Configures site domain. Necessary to produce correct absolute links in many scopes (for example activation e-mails, notifications or RSS feeds).

If Weblate is running on a non-standard port, include it here as well.

Примеры:

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

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

Примечание

This setting should only contain the domain name. For configuring protocol, (turning on and enforcing HTTPS) use ENABLE_HTTPS and for changing the URL, use URL_PREFIX.

Подсказка

В контейнере Docker домен сайта настраивается через переменную окружения WEBLATE_ALLOWED_HOSTS.

См.также

Установка правильного домена сайта, Настройка разрешенных хостов, Правильная настройка HTTPS WEBLATE_SITE_DOMAIN, ENABLE_HTTPS

SITE_TITLE#

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

SPECIAL_CHARS#

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

Значение по умолчанию:

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

SINGLE_PROJECT#

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

Redirects users directly to a project or component instead of showing the dashboard. You can either set it to True so it only works if there is actually only single project in Weblate. Alternatively, set the project slug, and it will redirect unconditionally to this project.

Изменено в версии 3.11: Теперь параметр также принимает плашку проекта для принудительного отображения этого единственного проекта.

Пример:

SINGLE_PROJECT = "test"

SSH_EXTRA_ARGS#

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

Allows adding custom parameters when Weblate is invoking SSH. Useful when connecting to servers using legacy encryption or other non-standard features.

For example when SSH connection in Weblate fails with Unable to negotiate with legacyhost: no matching key exchange method found. Their offer: diffie-hellman-group1-sha1, you can turn that on using:

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

Подсказка

The string is evaluated by the shell, so ensure any whitespace and special characters is quoted.

См.также

Наследственные параметры OpenSSH

STATUS_URL#

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

SUGGESTION_CLEANUP_DAYS#

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

Автоматическое удаление предложения через заданное количество дней. По умолчанию установлен в ``None`, что означает отсутствие удалений.

UNUSED_ALERT_DAYS#

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

Configures when the Component seems unused alert is triggered.

Defaults to 365 days, set to 0 to turn it off.

UPDATE_LANGUAGES#

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

Controls whether languages database should be updated when running database migration and is on by default. This setting has no effect on invocation of weblate setuplang.

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

The languages display might become inconsistent with this. Weblate language definitions expand over time and it will not display language code for the defined languages.

См.также

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

URL_PREFIX#

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

Примечание

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

Подсказка

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

Пример:

URL_PREFIX = "/translations"

Примечание

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

VCS_API_DELAY#

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

Configures minimal delay in seconds between third-party API calls in Запрос на извлечение в GitHub, Запросы на слияние в GitLab, Запрос на извлечение в Gitea, and Запросы на слияние в Pagure.

This rate-limits API calls from Weblate to these services to avoid overloading them.

If you are being limited by secondary rate-limiter at GitHub, increasing this might help.

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

VCS_BACKENDS#

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

Примечание

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

Подсказка

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

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

См.также

Интеграция с системой контроля версий

VCS_CLONE_DEPTH#

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

Настраивает, насколько глубоким должно быть клонирование репозиториев сервисом 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.GettextCustomizeAddon",
    "weblate.addons.gettext.GettextAuthorComments",
    "weblate.addons.cleanup.CleanupAddon",
    "weblate.addons.consistency.LangaugeConsistencyAddon",
    "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.json.JSONCustomizeAddon",
    "weblate.addons.xml.XMLCustomizeAddon",
    "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.yaml.YAMLCustomizeAddon",
    "weblate.addons.cdn.CDNJSAddon",
    # Add-on you want to include
    "weblate.addons.example.ExampleAddon",
)

Примечание

Removing the add-on from the list does not uninstall it from the components. Weblate will crash in that case. Please uninstall the add-on from all components prior to removing it from this list.

См.также

Надстройки, DEFAULT_ADDONS

WEBLATE_EXPORTERS#

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

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

См.также

Поддерживаемые форматы файлов

WEBLATE_FORMATS#

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

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

Примечание

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

См.также

Поддерживаемые форматы файлов

WEBLATE_MACHINERY#

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

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

См.также

Настройка автоматических предложений

WEBLATE_GPG_IDENTITY#

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

Удостоверение, используемое Weblate для подписи коммитов Git, например:

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

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

См.также

Подписание коммитов Git с помощью GnuPG

WEBSITE_REQUIRED#

Defines whether Веб-сайт проекта has to be specified when creating a project. On by default, as that suits public server setups.

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

AKISMET_API_KEY#

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#

CHECK_LIST#

COMMENT_CLEANUP_DAYS#

COMMIT_PENDING_HOURS#

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

GOOGLE_ANALYTICS_ID#

HIDE_REPO_CREDENTIALS#

HIDE_VERSION#

INTERLEDGER_PAYMENT_POINTERS#

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#

LOGIN_REQUIRED_URLS#

LOGIN_REQUIRED_URLS_EXCEPTIONS#

MATOMO_SITE_ID#

MATOMO_URL#

NEARBY_MESSAGES#

DEFAULT_PAGE_LIMIT#

PAGURE_CREDENTIALS#

PRIVACY_URL#

PRIVATE_COMMIT_EMAIL_OPT_IN#

PRIVATE_COMMIT_EMAIL_TEMPLATE#

PROJECT_BACKUP_KEEP_COUNT#

PROJECT_BACKUP_KEEP_DAYS#

PROJECT_NAME_RESTRICT_RE#

PROJECT_WEB_RESTRICT_HOST#

PROJECT_WEB_RESTRICT_NUMERIC#

PROJECT_WEB_RESTRICT_RE#

RATELIMIT_ATTEMPTS#

RATELIMIT_WINDOW#

RATELIMIT_LOCKOUT#

REGISTRATION_ALLOW_BACKENDS#

REGISTRATION_CAPTCHA#

REGISTRATION_EMAIL_MATCH#

REGISTRATION_OPEN#