Конфигурация¶
Все настройки хранятся в файле settings.py
(как обычно для проектов Django).
Примечание
После изменения любого из этих параметров вам необходимо перезапустить Weblate — как процесс WSGI, так и процесс Celery.
В случае, если Weblate работает через mod_wsgi, для перезагрузки конфигурации вам нужно перезапустить Apache.
См.также
Также, пожалуйста, ознакомьтесь с документацией Django по настройке параметров самого Django.
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.
Сколько дней должно быть разрешено использовать один и тот же пароль.
Примечание
Смена паролей, сделанная в версиях 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',
)
BASE_DIR¶
Базовый каталог, в котором находятся исходники Weblate’а. Используется для построения нескольких других умолчательных путей:
Значение по умолчанию: каталог верхнего уровня исходников Weblate’а.
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
.
См.также
COMMENT_CLEANUP_DAYS¶
Добавлено в версии 3.6.
Удаление комментариев через заданное количество дней. По умолчанию None
, что означает, что комментарии не удаляются.
COMMIT_PENDING_HOURS¶
Добавлено в версии 2.10.
Количество часов до коммита ожидающих изменений фоновой задачей.
DATA_DIR¶
Каталог, в котором Weblate хранит все свои данные. Он содержит ссылки на репозитории систем контроля версий, индекс для полнотекстового поиска и различные конфигурационные файлы для внешних инструментов.
Обычно существуют следующие подкаталоги:
home
Домашний каталог, используемый при вызове скриптов.
ssh
Ключи и конфигурация SSH.
static
Умолчательное расположение статических файлов Django, определяемых переменной
STATIC_ROOT
.media
Умолчательное расположение медиа-файлов Django, определяемых переменной
MEDIA_ROOT
.vcs
Репозитории систем контроля версий.
backups
Данные ежедневных резервных копий, для получения подробной информации обратитесь к разделу Дампы данных для резервного копирования.
Примечание
Этот каталог должен быть доступен Weblate’у для записи. Запуск его в качестве приложения uWSGI означает, что пользователь www-data
должен иметь к нему доступ с правами на запись.
Простейший способ этого достичь — сделать пользователя владельцем каталога:
sudo chown www-data:www-data -R $DATA_DIR
По умолчанию установлен в $BASE_DIR/data
.
DATABASE_BACKUP¶
Добавлено в версии 3.1.
Должны ли резервные копии базы данных храниться в виде простого текста, сжатого файла или не храниться вовсе. Допустимые значения:
"plain"
"compressed"
"none"
DEFAULT_ACCESS_CONTROL¶
Добавлено в версии 3.3.
Умолчательное значение параметра управления доступом для новых проектов:
0
Публичный
1
Защищённый
100
Частный
200
Настраиваемый
Используйте Настраиваемый, если списками контроля доступа вы управляете вручную, что означает, что вы не полагаетесь на внутреннее Weblate’овское управление ими.
DEFAULT_RESTRICTED_COMPONENT¶
Добавлено в версии 4.1.
Значение по умолчанию для ограничения компонента.
DEFAULT_ADD_MESSAGE, DEFAULT_ADDON_MESSAGE, DEFAULT_COMMIT_MESSAGE, DEFAULT_DELETE_MESSAGE, DEFAULT_MERGE_MESSAGE¶
Умолчательные сообщения коммита для различных операций, для получения подробной информации обратитесь к разделу Конфигурация компонента.
DEFAULT_ADDONS¶
Умолчательные надстройки, устанавливаемые в каждый созданный компонент.
Примечание
Этот параметр влияет только на новые создаваемые компоненты.
Пример:
DEFAULT_ADDONS = {
# Addon with no parameters
"weblate.flags.target_edit": {},
# Addon 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_MERGE_STYLE¶
Добавлено в версии 3.4.
Стиль слияния для любых новых компонентов.
rebase — по умолчанию
merge
См.также
DEFAULT_TRANSLATION_PROPAGATION¶
Добавлено в версии 2.5.
Значение по умолчанию для настройки распространения перевода, по умолчанию установлен в True
.
DEFAULT_PULL_MESSAGE¶
Заголовок для новых запросов на извлечение, по умолчанию равен 'Update from Weblate'
.
ENABLE_AVATARS¶
Включить ли для пользователей Gravatar-аватары. По умолчанию они включены.
Аватары извлекаются и кэшируются на сервере, что снижает риск утечки персональной информации и ускоряет взаимодействие с пользователем.
См.также
ENABLE_HTTPS¶
Отправлять ли ссылки на Weblate по протоколу HTTPS или HTTP. Этот параметр влияет на отправленные сообщения электронной почты и сгенерированные абсолютные URL-адреса.
Подсказка
В конфигурации по умолчанию он также используется для нескольких связанных с HTTPS параметров Django.
ENABLE_SHARING¶
Включает/выключает меню Поделиться, с помощью которого пользователи могут делиться прогрессом перевода в социальных сетях.
GITLAB_CREDENTIALS¶
Добавлено в версии 4.3.
Список учётных данных для серверов GitLab’а.
Подсказка
Используйте его в случае, если вы хотите, чтобы для одной конечной точки GitLab’а, определяемой параметрами GITLAB_USERNAME
и GITLAB_TOKEN
, Weblate взаимодействовал с несколькими серверами.
GITLAB_CREDENTIALS = {
"gitlab.com": {
"username": "weblate",
"token": "your-api-token",
},
"gitlab.example.com": {
"username": "weblate",
"token": "another-api-token",
},
}
GITLAB_USERNAME¶
Имя пользователя GitLab, используемое для отправки запросов на слияние для обновления перевода.
См.также
GITLAB_TOKEN¶
Добавлено в версии 4.3.
GitLab’овский персональный токен доступа, используемый для вызовов API, необходимых для обновления перевода.
GITHUB_CREDENTIALS¶
Добавлено в версии 4.3.
Список учётных данных для серверов GitHub’а.
Подсказка
Используйте его в случае, если вы хотите, чтобы для одной конечной точки GitHub’а, определяемой параметрами GITHUB_USERNAME
и GITHUB_TOKEN
, Weblate взаимодействовал с несколькими серверами.
GITHUB_CREDENTIALS = {
"api.github.com": {
"username": "weblate",
"token": "your-api-token",
},
"github.example.com": {
"username": "weblate",
"token": "another-api-token",
},
}
GITHUB_USERNAME¶
Имя пользователя GitHub, используемое для отправки запросов на извлечение для обновления перевода.
См.также
GITHUB_TOKEN¶
Добавлено в версии 4.3.
GitHub’овский персональный токен доступа, используемый для вызовов API, необходимых для отправки запросов на извлечение для обновления перевода.
GOOGLE_ANALYTICS_ID¶
Идентификатор аналитики Google для включения мониторинга 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.
Hides version information from unauthenticated users. This also makes all documentation links point to latest version instead of the documentation matching currently installed version.
Hiding version is recommended security practice in some corporations, but it doesn’t prevent attacker to figure out version by probing the behavior.
Примечание
This is turned off by default.
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_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: Setting this to blank value now disables license alert.
Filter list of licenses to show. This also disables the license alert when set to empty.
Примечание
Этот фильтр использует краткие наименования лицензий.
Например:
LICENSE_FILTER = {"AGPL-3.0", "GPL-3.0-or-later"}
Following disables the license alert:
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 (помимо встроенных в 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 login
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/"
См.также
MT_SERVICES¶
Изменено в версии 3.0: Параметр был переименован с MACHINE_TRANSLATION_SERVICES
на MT_SERVICES` для соответствия названиям других параметров машинного перевода.
Список включённых сервисов машинного перевода.
Примечание
Многим сервисам нужна дополнительная настройка, например, задание ключей API, для получения более подробной информации обратитесь к их документации в разделе Машинный перевод.
MT_SERVICES = (
'weblate.machinery.apertium.ApertiumAPYTranslation',
'weblate.machinery.deepl.DeepLTranslation',
'weblate.machinery.glosbe.GlosbeTranslation',
'weblate.machinery.google.GoogleTranslation',
'weblate.machinery.microsoft.MicrosoftCognitiveTranslation',
'weblate.machinery.microsoftterminology.MicrosoftTerminologyService',
'weblate.machinery.mymemory.MyMemoryTranslation',
'weblate.machinery.tmserver.AmagamaTranslation',
'weblate.machinery.tmserver.TMServerTranslation',
'weblate.machinery.yandex.YandexTranslation',
'weblate.machinery.weblatetm.WeblateTranslation',
'weblate.machinery.saptranslationhub.SAPTranslationHub',
'weblate.memory.machine.WeblateMemory',
)
См.также
MT_APERTIUM_APY¶
URL-адрес сервера Apertium-APy, https://wiki.apertium.org/wiki/Apertium-apy
См.также
MT_BAIDU_ID¶
Идентификатор клиента для API Baidu Zhiyun, вы можете зарегистрироваться по адресу https://api.fanyi.baidu.com/api/trans/product/index
MT_BAIDU_SECRET¶
Секрет клиента для API Baidu Zhiyun, вы можете зарегистрироваться по адресу https://api.fanyi.baidu.com/api/trans/product/index
MT_DEEPL_API_VERSION¶
Добавлено в версии 4.1.1.
Версия API, используемая для сервиса DeepL. Версия ограничивает область использования:
- v1
Предназначена для CAT-инструментов и может быть использована с пользовательской подпиской.
- v2
Предназначена для использования через API, а подписка основана на использовании.
Ранее Weblate классифицировался DeepL как CAT-инструмент, поэтому предполагалось использовать API версии v1, но теперь предполагается использовать API версии v2. Поэтому по умолчанию параметр имеет значение v2, но вы можете изменить его на v1 в случае, если у вас есть существующая CAT-подписка и вы хотите, чтобы Weblate использовал её.
См.также
MT_DEEPL_KEY¶
Ключ API для API DeepL, вы можете зарегистрироваться по адресу https://www.deepl.com/pro.html
См.также
MT_GOOGLE_KEY¶
Ключ API для API переводчика Google версии v2, вы можете зарегистрироваться по адресу https://cloud.google.com/translate/docs
MT_GOOGLE_CREDENTIALS¶
JSON-файл учётных данных API версии v3, полученный в консоли облака Google. Пожалуйста, укажите полный путь в формате пути операционной системы. Учётные данные привязаны к сервису-учётной записи, связанной с определённым проектом. Для получения более подробной информации обратитесь по адресу https://cloud.google.com/docs/authentication/getting-started.
MT_GOOGLE_PROJECT¶
Идентификатор проекта API версии v3 облака Google с активированным тарифным планом и сервисом перевода. Для получения более подробной информации обратитесь по адресу https://cloud.google.com/appengine/docs/standard/nodejs/building-app/creating-project
MT_GOOGLE_LOCATION¶
API версии v3 App Engine облака Google может зависеть от местоположения. Измените его соответствующим образом, если значение по умолчанию global
для вас не подходит.
Для получения более подробной информации обратитесь по адресу https://cloud.google.com/appengine/docs/locations
MT_MICROSOFT_BASE_URL¶
Базовый URL-адрес региона, как определено в разделе «Базовые URL-адреса».
По умолчанию равен api.cognitive.microsofttranslator.com
для Azure Global.
Для Azure China используйте, пожалуйста, api.translator.azure.cn
.
MT_MICROSOFT_COGNITIVE_KEY¶
Клиентский ключ для API переводчика Microsoft Cognitive Services.
MT_MICROSOFT_REGION¶
Префикс региона, как определено в разделе «Проверка подлинности с помощью ресурса с несколькими службами».
MT_MICROSOFT_ENDPOINT_URL¶
Конечная точка URL-адреса региона, как определено в разделе «Проверка подлинности с помощью маркера доступа».
По умолчанию равен api.cognitive.microsoft.com
для Azure Global.
Для Azure China используйте, пожалуйста, свою конечную точку на портале Azure Portal.
MT_MODERNMT_URL¶
URL-адрес ModernMT. По умолчанию для облачного сервиса используется https://api.modernmt.com/
.
См.также
MT_MYMEMORY_EMAIL¶
Идентификационный адрес электронной почты MyMemory. Разрешает выполнять 1000 запросов в день.
MT_MYMEMORY_KEY¶
Ключ доступа MyMemory для частной памяти переводов, используйте его совместно с параметром MT_MYMEMORY_USER
.
MT_MYMEMORY_USER¶
Идентификатор пользователя MyMemory для частной памяти переводов, используйте его совместно с параметром MT_MYMEMORY_KEY
.
MT_NETEASE_KEY¶
Ключ приложения для API NetEase Sight, вы можете зарегистрироваться по адресу https://sight.netease.com/
MT_NETEASE_SECRET¶
Секрет приложения для API NetEase Sight, вы можете зарегистрироваться по адресу https://sight.netease.com/
MT_TMSERVER¶
URL-адрес, по которому запущен tmserver.
См.также
tmserver, Машинный перевод, Автоматические предложения, tmserver
MT_YANDEX_KEY¶
Ключ API для API Яндекс.Переводчика, вы можете зарегистрироваться по адресу https://yandex.ru/dev/translate/
MT_YOUDAO_ID¶
Идентификатор клиента для API Youdao Zhiyun, вы можете зарегистрироваться по адресу https://ai.youdao.com/product-fanyi-text.s.
MT_YOUDAO_SECRET¶
Секрет клиента для API Youdao Zhiyun, вы можете зарегистрироваться по адресу https://ai.youdao.com/product-fanyi-text.s.
MT_SAP_BASE_URL¶
URL-адрес API сервиса SAP Translation Hub.
MT_SAP_SANDBOX_APIKEY¶
Ключ API для использования API песочницы
MT_SAP_USERNAME¶
Ваше имя пользователя SAP
MT_SAP_PASSWORD¶
Ваш пароль SAP
MT_SAP_USE_MT¶
Использовать ли также сервисы машинного перевода в дополнение к терминологической базе данных. Возможные значения: True
или False
NEARBY_MESSAGES¶
Сколько показывать строк около переводимой в настоящее время строки. Это просто значение по умолчанию, пользователи могут настроить его в своём профиле.
RATELIMIT_ATTEMPTS¶
Добавлено в версии 3.2.
Максимальное количество попыток аутентификации до применения ограничения частоты запросов.
По умолчанию установлен в 5.
RATELIMIT_WINDOW¶
Добавлено в версии 3.2.
Как долго будет приниматься аутентификация после применения ограничения частоты запросов.
Количество секунд, по умолчанию равен 300 (5 минут).
RATELIMIT_LOCKOUT¶
Добавлено в версии 3.2.
Как долго аутентификация будет заблокирована после применения ограничения частоты запросов.
Количество секунд, по умолчанию равен 600 (10 минут).
REGISTRATION_ALLOW_BACKENDS¶
Добавлено в версии 4.1.
List of authentication backends to allow registration from. This only limits new registrations, users can still authenticate and add authentication using all configured authentication backends.
It is recommended to keep REGISTRATION_OPEN
enabled 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"]
Подсказка
Имена бэкэндов совпадают с именами, используемыми в 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.
This enables LOGIN_REQUIRED_URLS
and configures REST framework to
require login for all API endpoints.
Примечание
This is in implemented in the Пример конфигурации. For Docker, use
WEBLATE_REQUIRE_LOGIN
.
SESSION_COOKIE_AGE_AUTHENTICATED¶
Добавлено в версии 4.3.
Set session expiry for authenticated users. This complements
SESSION_COOKIE_AGE
which is used for unauthenticated users.
См.также
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', '…')
SINGLE_PROJECT¶
Добавлено в версии 3.8.
Перенаправляет пользователей непосредственно в проект или компонент вместо отображения панели управления. Вы можете установить параметр в True
, в этом случае он будет работать только в том случае, если в Weblate’е и в самом деле есть только один проект. Или же можно задать плашку проекта, тогда пользователь будет безоговорочно перенаправлен в этот проект.
Изменено в версии 3.11: Теперь параметр также принимает плашку проекта для принудительного отображения этого единственного проекта.
Пример:
SINGLE_PROJECT = "test"
STATUS_URL¶
URL-адрес, по которому ваш экземпляр Weblate сообщает о своем статусе.
SUGGESTION_CLEANUP_DAYS¶
Добавлено в версии 3.2.1.
Автоматическое удаление предложения через заданное количество дней. По умолчанию установлен в ``None`, что означает отсутствие удалений.
URL_PREFIX¶
Этот параметр позволяет вам запускать Weblate по какому-либо пути (в противном случае он считает, что запущен из корня веб-сервера).
Примечание
Для использования этого параметра вам также нужно настроить ваш сервер на срезание этого префикса. Например, при использовании WSGI это можно сделать, установив псевдоним WSGIScriptAlias
.
Подсказка
Префикс должен начинаться с символа /
.
Пример:
URL_PREFIX = '/translations'
Примечание
Этот параметр не работает со встроенным сервером Django, чтобы он реагировал на этот префикс, вам придётся подправить urls.py
.
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 addons
"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.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",
# Addon you want to include
"weblate.addons.example.ExampleAddon",
)
См.также
WEBLATE_EXPORTERS¶
Добавлено в версии 4.2.
Список доступных экспортеров, предлагающих скачивание переводов или глоссариев в различных форматах файлов.
См.также
WEBLATE_FORMATS¶
Добавлено в версии 3.0.
Список доступных для использования форматов файлов.
Примечание
В списке по умолчанию уже есть распространённые форматы.
См.также
WEBLATE_GPG_IDENTITY¶
Добавлено в версии 3.1.
Идентификатор, используемый Weblate’ом для подписывания коммитов Git, например:
WEBLATE_GPG_IDENTITY = 'Weblate <weblate@example.com>'
В GPG’шной связке ключей Weblate ищет соответствующий ключ (файл home/.gnupg
в каталоге DATA_DIR
). Если ключ не найден, он генерируется, подробнее смотрите в разделе Подписание коммитов Git с помощью GnuPG.