Конфигурация
Все настройки хранятся в файле settings.py
(как обычно для проектов Django).
Примечание
После изменения любого из этих параметров вам необходимо перезапустить Weblate — как процесс WSGI, так и процесс Celery.
В случае, если Weblate работает через mod_wsgi
, для перезагрузки конфигурации вам нужно перезапустить Apache.
См.также
Также, пожалуйста, ознакомьтесь с документацией Django по настройке параметров самого Django.
ANONYMOUS_USER_NAME
Имена пользователей, которые не входят в систему.
См.также
AUDITLOG_EXPIRY
Добавлено в версии 3.6.
Сколько дней Weblate должен хранить журналы аудита, в которых содержится информация о деятельности учётной записи.
По умолчанию установлен в 180 дней.
AUTH_LOCK_ATTEMPTS
Добавлено в версии 2.14.
Максимальное количество неудачных попыток аутентификации до применения ограничения частоты запросов.
В настоящее время оно применяется в следующих местах:
Страница входа. Удаляет пароль учётной записи, не позволяя пользователю войти в систему без запроса нового пароля.
Страница сброса пароля. Предотвращает отправку новых писем, избегая рассылки спама пользователям со слишком большим количеством попыток сброса пароля.
По умолчанию установлен в 10.
См.также
AUTO_UPDATE
Добавлено в версии 3.2.
Изменено в версии 3.11: Первоначальные возможные значения параметра включено/выключено были изменены для дифференциации принимаемых строк.
Обновление всех репозиториев на ежедневной основе.
Подсказка
Полезно, если вы не используете обработчики для автоматического обновления репозиториев 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
Добавлено в версии 2.14.
Сколько времени действует токен аутентификации и временный пароль из писем сброса пароля. Устанавливается в количество секунд, по умолчанию равен 172800 (2 дня).
AUTH_PASSWORD_DAYS
Добавлено в версии 2.15.
How many days will Weblate reject reusing previously used password for an 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
Список автоматических исправлений, применяемых при сохранении строки.
Примечание
Предоставьте полный путь к классу Python, реализующему интерфейс автоматического исправления.
Доступные исправления:
weblate.trans.autofixes.whitespace.SameBookendingWhitespace
Выравнивает количество начальных и конечных пробельных символов в переводе с исходной строкой.
weblate.trans.autofixes.chars.ReplaceTrailingDotsWithEllipsis
Заменяет конечные точки (…) на многоточие (…), если оно есть в исходной строке.
weblate.trans.autofixes.chars.RemoveZeroSpace
Удаляет пробельные символы нулевой ширины, если исходная строка их не содержит.
weblate.trans.autofixes.chars.RemoveControlChars
Удаляет управляющие символы, если исходная строка их не содержит.
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.
Список языков, который будет предлагаться пользователям при создании нового перевода. Если не задан, то будет использоваться встроенный список, который включает все распространённые языки, но без добавления вариантов для конкретных стран.
Это не даёт непривилегированным пользователям добавлять нежелательные языки. Это не влияет на администраторов проектов — они всё также могут выбирать из полного списка языков, доступных в Weblate.
Примечание
Это также не определяет новые языки в Weblate, а только фильтрует те, что уже присутствуют в базе данных.
Пример:
BASIC_LANGUAGES = {"cs", "it", "ja", "en"}
См.также
BORG_EXTRA_ARGS
Добавлено в версии 4.9.
Вы можете передать дополнительные аргументы в команде borg create, когда запускается встроенное резервное копирование.
Пример:
BORG_EXTRA_ARGS = ["--exclude", "vcs/"]
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, реализующему интерфейс проверки.
Подправьте список проверок так, чтобы включить в него только нужные вам.
По умолчанию включены все встроенные проверки, оттуда вы можете изменить эти настройки. В примере файла настроек они по умолчанию закомментированы, так что используются значения по умолчанию. В каждой новой версии Weblate туда добавляются новые проверки, если таковые появляются.
Вы можете отключить все проверки:
CHECK_LIST = ()
Можете включить только некоторые:
CHECK_LIST = (
"weblate.checks.chars.BeginNewlineCheck",
"weblate.checks.chars.EndNewlineCheck",
"weblate.checks.chars.MaxLengthCheck",
)
Примечание
Изменение этого параметра влияет только на недавно изменённые переводы, результаты существующих проверок будут по-прежнему сохранены в базе данных. Чтобы также применить изменения к сохранённым переводам, запустите команду updatechecks
.
COMMIT_PENDING_HOURS
Добавлено в версии 2.10.
Количество часов до коммита ожидающих изменений фоновой задачей.
CONTACT_FORM
Добавлено в версии 4.6.
Настраивает способ отправки электронной почты из контактной формы. Выберите конфигурацию, соответствующую конфигурации вашего почтового сервера.
DATA_DIR
Каталог, в котором Weblate хранит все свои данные. Он содержит ссылки на репозитории систем контроля версий, индекс для полнотекстового поиска и различные файлы настроек для внешних инструментов.
Обычно существуют следующие подкаталоги:
home
Домашний каталог, используемый при вызове скриптов.
ssh
Ключи и конфигурация SSH.
static
Расположение статических файлов Django по умолчанию, определяемых переменной
STATIC_ROOT
. Смотреть раздел Обслуживание статических файлов.Docker-контейнер использует для этого отдельный том, смотреть раздел Тома контейнеров Docker’а.
media
Расположение медиа-файлов Django по умолчанию, определяемых переменной
MEDIA_ROOT
. Содержит загруженные снимки экрана, смотреть раздел Визуальный контекст для строк.vcs
Репозитории систем контроля версий для переводов.
backups
Данные ежедневных резервных копий, для получения подробной информации обратитесь к разделу Дампы данных для резервного копирования.
celery
Данные планировщика Celery, смотрите раздел Фоновые задачи с использованием Celery.
fonts
:Шрифты, загруженные пользователем, смотреть раздел Управление шрифтами.
Примечание
Этот каталог должен быть доступен для записи 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.
Умолчательное значение параметра управления доступом для новых проектов:
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
Добавлено в версии 2.4.
Адрес электронной почты коммиттера, по умолчанию равен noreply@weblate.org
.
См.также
DEFAULT_COMMITER_NAME
Добавлено в версии 2.4.
Имя коммиттера, по умолчанию равен Weblate
.
См.также
DEFAULT_LANGUAGE
Добавлено в версии 4.3.2.
Язык по умолчанию, который будет использоваться, например как исходный язык.
По умолчанию — en. Соответствующая запись для данного языка должна присутствовать в базе данных.
См.также
DEFAULT_MERGE_STYLE
Добавлено в версии 3.4.
Стиль слияния для любых новых компонентов.
rebase — по умолчанию
merge
См.также
DEFAULT_TRANSLATION_PROPAGATION
Добавлено в версии 2.5.
Значение по умолчанию для настройки распространения перевода, по умолчанию установлен в True
.
DEFAULT_PULL_MESSAGE
Настраивает заголовок и сообщение по умолчанию для запросов на извлечение.
ENABLE_AVATARS
Включить ли для пользователей Gravatar-аватары. По умолчанию они включены.
Аватары извлекаются и кэшируются на сервере, что снижает риск утечки персональной информации и ускоряет взаимодействие с пользователем.
См.также
ENABLE_HOOKS
Включить ли анонимные удалённые обработчики.
См.также
ENABLE_HTTPS
Отправлять ли ссылки на Weblate по протоколу HTTPS или HTTP. Этот параметр влияет на отправленные сообщения электронной почты и сгенерированные абсолютные URL-адреса.
В конфигурации по умолчанию он также используется для нескольких связанных с HTTPS параметров Django — он включает безопасные куки, переключает HSTS или включает перенаправление на HTTPS-адрес.
С перенаправлением HTTPS иногда могут возникать проблемы: если вы используете обратный прокси, который выполняет терминацию SSL, вследствие чего заголовки протокола не передаются Django в корректном виде, то вы можете столкнуться с бесконечным перенаправлением. В таком случае исправьте настройки своего обратного прокси, дабы он добавлял заголовки X-Forwarded-Proto
или Forwarded
, или настройте SECURE_PROXY_SSL_HEADER
, чтобы Django мог корректно определять статус SSL.
ENABLE_SHARING
Включает/выключает меню Поделиться, с помощью которого пользователи могут делиться прогрессом перевода в социальных сетях.
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",
},
"gitea.example.com": {
"username": "weblate",
"token": "another-api-token",
},
}
GITEA_USERNAME
Не рекомендуется, начиная с версии 4.14.2: Эта конфигурация небезопасна. Рекомендуется использовать GITEA_CREDENTIALS
.
Добавлено в версии 4.12.
Имя пользователя Gitea, используемое для отправки запросов на извлечение для обновления перевода.
GITEA_TOKEN
Не рекомендуется, начиная с версии 4.14.2: Эта конфигурация небезопасна. Рекомендуется использовать GITEA_CREDENTIALS
.
Добавлено в версии 4.12.
Личный токен доступа Gitea, используемый для вызовов API, необходимых для отправки запросов на извлечение для обновления перевода.
См.также
GITHEA_CREDENTIALS
, Запрос на извлечение в Gitea, Создание персонального токена доступа Gitea
GITLAB_CREDENTIALS
Добавлено в версии 4.3.
Список учётных данных для серверов GitLab.
GITLAB_CREDENTIALS = {
"gitlab.com": {
"username": "weblate",
"token": "your-api-token",
},
"gitlab.example.com": {
"username": "weblate",
"token": "another-api-token",
},
}
GITLAB_USERNAME
Не рекомендуется, начиная с версии 4.14.2: Эта конфигурация небезопасна, рекомендуется использовать GITLAB_CREDENTIALS
.
Имя пользователя GitLab, используемое для отправки запросов на слияние для обновления перевода.
GITLAB_TOKEN
Не рекомендуется, начиная с версии 4.14.2: Эта конфигурация небезопасна, рекомендуется использовать GITLAB_CREDENTIALS
.
Добавлено в версии 4.3.
Личный токен доступа GitLab, используемый для вызовов API, необходимых для отправки запросов на извлечение для обновления перевода.
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",
},
}
GITHUB_USERNAME
Не рекомендуется, начиная с версии 4.14.2: Эта конфигурация небезопасна, рекомендуется использовать GITHUB_CREDENTIALS
.
Имя пользователя GitHub, используемое для отправки запросов на извлечение для обновления перевода.
GITHUB_TOKEN
Не рекомендуется, начиная с версии 4.14.2: Эта конфигурация небезопасна, рекомендуется использовать GITHUB_CREDENTIALS
.
Добавлено в версии 4.3.
Персональный токен доступа GitHub, используемый для вызовов API, необходимых для отправки запросов на извлечение для обновления перевода.
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
. Аналогичным образом он пытается очистить и сообщения об ошибках системы контроля версий.
Примечание
По умолчанию этот параметр включён.
HIDE_VERSION
Добавлено в версии 4.3.1.
Прячет информацию о версии от неаутентифицированных пользователей. Это также перенаправляет все ссылки на документацию последней версии вместо той, которая на самом деле установлена.
Скрытие версии — рекомендованная мера безопасности в некоторых корпорациях, хотя это и не предотвращает того, что атакующий сможет выяснить версию зондируя поведение системы.
Примечание
По умолчанию этот параметр выключен.
INTERLEDGER_PAYMENT_POINTERS
Добавлено в версии 4.12.1.
Список указателей платежей Interledger (ILP) для веб-монетизации.
Если их указано несколько, распределение доходов достигается путем случайного выбора одного из них.
Пожалуйста, посетите <https://webmonetization.org/> для получения подробной информации.
Подсказка
Значение по умолчанию позволяет пользователям финансировать Weblate.
IP_BEHIND_REVERSE_PROXY
Добавлено в версии 2.14.
Указывает, работает ли Weblate за обратным прокси.
Если установлен в ``True`, то Weblate получает IP адрес из заголовка, определённого параметром IP_PROXY_HEADER
.
Предупреждение
Убедитесь, что вы и в самом деле используете обратный прокси и что он устанавливает этот заголовок, иначе пользователи смогут подделать IP адрес.
Примечание
По умолчанию этот параметр не включён.
IP_PROXY_HEADER
Добавлено в версии 2.14.
Указывает, из какого заголовка Weblate должен получить IP-адрес при включении параметра IP_BEHIND_REVERSE_PROXY
.
По умолчанию установлен в HTTP_X_FORWARDED_FOR
.
IP_PROXY_OFFSET
Добавлено в версии 2.14.
Указывает, какая часть параметра IP_PROXY_HEADER
используется в качестве IP-адреса клиента.
В зависимости от вашей установки, этот заголовок может состоять из нескольких IP адресов (например, X-Forwarded-For: a, b, client-ip
), и здесь вы можете настроить, какой адрес из заголовка используется в качестве IP адреса клиента.
Предупреждение
Задание этого параметра влияет на безопасность вашей установки, вы должны настроить его на использование только доверенных прокси для определения IP адреса.
По умолчанию установлен в 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 terms of service.
from datetime import date
LEGAL_TOS_DATE = date(2022, 2, 2)
LEGAL_URL
Добавлено в версии 3.5.
URL-адрес, по которому ваш экземпляр Weblate показывает свои юридические документы.
Подсказка
Полезно, если вы размещаете свои юридические документы за пределами Weblate, для их встраивания в Weblate обратитесь к разделу Правовые вопросы.
Пример:
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
Список исключений для LOGIN_REQUIRED_URLS
. Если не указан, пользователям будет разрешён доступ к странице входа.
Некоторые исключения, которые вы, возможно, захотите включить:
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
Идентификатор сайта в Matomo (бывший Piwik), который вы хотите отслеживать.
Примечание
Эта интеграция не поддерживает 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",
},
}
PAGURE_USERNAME
Не рекомендуется, начиная с версии 4.14.2: Эта конфигурация небезопасна, рекомендуется использовать PAGURE_CREDENTIALS
.
Добавлено в версии 4.3.2.
Имя пользователя Pagure, используемое для отправки запросов на слияние для обновления перевода.
PAGURE_TOKEN
Не рекомендуется, начиная с версии 4.14.2: Эта конфигурация небезопасна, рекомендуется использовать PAGURE_CREDENTIALS
.
Добавлено в версии 4.3.2.
Личный токен доступа Pagure, используемый для вызовов API, необходимых для отправки запросов на извлечение для обновления перевода.
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-out).
См.также
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.
Определяет, сколько резервных копий на проект хранится на сервере. По умолчанию 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_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.
Как долго будет приниматься аутентификация после применения ограничения частоты запросов.
Количество секунд, по умолчанию равен 300 (5 минут).
RATELIMIT_LOCKOUT
Добавлено в версии 3.2.
Как долго аутентификация будет заблокирована после применения ограничения частоты запросов.
Количество секунд, по умолчанию равен 600 (10 минут).
REGISTRATION_ALLOW_BACKENDS
Добавлено в версии 4.1.
Список методов аутентификации (backends), с помощью которых доступна регистрация. Это вводит ограничения только на новые регистрации. Независимо от данного параметра пользователи смогут добавлять и использовать любые разрешённые в параметрах и настроенные методы аутентификации.
Рекомендуется держать параметр REGISTRATION_OPEN
включённым, но ограничить доступные методы регистрации, иначе пользователи смогут регистрироваться, но Weblate не будет показывать ссылки на регистрацию в пользовательском интерфейсе.
Пример:
REGISTRATION_ALLOW_BACKENDS = ["azuread-oauth2", "azuread-tenant-oauth2"]
Подсказка
Имена бэкэндов совпадают с именами, используемыми в URL-адресах для аутентификации.
См.также
REGISTRATION_CAPTCHA
Значение, которое может быть равно только True
или False
, указывает, защищена ли регистрация новых учётных записей капчей. Этот параметр является необязательным и если он не указан, будет принято значение по умолчанию True
.
Если он включён, ко всем страницам, на которых пользователь вводит свой адрес электронной почты, добавляется капча:
Регистрация новой учётной записи.
Восстановление пароля.
Добавление в учётную запись адреса электронной почты.
Контактная форма для пользователей, не вошедших в систему.
REGISTRATION_EMAIL_MATCH
Добавлено в версии 2.17.
Позволяет вам отфильтровать допустимые для регистрации адреса электронной почты.
По умолчанию равен .*
, что позволяет зарегистрироваться с любым адресом электронной почты.
Вы можете использовать этот параметр для ограничения регистрации одним доменом электронной почты:
REGISTRATION_EMAIL_MATCH = r"^.*@weblate\.org$"
REGISTRATION_OPEN
Разрешена ли в настоящее время регистрация новых учётных записей. Этот необязательный параметр может остаться в значении по умолчанию True
или быть изменённым на False
.
Этот параметр влияет на встроенную аутентификацию по адресу электронной почты или через Python Social Auth (при помощи параметра REGISTRATION_ALLOW_BACKENDS
вы можете занести определённые бэкэнды в белый список).
Примечание
При использовании сторонних методов аутентификации, вроде аутентификации через LDAP, этот параметр просто скрывает форму регистрации, но новые пользователи всё равно смогут входить в систему и создавать учётные записи.
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
Настраивает домен сайта. Это необходимо для получения корректных абсолютных ссылок во многих местах (например, в письмах активации, в уведомлениях или в 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
Добавлено в версии 3.8.
Перенаправляет пользователей непосредственно в проект или компонент вместо отображения панели управления. Вы можете установить значение True
, в этом случае он будет работать тогда, когда в Weblate и в самом деле есть только один проект. Или же можно задать плашку проекта, тогда пользователь будет безоговорочно перенаправлен в этот проект.
Изменено в версии 3.11: Теперь параметр также принимает плашку проекта для принудительного отображения этого единственного проекта.
Пример:
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"
Подсказка
Строка оценивается shell’ом, поэтому убедитесь, что все пробелы и специальные символы заключены в кавычки.
См.также
STATUS_URL
URL-адрес, по которому ваш экземпляр Weblate сообщает о своем статусе.
SUGGESTION_CLEANUP_DAYS
Добавлено в версии 3.2.1.
Автоматическое удаление предложения через заданное количество дней. По умолчанию установлен в ``None`, что означает отсутствие удалений.
UPDATE_LANGUAGES
Добавлено в версии 4.3.2.
Определяет, должна ли база данных языков обновляться во время общей миграции базы данных. По умолчанию включено. Этот параметр никак не влияет на выполнение setuplang
.
Предупреждение
The languages display might become inconsistent with this. Weblate language definitions extend 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.
The default value is 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",
)
Примечание
Удаление дополнения из этого списка не уберёт его из компонентов. В этом случае Weblate завершится крахом. Пожалуйста, уберите дополнение из всех компонентов прежде чем удалять его из данного списка.
См.также
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
Определяет, нужно ли указывать Веб-сайт проекта при создании проекта. По умолчанию включено, так как это подходит для публичных серверов.
COMMENT_CLEANUP_DAYS
Добавлено в версии 3.6.
Удаление комментариев через заданное количество дней. По умолчанию
None
, что означает, что комментарии не удаляются.