Конфигурация#
Все настройки хранятся в файле 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.
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/'
См.также
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/"]
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"]
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
.
COMMIT_PENDING_HOURS#
Количество часов до коммита ожидающих изменений фоновой задачей.
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.
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
, но ожидается, что это будет настроено.
DATABASE_BACKUP#
Добавлено в версии 3.1.
Должны ли резервные копии базы данных храниться в виде простого текста, сжатого файла или не храниться вовсе. Допустимые значения:
"plain"
"compressed"
"none"
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",
},
}
См.также
DEFAULT_COMMITER_EMAIL#
Committer e-mail address, defaulting to noreply@weblate.org
.
См.также
DEFAULT_COMMITER_NAME#
Committer name, defaulting to Weblate
.
См.также
DEFAULT_LANGUAGE#
Добавлено в версии 4.3.2.
Исходный язык for any new components.
По умолчанию — en. Соответствующая запись для данного языка должна присутствовать в базе данных.
См.также
DEFAULT_MERGE_STYLE#
Добавлено в версии 3.4.
Стиль слияния for any new components.
rebase — по умолчанию
merge
См.также
DEFAULT_TRANSLATION_PROPAGATION#
Значение по умолчанию для настройки распространения перевода, по умолчанию установлен в True
.
DEFAULT_PULL_MESSAGE#
Настраивает заголовок и сообщение по умолчанию для запросов на извлечение.
ENABLE_AVATARS#
Whether to turn on Gravatar-based avatars for users. On by default.
Аватары извлекаются и кэшируются на сервере, что снижает риск утечки персональной информации и ускоряет взаимодействие с пользователем.
См.также
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.
ENABLE_SHARING#
Включает/выключает меню Поделиться, с помощью которого пользователи могут делиться прогрессом перевода в социальных сетях.
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",
},
"gitea.example.com": {
"username": "weblate",
"token": "another-api-token",
},
}
GITLAB_CREDENTIALS#
Добавлено в версии 4.3.
Список учётных данных для серверов GitLab.
GITLAB_CREDENTIALS = {
"gitlab.com": {
"username": "weblate",
"token": "your-api-token",
},
"gitlab.example.com": {
"username": "weblate",
"token": "another-api-token",
},
}
GITHUB_CREDENTIALS#
Добавлено в версии 4.3.
Список учётных данных для серверов GitHub.
GITHUB_CREDENTIALS = {
"api.github.com": {
"username": "weblate",
"token": "your-api-token",
},
"github.example.com": {
"username": "weblate",
"token": "another-api-token",
},
}
BITBUCKETSERVER_CREDENTIALS#
Добавлено в версии 4.16.
List for credentials for Bitbucket servers.
BITBUCKETSERVER_CREDENTIALS = {
"git.self-hosted.com": {
"username": "weblate",
"token": "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#
Указывает, из какого заголовка Weblate должен получить IP-адрес при включении параметра IP_BEHIND_REVERSE_PROXY
.
По умолчанию установлен в HTTP_X_FORWARDED_FOR
.
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.
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/"
См.также
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/
.
См.также
LOGIN_REQUIRED_URLS#
Список URL-адресов, для посещения которых требуется выполнить вход. (Помимо встроенных в Weblate стандартных правил).
Подсказка
Он позволяет вам защитить паролем всю установку:
LOGIN_REQUIRED_URLS = (r"/(.*)$",)
REST_FRAMEWORK["DEFAULT_PERMISSION_CLASSES"] = [
"rest_framework.permissions.IsAuthenticated"
]
Подсказка
Также желательно заблокировать доступ к API, как показано в примере выше.
См.также
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#
Полный URL-адрес (включая завершающую косую черту) установки Matomo (бывшего Piwik), которую вы хотите использовать для отслеживания использования Weblate. Для получения более подробной информации обратитесь к <https://matomo.org/>.
Подсказка
Эта интеграция не поддерживает Matomo Tag Manager.
Например:
MATOMO_SITE_ID = 1
MATOMO_URL = "https://example.matomo.cloud/"
См.также
NEARBY_MESSAGES#
Сколько показывать строк около переводимой в настоящее время строки. Это просто значение по умолчанию, пользователи могут настроить его в своём профиле.
DEFAULT_PAGE_LIMIT#
Добавлено в версии 4.7.
Количество элементов по умолчанию, отображаемых при активной нумерации страниц .
PAGURE_CREDENTIALS#
Добавлено в версии 4.3.2.
Список учётных данных для серверов Pagure.
PAGURE_CREDENTIALS = {
"pagure.io": {
"username": "weblate",
"token": "your-api-token",
},
"pagure.example.com": {
"username": "weblate",
"token": "another-api-token",
},
}
См.также
PRIVACY_URL#
Добавлено в версии 4.8.1.
URL-адрес, по которому ваш экземпляр Weblate показывает свою политику конфиденциальности.
Подсказка
Полезно, если вы размещаете свои юридические документы за пределами Weblate, для их встраивания в Weblate обратитесь к разделу Правовые вопросы.
Пример:
PRIVACY_URL = "https://weblate.org/terms/"
См.также
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#
Добавлено в версии 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#
Добавлено в версии 4.16.2.
Reject using numeric IP address in project website. On by default.
PROJECT_WEB_RESTRICT_RE#
Добавлено в версии 4.15.
Defines a regular expression to restrict project websites. Any matching URLs will be rejected.
RATELIMIT_ATTEMPTS#
Добавлено в версии 3.2.
Максимальное количество попыток аутентификации до применения ограничения частоты запросов.
По умолчанию установлен в 5.
RATELIMIT_WINDOW#
Добавлено в версии 3.2.
Как долго будет приниматься аутентификация после применения ограничения частоты запросов.
An amount of seconds, defaulting to 300 (5 minutes).
RATELIMIT_LOCKOUT#
Добавлено в версии 3.2.
Как долго аутентификация будет заблокирована после применения ограничения частоты запросов.
Количество секунд, по умолчанию равен 600 (10 минут).
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_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_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 для сбора отчетов об ошибках.
См.также
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
.
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.
См.также
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.
См.также
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.
WEBSITE_REQUIRED#
Defines whether Веб-сайт проекта has to be specified when creating a project. On by default, as that suits public server setups.
COMMENT_CLEANUP_DAYS#
Добавлено в версии 3.6.
Удаление комментариев через заданное количество дней. По умолчанию
None
, что означает, что комментарии не удаляются.