Налаштування#
Усі параметри зберігаються у файлі 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#
Префікс для побудови адрес аватарів: ${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.
Перевірку засновано на журналі ревізії, AUDITLOG_EXPIRY
має бути принаймні таким самим великим, як це значення.
Примітка
Зміни пароля, виконані до 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.
Визначає частоту, із якою запускатимуться тривалі завдання для складника.
У поточній версії керує такими елементами:
додатком Автоматичний переклад
повторною обробкою Перевірки і виправлення
Можливі варіанти значень:
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.
Каталог, у якому Weblate зберігає файли кешу. Типовим є підкаталог cache
у DATA_DIR
.
Змініть це на локальну або тимчасову файлову систему, якщо DATA_DIR
є каталогом мережевої файлової системи.
Контейнер 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.
"reply-to"
Запис відправника той самий, що і у Reply-To, це типова поведінка.
"from"
Запис відправника той самий, що і у From. На вашому поштовому сервері має бути дозволено надсилання таких повідомлень електронної пошти.
DATA_DIR#
Тека, у якій Weblate зберігає дані. Тека містить посилання на репозиторію системи керування версіями, повнотекстовий покажчик та різноманітні файли налаштувань для зовнішніх інструментів.
Зазвичай, існують такі підкаталоги:
home
Домашній каталог, який використовується для виклику скриптів.
ssh
Ключі і налаштування SSH.
static
Типове місце для статичних файлів Django, визначається на основі
STATIC_ROOT
. Див. Обслуговування статичних файлів.Контейнер Docker використовує для цього окремий том, див. Томи контейнера Docker.
media
Типове розташування мультимедійних файлів Django, визначається на основі
MEDIA_ROOT
. Містить вивантажені знімки вікон, див. Візуальний контекст для рядків.vcs
Version-control repositories for translations.
backups
Daily backup data. Please check Дампи даних для резервних копій for details.
fonts
:Вивантажені користувачем шрифти, див. Керування шрифтами.
cache
Various caches. Can be placed elsewhere using
CACHE_DIR
.Контейнер Docker використовує для цього окремий том, див. Томи контейнера Docker.
Примітка
Цей каталог має бути доступний до запису для Weblate. Якщо його запущено від імені uWSGI, користувач www-data
повинен мати доступ до запису до нього.
Найпростішим способом досягти результату є надання користувачеві прав власника каталогу:
sudo chown www-data:www-data -R $DATA_DIR
Типове значення — /home/weblate/data
, але варто налаштувати все відповідним чином.
DATABASE_BACKUP#
Нове в версії 3.1.
Чи мають резервні копії зберігатися у форматі звичайного тексту, стисненими чи пропущеними. Коректними значеннями є такі:
"plain"
"compressed"
"none"
Дивись також
DEFAULT_ACCESS_CONTROL#
Нове в версії 3.3.
The default access-control setting for new projects:
0
Відкритий
1
Захищений
100
Приватний
200
Нетиповий
Скористайтеся варіантом Нетиповий, якщо ви керуєте ACL вручну, тобто не покладаєтеся на внутрішні механізми керування 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. Цей параметр впливає на надіслані повідомлення електронної пошти і створення абсолютних адрес.
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.
Адреса, за якою можна отримати підтримку для вашого екземпляра 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",
},
}
Дивись також
Запити щодо об’єднання GitLab, GitLab: особистий жетон доступу
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.
Список реєстраційних даних для серверів Bitbucket.
BITBUCKETSERVER_CREDENTIALS = {
"git.self-hosted.com": {
"username": "weblate",
"token": "http-access-token",
},
}
GOOGLE_ANALYTICS_ID#
Ідентифікатор Google Analytics для вмикання спостереження за Weblate за допомогою Google Analytics.
HIDE_REPO_CREDENTIALS#
Приховати реєстраційні дані репозиторію від показу у вебінтерфейсі. Якщо у адресі репозиторію міститься ім’я користувача і пароль, Weblate приховає їх при показі відповідних даних користувачам.
Наприклад, замість https://користувач:пароль@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 Payment Pointers (ILPs) для вебмонетизації.
Якщо вказано декілька, ймовірнісний розподіл прибутку буде виконано випадковим вибором якогось.
Докладніші відомості можна знайти на <https://webmonetization.org/>.
Підказка
Типове значення уможливлює фінансову підтримку користувачами самого Weblate.
IP_BEHIND_REVERSE_PROXY#
Вказує, чи працює Weblate за реверсивним проксі-сервером.
Якщо встановлено значення True
, Weblate отримуватиме IP-адресу з заголовка, який визначено IP_PROXY_HEADER
.
Попередження
Переконайтеся, що зворотний проксі-сервер справді використовується, і що він встановлює цей заголовок, інакше користувачі зможуть підробляти IP-адресу.
Примітка
Типово не увімкнено.
IP_PROXY_HEADER#
Вказує, з якого заголовка Weblate має отримати адресу, коли увімкнено 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.
Примітка
Щоб мати змогу цим скористатися, вам слід встановити Правові відомості.
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.
Адреса, за якою екземпляр 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#
Додаткові ліцензії, які слід включити до варіантів ліцензування.
Примітка
Кожне визначення ліцензії має бути кортежем його короткої назви, довгої назви і адреси.
Приклад:
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
, щоб уможливити довші переклади (аж до 10000 символів), незалежно від довжини початкового рядка.
Примітка
Типове значення — True
.
LOCALIZE_CDN_URL і LOCALIZE_CDN_PATH#
Ці параметри призначено для налаштовування додатка CDN локалізації JavaScript. LOCALIZE_CDN_URL
визначає кореневу адресу, за якою доступний CDN локалізації, а LOCALIZE_CDN_PATH
визначає шлях, за яким Weblate має зберігати створені файли, які обслуговуватимуться за адресою LOCALIZE_CDN_URL
.
Підказка
На базовому Weblate використано https://weblate-cdn.com/
.
Дивись також
LOGIN_REQUIRED_URLS#
Список адрес, для яких обов’язковим буде реєстрація. (Окрім стандартних правил, які вбудовано до Weblate).
Підказка
За допомогою цього параметра ви можете захистити паролем увесь екземпляр за допомогою:
LOGIN_REQUIRED_URLS = (r"/(.*)$",)
REST_FRAMEWORK["DEFAULT_PERMISSION_CLASSES"] = [
"rest_framework.permissions.IsAuthenticated"
]
Підказка
Бажано заблокувати також і доступ до програмного інтерфейсу, як показано у наведеному вище прикладі.
Дивись також
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.
Дивись також
MATOMO_URL#
Повна адреса (разом із кінцевою похилою рискою) встановленого Matomo (раніше Piwik), яким ви хочете скористатися для стеження за використанням Weblate. Будь ласка, ознайомтеся із <https://matomo.org/>, щоб дізнатися більше.
Підказка
У цьому варіанті інтеграції не передбачено підтримки керування мітками Matomo.
Приклад:
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.
Адреса, за якою екземпляр Weblate показуватиме правила конфіденційності.
Підказка
Корисний, якщо ви зберігаєте ваші правові документи поза Weblate для вбудовування їх до Weblate. Докладніше про це у розділі Правові відомості.
Приклад:
PRIVACY_URL = "https://weblate.org/terms/"
Дивись також
PRIVATE_COMMIT_EMAIL_OPT_IN#
Нове в версії 4.15.
Налаштовує, чи є конфіденційність адреси електронної пошти при внеску такою, з якою погоджуються, чи такою, від якої відмовляються (типово, вважається, що з нею погоджуються).
Дивись також
PRIVATE_COMMIT_EMAIL_TEMPLATE#
Нове в версії 4.15.
Шаблон для створення конфіденційної адреси електронної пошти для користувача. Типовим є "{користувач}@users.noreply.{сайт_домен}"
.
Встановіть порожні рядок, щоб вимкнути.
Примітка
Використання іншої адреси електронної пошти для внесків є об’єктом погодження з боку користувача, якщо це не змінено за допомогою PRIVATE_COMMIT_EMAIL_OPT_IN
. Користувачі можуть налаштувати адресу електронної пошти для внесків у профілі.
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.
Визначає формальний вираз для обмеження назв проєктів. Усі назви, відповідність яких виразу буде встановлено, буде заборонено.
Дивись також
PROJECT_WEB_RESTRICT_HOST#
Нове в версії 4.16.2.
Заборонити використання певних хостів на сайті проєкту. Перевіряється будь-який піддомен, тому включення example.com
також заблокує test.example.com
. Список повинен містити тільки рядки в нижньому регістрі, аналіз домену перед зіставленням починається з нижнього регістру.
Типова конфігурація:
PROJECT_WEB_RESTRICT_HOST = {"localhost"}
Дивись також
Вебсайт проєкту
PROJECT_WEB_RESTRICT_NUMERIC
,
PROJECT_WEB_RESTRICT_RE
,
PROJECT_WEB_RESTRICT_NUMERIC#
Нове в версії 4.16.2.
Reject using numeric IP address in project website. On by default.
Дивись також
Вебсайт проєкту
PROJECT_WEB_RESTRICT_HOST
,
PROJECT_WEB_RESTRICT_RE
,
PROJECT_WEB_RESTRICT_RE#
Нове в версії 4.15.
Визначає формальний вираз для обмеження сайтів проєкту. Усі адреси, відповідність яких виразу буде встановлено, буде заборонено.
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.
Список модулів розпізнавання, з яких уможливлено реєстрацію. Обмежує лише нові реєстрації. Користувачі зможуть проходити розпізнавання та додавати розпізнавання за допомогою всіх налаштованих модулів розпізнавання.
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.
Якщо увімкнено, на усі сторінки, де користувачі вводять адреси електронної пошти, буде додано CAPTCHA:
Реєстрація нового облікового запису.
Відновлення пароля.
Додавання адреси електронної пошти до облікового запису.
Контактна форма для користувачів, які не увійшли до системи.
REGISTRATION_EMAIL_MATCH#
Надає вам змогу фільтрувати, які адреси електронної пошти можна реєструвати.
Типове значення — .*
, що надає змогу реєструвати будь-яку адресу електронної пошти.
Ви можете скористатися ним для обмеження реєстрації єдиним доменом електронної пошти:
REGISTRATION_EMAIL_MATCH = r"^.*@weblate\.org$"
REGISTRATION_OPEN#
Whether registration of new accounts is currently permitted. Defaults to enabled.
Цей параметр впливає на вбудовані засоби розпізнавання за адресою електронної пошти або Python Social Auth (ви можете додати певні модулі до «білого» списку за допомогою параметра REGISTRATION_ALLOW_BACKENDS
).
Примітка
Якщо використано сторонні способи розпізнавання, зокрема Розпізнавання за допомогою LDAP, це просто призводить до приховування реєстраційної форми, але нові користувачі попри це зможуть входити до системи і створювати облікові записи.
Дивись також
REGISTRATION_ALLOW_BACKENDS
,
REGISTRATION_EMAIL_MATCH
,
Розпізнавання
REGISTRATION_REBIND#
Нове в версії 4.16.
Уможливлює повторну прив’язку модулів розпізнавання для наявних користувачів. Увімкніть при перенесенні між різними надавачами засобів для розпізнавання.
Примітка
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
та налаштовує набір бібліотек REST вимагати розпізнавання для всіх кінцевих точок програмного інтерфейсу.
Примітка
Це реалізовано у Зразок налаштувань. Для Docker скористайтеся WEBLATE_REQUIRE_LOGIN
.
SENTRY_DSN#
Нове в версії 3.9.
Sentry DSN, яким слід скористатися для Збирання звітів щодо помилок.
Дивись також
SIMPLIFY_LANGUAGES#
Використовувати прості коди мов для типових комбінацій мова-країна. Наприклад, для перекладу fr_FR
буде використано код мови fr
. Зазвичай, така поведінка є бажаною, оскільки спрощує побудову списку мов для цих типових комбінацій.
Вимкніть, якщо вам потрібні різні переклади для кожного з варіантів.
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
.
Дивись також
faq-site, Налаштовування дозволених вузлів, Належне налаштовування HTTPS ENABLE_HTTPS
, changesite
, The “sites” framework
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#
Адреса, на яку екземпляр 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.
Налаштовує мінімальну затримку у секундах для викликів стороннього програмного інтерфейсу у Запити щодо злиття GitHub, Запити щодо об’єднання GitLab, Запити щодо злиття Gitea і Запити щодо об’єднання Pagure.
Це обмежує частоту викликів програмного інтерфейсу з Weblate до цих служб, щоб уникнути перевантаження.
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
, тобто не вилучати коментарі.