Додатки¶

Доповнення надають способи налаштування та автоматизації робочого процесу перекладу. Адміністратори можуть додавати та керувати доповненнями з меню Operations ↓ Add-ons кожного відповідного проєкту перекладу або компонента. Доповнення також можна встановити на весь сайт у Інтерфейс керування.

Підказка

Ви також можете налаштувати додатки за допомогою настанов з розділів API, DEFAULT_ADDONS або install_addon.

Додатки, для яких увімкнено ручне запускання, можна запускати через панель керування додатками або за допомогою API. Результати записуються в журнал активності додатка.

Події, які запускають доповнення¶

Установка надбудови¶

Спрацьовує під час встановлення надбудови.

Оновлення компонентів¶

Спрацьовує щоразу, коли відбувається зміна компонента, наприклад:

Рядки змінюються в репозиторії.
Додається рядок.
Додано новий переклад.

Щодня¶

Запускається щодня, але доповнення зазвичай розподіляють щоденне навантаження між компонентами залежно від BACKGROUND_TASKS.

Зміна події¶

Запускається одразу після створення події зміни.

Ручний спусковий механізм¶

Запускається, коли додаток запускається вручну з панелі керування додатками або через API.

Репозиторій після додавання¶

Запускається одразу після додавання та фіксації нового перекладу.

Репозиторій після фіксації¶

Запускається відразу після внесення змін.

Репозиторій post-push¶

Спрацьовує відразу після того, як сховище надсилається вгору.

Стан сховища після видалення¶

Спрацьовує одразу після вилучення перекладу.

Постоновлення сховища¶

Запускається кожного разу, коли нові зміни витягуються з попереднього сховища.

Попередня фіксація сховища¶

Запускається безпосередньо перед фіксацією змін.

Попереднє натискання репозиторію¶

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

Попереднє оновлення сховища¶

Запускається безпосередньо перед спробою оновлення репозиторію.

Блок після збереження¶

Запускається одразу після збереження рядка.

Постсинхронізація блоку¶

Активується після синхронізації рядка з VCS.

Попереднє створення блоку¶

Запускається одразу після збереження новоствореного рядка.

Вбудовані додатки¶

Автоматичний переклад¶

Ідентифікатор додатка:

weblate.autotranslate.autotranslate

Налаштування:

mode

Режим автоматичного перекладу

Доступні варіанти:¶
`suggest`	Додати як пропозицію
`translate`	Додати як переклад
`fuzzy`	Додати як такі, що потребують редагування

q

Запит

Будь ласка, зауважте, що переклад усіх рядків призведе до відкидання усіх наявних перекладів.

auto_source

Джерело автоматизованих перекладів

Доступні варіанти:¶
`others`	Інші складники перекладу
`mt`	Машинний переклад

component

Складник

Введіть опис складника для використання як джерела, залиште порожнім, щоб використовувати всі складники в поточному проєкті.

engines

Рушії компʼютерного перекладу

threshold

Поріг оцінки

Перемикачі:

Установка надбудови, Оновлення компонентів, Щодня, Зміна події

Автоматично перекладає рядки за допомогою машинного перекладу або інших складників.

Дивись також

CDN локалізації JavaScript¶

Added in version 4.2.

Ідентифікатор додатка:

weblate.cdn.cdnjs

Налаштування:

`threshold`	Порогове значення перекладу	Відсоток перекладених рядків, який має бути присутнім для включення перекладу.
`css_selector`	Вибір CSS	Засіб вибору CSS для виявлення придатних до локалізації елементів.
`cookie_name`	Назва куки мови	Назва куки, яка зберігатиме налаштування мови.
`files`	Видобути рядки з файлів HTML	Список назв файлів у поточному сховищі або віддалених адрес, які слід обробити для отримання придатних до перекладу рядків.

Перемикачі:

Установка надбудови, Щодня, Репозиторій після фіксації, Стан сховища після видалення, Постоновлення сховища

Оприлюднює переклади у мережах надання даних для використання у локалізації JavaScript або HTML.

Можна скористатися для локалізації статичних сторінок HTML або завантаження локалізації у коді JavaScript.

Створює унікальну адресу для вашого складника, яку ви можете включати до сторінок HTML для їхньої локалізації. Див. Переклад HTML і JavaScript за допомогою CDN Weblate, щоб дізнатися більше.

Примітка

Для цього додатка потрібні додаткові налаштування на сервері Weblate. LOCALIZE_CDN_PATH налаштовує місце, куди буде записано створені файли (у файловій системі), а LOCALIZE_CDN_URL визначає, де їх буде оброблено (адресу). Обслуговування файлів відбувається не на самому Weblate — його слід налаштувати зовні (типово, за допомогою служби CDN).

Цей додаток налаштовано на Hosted Weblate, він обслуговує файли за допомогою https://weblate-cdn.com/.

Дивись також

CDN файлів перекладу¶

Added in version 2026.5.

Ідентифікатор додатка:: weblate.cdn.files
Налаштування:: Цей додаток не має налаштувань.
Перемикачі:: Установка надбудови, Оновлення компонентів, Репозиторій після фіксації, Стан сховища після видалення, Постоновлення сховища

Публікує файли перекладу в мережі доставки контенту.

Publishes translation files without converting them to another format. Files are written below the add-on specific CDN directory and served from LOCALIZE_CDN_URL/<add-on UUID>/. Single-file translations use the language code and original file extension, for example cs.json or de.po. Multi-file translations are served below the language code using paths relative to the translation directory. Monolingual components include the source language file, while bilingual components publish only target-language files. See CDN локалізації for secure serving guidance.

Вилучити порожні рядки¶

Added in version 4.4.

Ідентифікатор додатка:: weblate.cleanup.blank
Налаштування:: Цей додаток не має налаштувань.
Перемикачі:: Установка надбудови, Репозиторій після фіксації, Постоновлення сховища

Вилучає рядки без перекладу з файлів перекладу.

Використовуйте це, якщо не хочете, щоб порожні рядки з’являлись у файлах перекладу (наприклад, коли у бібліотеці локалізації їх показано як пропущені рядки, а не повернено до початкового рядка).

Дивись також

Чи оновлює Weblate файли перекладів між перекладами?

Очищення файлів перекладу¶

Ідентифікатор додатка:: weblate.cleanup.generic
Налаштування:: Цей додаток не має налаштувань.
Перемикачі:: Установка надбудови, Постоновлення сховища, Попередня фіксація сховища

Оновіть всі файли перекладу, щоб вони відповідали одномовному основному файлу. Для більшості форматів файлів це означає видалення застарілих перекладацьких ключів, які вже відсутні у основному файлі.

Для форматів, що містять додаткові дані, окрім рядків перекладу (зокрема Файли HTML, Файли RC Windows та Формат OpenDocument), також синхронізує файл перекладу із базовим файлом.

For a one-time cleanup of a single translation file, use Cleanup unused in Супровід репозиторія on that translation instead of installing the add-on.

Дивись також

Чи оновлює Weblate файли перекладів між перекладами?

Додавання нових мов¶

Ідентифікатор додатка:: weblate.consistency.languages
Налаштування:: Цей додаток не має налаштувань.
Перемикачі:: Установка надбудови, Щодня, Репозиторій після додавання

Забезпечує використання однорідного набору мов для всіх складників проєкту.

Примітка

Компоненти, спільно використані з інших проектів, тут не враховуються.

Пошук пропущених мов відбувається кожні 24 години і при додаванні нових мов у Weblate.

На відміну від інших, цей додаток стосується усього проєкту.

Підказка

Автоматичний переклад нових доданих рядків за допомогою Автоматичний переклад.

Виявлення складників¶

Ідентифікатор додатка:

weblate.discovery.discovery

Налаштування:

`match`	Регулярний вираз для зіставлення файлів перекладу	Регулярний вираз повинен містити іменовані групи для компонента та мови.
`file_format`	Формат файлу	Формат файлу
`name_template`	Налаштувати назву складника	Використовуйте синтаксис шаблонів Django. Цей шаблон повинен містити {{ component }}.
`base_file_template`	Визначити назву основного файлу для одномовного перекладу	Залиште порожнім для двомовних файлів перекладу. Якщо цей параметр встановлено, цей шаблон повинен містити {{ component }}.
`new_base_template`	Визначити основний файл для нового перекладу	Ім’я файлу, що використовується для створення нових перекладів. Для gettext слід вибрати файл .pot. Цей шаблон повинен містити {{ component }}.
`intermediate_template`	Проміжний мовний файл	Ім’я проміжного файлу перекладу. У більшості випадків це файл перекладу, наданий розробниками, який використовується під час створення власне вихідних рядків. Цей шаблон повинен містити {{ component }}.
`language_regex`	Фільтр мов	Формальний вираз для фільтрування файлів перекладу під час сканування за маскою файлів.
`copy_addons`	Клонувати додатки з основного складника до нових
`remove`	Видалити складники для файлів, яких не існує

Перемикачі:

Установка надбудови, Постоновлення сховища

Автоматично додає або вилучає складники до проєкту на основі змін файла у системі керування версіями.

Збіг визначається за допомогою регулярних виразів, що дозволяє здійснювати складну настройку, але для цього необхідні певні знання. Регулярний вираз для збігу з файлами перекладу повинен містити дві іменовані групи для збігу з компонентом та мовою. Усі іменовані групи в регулярному виразі можна використовувати як змінні в полях шаблону.

Вимоги щодо розкриття інформації¶

Щоб успішно виявити компонент, конфігурація повинна виконати всі наведені нижче дії:

Регулярний вираз повинен містити іменовані групи component та language.
Поля шаблону, що використовуються для іменування або визначення розташування файлів окремих компонентів, повинні містити {{ component }}, щоб відображуване значення фактично змінювалося для кожного виявленого компонента.
Для одномовних форматів компонент повинен містити файл, що відповідає параметру base_file_template, та принаймні один файл перекладу, що відповідає параметру match.

Приклад із розв’язанням: `news_<lang>.md`¶

Це типовий макет варіантів мови на основі імен файлів:

docs/news_en.md
docs/news_cs.md
docs/guide_en.md

Скористайтеся попередньою настройкою Варіанти мови за іменем файлу як відправною точкою, потім виберіть відповідний формат файлу та перегляньте заповнені значення.

Формальний вираз:

(?:(?P<path>.*/))?(?P<component>.+?)_(?P<language>[A-Za-z]{2,3}(?:[_-][A-Za-z0-9]+)*)\.(?P<extension>[^/.]+)

Назва складника:

{{ component }}

Виявлені маски файлів:

docs/news_*.md
docs/guide_*.md

У цьому прикладі {{ component }}»' розшифровується як базова назва без суфікса мови, тому файли docs/news_en.md, docs/news_pt_BR.md та docs/news_pt-BR.md стають компонентом news.

Ви можете використовувати розмітку шаблонів Django в усіх полях назви файла. Приклад:

{{ component }}: Назва компонента, вилучена з групи збігів component
{{ component|title }}: Назва файла складника з великою першою буквою
{{ path }}: {{ component }}: Нетипова група відповідності на основі формального виразу

Після натискання кнопки Зберегти буде показано попередній перегляд відповідних складників, за допомогою якого ви зможете перевірити, чи відповідають налаштування вашим потребам:

Приклади виявленння складників¶

Наведений вище приклад ілюструє найпоширеніший варіант структури, заснований на іменах файлів. У наступних прикладах показано інші структури репозиторіїв, які ви можете зіставити.

Одна тека на мову¶

Одна тека для мови, що містить файли перекладів для складників.

Формальний вираз:

(?P<language>[^/.]*)/(?P<component>[^/]*)\.po

Відповідні файли:

cs/application.po
cs/website.po
de/application.po
de/website.po

Компонування локалей Gettext¶

Звичайна структура для збереження файлів gettex PO.

Формальний вираз:

locale/(?P<language>[^/.]*)/LC_MESSAGES/(?P<component>[^/]*)\.po

Відповідні файли:

locale/cs/LC_MESSAGES/application.po
locale/cs/LC_MESSAGES/website.po
locale/de/LC_MESSAGES/application.po
locale/de/LC_MESSAGES/website.po

Складні назви файлів¶

Використання складників та назви мови в імені файлу.

Формальний вираз:

src/locale/(?P<component>[^/]*)\.(?P<language>[^/.]*)\.po

Відповідні файли:

src/locale/application.cs.po
src/locale/website.cs.po
src/locale/application.de.po
src/locale/website.de.po

Повторюваний код мови¶

Використанні мови у шляху та назві файлу.

Формальний вираз:

locale/(?P<language>[^/.]*)/(?P<component>[^/]*)/(?P=language)\.po

Відповідні файли:

locale/cs/application/cs.po
locale/cs/website/cs.po
locale/de/application/de.po
locale/de/website/de.po

Розділені рядки Android¶

Рядки ресурсів Android, розбиті на декілька файлів.

Формальний вираз:

res/values-(?P<language>[^/.]*)/strings-(?P<component>[^/]*)\.xml

Відповідні файли:

res/values-cs/strings-about.xml
res/values-cs/strings-help.xml
res/values-de/strings-about.xml
res/values-de/strings-help.xml

Відповідність декільком шляхам¶

Багатомодульний проєкт Maven зі перекладами властивостей Java.

Формальний вираз:

(?P<originalHierarchy>.+/)(?P<component>[^/]*)/src/main/resources/ApplicationResources_(?P<language>[^/.]*)\.properties

Назва складника:

{{ originalHierarchy }}: {{ component }}

Відповідні файли:

parent/module1/submodule/src/main/resources/ApplicationResources_fr.properties
parent/module1/submodule/src/main/resources/ApplicationResource_es.properties
parent/module2/src/main/resources/ApplicationResource_de.properties
parent/module2/src/main/resources/ApplicationResource_ro.properties

Підказка

Додаток для виявлення компонентів використовує Внутрішні адреси Weblate. Це зручний спосіб спільного використання налаштувань VCS між кількома компонентами. Пов’язані компоненти використовують локальний репозиторій основного компонента, налаштованого шляхом заповнення weblate://project/main-component у полі Сховище з джерелами (у Operations ↓ Settings ↓ Version control system) кожного відповідного компонента. Це також економить час на налаштування та системні ресурси.

Підказка

Переконайтеся, що новий компонент містить повний набір мов, які можна перекладати, за допомогою Додавання нових мов.

Дивись також

Повідомлення Fedora¶

Added in version 5.15.

Ідентифікатор додатка:

weblate.fedora_messaging.publish

Налаштування:

`amqp_url`	Адреса обробника AMQP	Адреса обробника AMQP для встановлення з’єднання.
`topic_prefix`	Префікс теми	Необов’язковий префікс для дописування перед створеними записами тем повідомлень.
`publish_timeout`	Перевищення часу очікування на оприлюднення	Кількість секунд очікування на сповіщення щодо доставлення від обробника.
`connection_attempts`	Спроби з’єднання	Кількість спроб встановити з’єднання з обробником.
`retry_delay`	Затримка повторних спроб	Кількість секунд очікування між спробами встановлення з’єднання.
`ca_cert`	Комплект сертифіката CA (PEM)	Вставити лише блоки сертифіката PEM, кожен починатиметься з «—–BEGIN CERTIFICATE—–» і завершуватиметься «—–END CERTIFICATE—–».
`client_key`	Клієнтський закритий ключ (PEM)	Вставити єдиний нешифрований блок закритого ключа PEM. Підтримки шифрованих закритих ключів не передбачено.
`client_cert`	Клієнтський сертифікат (PEM)	Вставити лише блок сертифіката PEM, що починається з «—–BEGIN CERTIFICATE—–»; не вставляти дані, виведені «openssl x509 -text».
`event_filter`	Події зміни для вмикання	Choose which change events should trigger this add-on. Події зміни для вмикання
`events`	Вибрані події зміни	Вибрані події зміни

Перемикачі:

Зміна події

Надсилає сповіщення на обмін AMQP, сумісний з Fedora Messaging.

Fedora Messaging — заснований на AMQP засіб публікації усіх змін, які відбуваються у Weblate. За її допомогою ви можете будувати додаткові служби на основі змін, які відбуваються у Weblate.

Тема повідомлення¶

All messages have topic weblate.<action>.<project>.<category...>.<component>.<translation>. When configured, topic_prefix is prepended to this topic using a single dot separator, for example org.fedoraproject.weblate.project_backed_up.website. The action is lowercase textual representation of action with underscores instead of space, for example resource_updated; see Вибрані події зміни for all action identifiers. The remaining parts match Weblate object path segments.

For example, a project backup event for the website project uses weblate.project_backed_up.website. A translation change in the website project, frontend component, and Czech translation uses weblate.translation_changed.website.frontend.cs. The same change in the frontend component inside the parent and child categories uses weblate.translation_changed.website.parent.child.frontend.cs.

Текст повідомлення¶

Тіло складається з наступних полів (за умови, що вони доступні для події):

change_id: Числовий ідентифікатор зміни
action: Детальна назва зміни.
timestamp: Часова позначка у форматі ISO
target: Нове значення зміни (тобто новий переклад рядка)
old: Старе значення зміни (тобто попередній переклад рядка)
source: Вихідний рядок.
url: Абсолютна адреса для перегляду пов’язаного об’єкта.
author: Ім’я користувача автора (може відрізнятися від користувача, наприклад, при затвердженні пропозицій)
user: Ім’я користувача, яким внесено зміну
project: Ідентифікатор проєкту
component: Ідентифікатор складника
translation: Код мови перекладу

Заголовки повідомлень¶

Існують додаткові заголовки, які ви також можете використовувати для маршрутизації:

action: Детальна назва зміни.
project: Ідентифікатор проєкту
component: Ідентифікатор складника

Приклади повідомлень¶

Подія злиття репозиторію:

{
  "id": 1,
  "action": "Merged repository",
  "timestamp": "2017-06-15T11:30:47.325000+00:00",
  "url": "http://example.com/projects/test/test/",
  "component": "test"
}

Нова подія вихідного рядка:

{
  "id": 2,
  "action": "New source string",
  "timestamp": "2017-06-15T11:30:47.372000+00:00",
  "url": "http://example.com/translate/test/test/cs/?checksum=6412684aaf018e8e",
  "component": "test",
  "translation": "cs",
  "source": ["Hello, world!\n"]
}

Подія оновлення ресурсу:

{
  "id": 6,
  "action": "Resource update",
  "timestamp": "2017-06-15T11:30:47.410000+00:00",
  "url": "http://example.com/projects/test/test/cs/",
  "project": "test",
  "component": "test",
  "translation": "cs"
}
{
  "id": 7,
  "action": "Resource update",
  "timestamp": "2017-06-15T11:30:47.510000+00:00",
  "url": "http://example.com/projects/test/test/de/",
  "project": "test",
  "component": "test",
  "translation": "de"
}
{
  "id": 8,
  "action": "Resource update",
  "timestamp": "2017-06-15T11:30:47.595000+00:00",
  "url": "http://example.com/projects/test/test/it/",
  "project": "test",
  "component": "test",
  "translation": "it"
}

Подія вилучення проекту:

{
  "id": 9,
  "action": "Removed project",
  "timestamp": "2019-10-17T15:57:08.559420+00:00",
  "target": "test",
  "user": "testuser"
}

Подія для нових учасників:

{
  "id": 11,
  "action": "New contributor",
  "timestamp": "2019-10-17T15:57:08.759960+00:00",
  "url": "http://example.com/translate/test/test/cs/?checksum=6412684aaf018e8e",
  "author": "testuser",
  "user": "testuser",
  "project": "test",
  "component": "test",
  "translation": "cs",
  "source": ["Hello, world!\n"]
}

Нова подія перекладу:

{
  "id": 12,
  "action": "New translation",
  "timestamp": "2019-10-17T15:57:08.772591+00:00",
  "url": "http://example.com/translate/test/test/cs/?checksum=6412684aaf018e8e",
  "target": ["Ahoj svete!\n"],
  "author": "testuser",
  "user": "testuser",
  "project": "test",
  "component": "test",
  "translation": "cs",
  "source": ["Hello, world!\n"]
}

Дивись також

Масове редагування¶

Ідентифікатор додатка:

weblate.flags.bulk

Налаштування:

q

Запит

state

Стан для встановлення

Доступні варіанти:¶
`-1`	Не змінювати
`10`	Потребує редагування
`11`	Потребує редагування (Потребує переписання)
`12`	Потребує редагування (Потребує перевірки)
`20`	Перекладено
`30`	Схвалено

add_flags

Додати наступні прапорці перекладу

remove_flags

Вилучити наступні прапорці перекладу

add_labels

Мітки для додавання

remove_labels

Мітки для видалення

Перемикачі:

Установка надбудови, Оновлення компонентів

Надає можливість пакетного редагування прапорців, міток або стану рядків.

Приклади:

Автоматичне встановлення міток нових рядків¶
Запит щодо пошуку	`NOT has:label`
Мітки для додавання	recent

Позначення всіх рядків журналу змін Файли метаданих крамниці програм придатними лише для читання¶
Запит щодо пошуку	`language:en AND key:changelogs/`
Додати наступні прапорці перекладу	`read-only`

Позначення певних рядків придатними лише для читання¶
Запит щодо пошуку	source:r"^\`\`[.a-zA-Z0-9_-]*\`\`$" AND language:en
Додати наступні прапорці перекладу	`read-only`

Дивись також

Позначити незмінені переклади як «Потребує переробки»¶

Ідентифікатор додатка:: weblate.flags.same_edit
Налаштування:: Цей додаток не має налаштувань.
Перемикачі:: Попереднє створення блоку

Кожного разу, коли з VCS імпортується новий рядок, що підлягає перекладу, і він збігається з вихідним рядком, він позначається як такий, що потребує переписання у Weblate. Це особливо корисно для форматів файлів, що містять вихідні рядки для неперекладених рядків.

Підказка

Можливо, ви також захочете зробити строгішою перевірку Переклад не змінено, додавши до Прапорці перекладу прапорець strict-same.

Дивись також

Стани перекладу

Позначте нові рядки джерела як «Потребує перевірки»¶

Ідентифікатор додатка:: weblate.flags.source_edit
Налаштування:: Цей додаток не має налаштувань.
Перемикачі:: Попереднє створення блоку

Кожного разу, коли з VCS імпортується новий вихідний рядок, він позначається як такий, що потребує перевірки у Weblate. Таким чином ви можете легко фільтрувати та редагувати вихідні рядки, написані розробниками.

Дивись також

Стани перекладу

Позначити нові переклади як «Потребує переробки»¶

Ідентифікатор додатка:: weblate.flags.target_edit
Налаштування:: Цей додаток не має налаштувань.
Перемикачі:: Попереднє створення блоку

Кожен раз, коли з VCS імпортується новий рядок, що підлягає перекладу, він позначається як такий, що потребує переписання у Weblate. Таким чином ви можете легко фільтрувати та редагувати переклади, створені розробниками.

Дивись також

Стани перекладу

Позначити оновлені переклади з репозиторія як «Потребує переписування»¶

Ідентифікатор додатка:: weblate.flags.target_repo_update
Налаштування:: Цей додаток не має налаштувань.
Перемикачі:: Постсинхронізація блоку

Кожного разу, коли переклад рядка змінюється у VCS, він позначається як такий, що потребує переписання у Weblate. Це особливо корисно, якщо файли перекладу часто оновлюються вручну або за допомогою зовнішньої служби.

Дивись також

Стани перекладу

Заповнити придатні лише для читання рядки початковими рядками¶

Added in version 4.18.

Ідентифікатор додатка:: weblate.generate.fill_read_only
Налаштування:: Цей додаток не має налаштувань.
Перемикачі:: Установка надбудови, Оновлення компонентів, Щодня

Заповнює рядки перекладу, які призначено лише для читання, початковими рядками.

Генератор статистики¶

Ідентифікатор додатка:

weblate.generate.generate

Налаштування:

`filename`	Назва створеного файла
`template`	Вміст створеного файлу

Перемикачі:

Установка надбудови, Попередня фіксація сховища

Створює файл з докладними відомостями щодо стану перекладу.

Ви можете скористатися шаблоном Django одразу для назви файла і вмісту. Докладний опис розмітки можна знайти у розділі Розмітка шаблонів.

Наприклад, створення файла резюме для кожного перекладу:

Назва створеного файла

locale/{{ language_code }}.json

Вміст

{
   "language": "{{ language_code }}",
   "strings": "{{ stats.all }}",
   "translated": "{{ stats.translated }}",
   "last_changed": "{{ stats.last_changed }}",
   "last_author": "{{ stats.last_author }}",
}

Дивись також

Розмітка шаблонів

Заповнити переклади початковими рядками¶

Added in version 4.11.

Ідентифікатор додатка:: weblate.generate.prefill
Налаштування:: Цей додаток не має налаштувань.
Перемикачі:: Установка надбудови, Оновлення компонентів, Щодня

Заповнює рядки перекладу початковими рядками.

Усі неперекладені рядки в компоненті будуть замінені вихідним рядком і позначені як такі, що потребують редагування. Використовуйте цю опцію, якщо у файлах перекладу не можна залишати порожні рядки. .. АВТОМАТИЧНО СТВОРЕНИЙ ПОЧАТОК: weblate.generate.pseudolocale .. Цей розділ автоматично генерується командою ./manage.py list_addons. Не редагуйте його вручну.

Створення псевдолокалей¶

Added in version 4.5.

Ідентифікатор додатка:

weblate.generate.pseudolocale

Налаштування:

`source`	Початкові рядки
`target`	Цільовий переклад	Усі рядки у цьому перекладі буде перезаписано
`prefix`	Доданий статичний текст
`var_prefix`	Додано на початку змінний текст
`suffix`	Додано статичний текст
`var_suffix`	Доданий змінний текст
`var_multiplier`	Змінний текстовий множник	Скільки разів повторювати змінний текст залежно від довжини вихідного рядка.
`include_readonly`	Включити рядки лише для читання

Перемикачі:

Установка надбудови, Оновлення компонентів, Щодня

Автоматично створює переклад додаванням префікса і суфікса до початкових рядків.

Псевдолокалі корисні для пошуку рядків, які не приготовано до локалізації. Результат досягається зміною усіх придатних до перекладу початкових рядків таким чином, щоб рядок, який не змінено, було просто виявити під час запуску програми із відповідними рядками псевдолокальній мові.

Також можливий пошук рядків, локалізовані відповідники яких можуть не відповідати макету.

Використання змінних частин дає змогу шукати рядки, які можуть не поміститися в інтерфейсі після локалізації - вони розширюють текст на основі довжини вихідного рядка. Змінні тексти повторюються на довжину тексту, помножену на множник. Наприклад, Hello world зі змінним текстом _ і змінним множником 1 стає Hello world___________ - текст повторюється один раз для кожного символу у вихідному рядку.

Рядки буде створено за таким взірцем:

Prepended static text Prepended variable text Source string Appended variable text Appended static text

Підказка

Ви можете використовувати справжні мови для перевірки, але у Weblate доступні виділені псевдолокалі — en_XA and ar_XB.

Підказка

Ви можете скористатися цим додатком для того, щоб почати переклад новою локаллю наявної мови або подібною до іншої мовою. Щойно ви додасте переклад до складника, перейдіть до цього додатка. Приклад: якщо у вас вже є локаль fr, і ви хочете започаткувати переклад локаллю fr_CA, просто встановіть fr як джерело, fr_CA як ціль і лишіть поля префікса і суфікса порожніми.

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

Перекладачі в коментарі¶

Ідентифікатор додатка:: weblate.gettext.authors
Налаштування:: Цей додаток не має налаштувань.
Перемикачі:: Попередня фіксація сховища

Оновлює коментар у заголовку файла PO так, щоб до нього було включено імена перекладачів та роки перекладу.

Заголовок файла PO виглядатиме якось так:

# Michal Čihař <michal@weblate.org>, 2012, 2018, 2019, 2020.
# Pavel Borecki <pavel@example.com>, 2018, 2019.
# Filip Hron <filip@example.com>, 2018, 2019.
# anonymous <noreply@weblate.org>, 2019.

Оновити змінну ALL_LINGUAS у файлі «configure»¶

Ідентифікатор додатка:: weblate.gettext.configure
Налаштування:: Цей додаток не має налаштувань.
Перемикачі:: Установка надбудови, Щодня, Репозиторій після додавання, Стан сховища після видалення

Оновлює змінну ALL_LINGUAS у файлах «configure», «configure.in» або «configure.ac» у разі додавання чи вилучення перекладу.

Оновлює змінну ALL_LINGUAS у файлах configure, configure.in або будь-яких файлах configure.ac у разі додавання чи видалення перекладу.

Налаштувати виведення gettext¶

Removed in version 5.13: Замінено на Параметри формату файлу.

Оновити шаблон gettext (Django)¶

Added in version 5.17.

Ідентифікатор додатка:

weblate.gettext.django

Налаштування:

interval

Частота оновлення

Як часто додаток повинен оновлювати файл POT під час оновлення компонента.

Доступні варіанти:¶
`daily`	Щодня
`weekly`	Щотижня
`monthly`	Щомісячно

normalize_header

Нормалізувати заголовок POT

Оновлює заголовки gettext і замінює коментарі-шаблони POT.

location_mode

Розташування у джерелі

Виберіть спосіб записування видобутих даних щодо розташування у коді до файла POT. Скористайтеся цим для зберігання даних щодо розташування до шаблону, не записуючи їх до перекладених файлів PO.

Доступні варіанти:¶
`file`	Використовувати параметри формату файлів
`keep`	Видобути дані щодо розташування до файла POT
`omit`	Не видобувати дані щодо розташування

Перемикачі:

Установка надбудови, Ручний спусковий механізм, Постоновлення сховища

Оновлює шаблон gettext за допомогою вбудованої команди Django makemessages.

This add-on updates the template configured in Шаблон для нових перекладів. It is available for gettext PO components, and the component must define a template for new translations.

The selected update frequency applies to automatic runs after repository refreshes. Installing or reconfiguring the add-on runs it immediately, and manual runs from add-on management or the API also bypass the frequency schedule. After a successful update, Weblate commits the changed template and reloads source strings.

The template update does not update translation PO files by itself. Keep Оновити файли po, порівнявши із pot (msgmerge) installed when translation files should follow template changes automatically. The install form for this add-on can install that add-on, but existing add-on settings do not show that installation option again.

Django requirements¶

This add-on requires xgettext and msguniq. It runs Weblate’s internal extraction wrapper for Django messages instead of invoking a project’s manage.py makemessages, so it does not load project Django settings or applications.

The template for new translations must use the django or djangojs domain. Supported template names are django.pot, djangojs.pot, django.po, and djangojs.po. Weblate infers the source directory from the template path and skips repository locale directories while extracting.

Оновити файл LINGUAS¶

Ідентифікатор додатка:: weblate.gettext.linguas
Налаштування:: Цей додаток не має налаштувань.
Перемикачі:: Установка надбудови, Щодня, Репозиторій після додавання, Стан сховища після видалення

Оновлює файл LINGUAS у разі додавання або вилучення перекладу.

Оновити файл POT (Meson)¶

Added in version 5.17.

Ідентифікатор додатка:

weblate.gettext.meson

Налаштування:

interval

Частота оновлення

Як часто додаток повинен оновлювати файл POT під час оновлення компонента.

Доступні варіанти:¶
`daily`	Щодня
`weekly`	Щотижня
`monthly`	Щомісячно

normalize_header

Нормалізувати заголовок POT

Оновлює заголовки gettext і замінює коментарі-шаблони POT.

location_mode

Розташування у джерелі

Доступні варіанти:¶
`file`	Використовувати параметри формату файлів
`keep`	Видобути дані щодо розташування до файла POT
`omit`	Не видобувати дані щодо розташування

comment_mode

Коментарі до коду

Виберіть варіант видобування коментарів за допомогою xgettext: без коментарів, усі коментарі або лише коментарі із певною міткою.

Доступні варіанти:¶
`off`	Не видобувати коментарі
`all`	Видобути усі коментарі
`tagged`	Видобути коментарі із міткою

comment_tag

Мітка коментарів

Мітка, яку буде передано xgettext для видобування коментарів при використанні режиму коментарів із мітками.

checks

Перевірки xgettext

Додаткові перевірки чинності xgettext, які слід увімкнути для видобутих повідомлень.

Доступні варіанти:¶
`ellipsis-unicode`	ellipsis-unicode
`space-ellipsis`	space-ellipsis“
`quote-unicode`	quote-unicode“
`bullet-unicode`	bullet-unicode“

keyword

Додаткове ключове слово

Необов’язкове додаткове ключове слово, яке буде передано xgettext за допомогою –keyword.

keyword_exclusive

Використовувати ключові слова у виключний спосіб

When enabled, passes --keyword without a value to xgettext before the additional keyword, disabling all default keywords so that only the keyword specified above is recognized.

preset

Пресет «Мезон»

Вбудований набір аргументів xgettext, що відповідає інтеграції Meson з gettext. Цей набір для GLib додає опції ключових слів та прапорців форматування, які використовує допоміжна програма gettext у Meson.

Доступні варіанти:¶
`glib`	„GLib

Перемикачі:

Установка надбудови, Ручний спусковий механізм, Постоновлення сховища

Оновлює шаблон gettext відповідно до стандартів Meson для gettext.

Meson requirements¶

This add-on requires xgettext; it does not invoke Meson. It follows Meson gettext conventions by reading POTFILES or POTFILES.in from the gettext directory and passing the GLib keyword and format-flag preset to xgettext.

The gettext directory is the directory containing the template configured in Шаблон для нових перекладів. It must contain meson.build and POTFILES or POTFILES.in. A Meson project meson.build must be present in that directory or one of its parent directories. If both POTFILES and POTFILES.in exist, POTFILES is used. An adjacent POTFILES.skip excludes listed source files from extraction.

Configure this add-on from the existing Meson gettext setup. In most Meson projects, the gettext directory is po/, the template is named after the gettext domain, and po/meson.build calls Meson’s gettext helper. Use the same template path in Шаблон для нових перекладів, for example po/example.pot, and keep POTFILES or POTFILES.in next to that meson.build file.

Weblate does not read the source file list from meson.build. It uses POTFILES or POTFILES.in, matching Meson’s gettext convention. When the Meson project uses a non-default gettext directory or domain, mirror that layout in the component template path.

Генерувати mo-файли¶

Ідентифікатор додатка:

weblate.gettext.mo

Налаштування:

`path`	Шлях до згенерованого MO-файлу	Якщо не вказано, використовуватиметься розташування PO-файлу.
`fuzzy`	Включати рядки, які потребують редагування	Рядки, що потребують редагування (неточні), зазвичай не готові до використання як переклади.

Перемикачі:

Попередня фіксація сховища

Автоматично створює mo-файл для кожного зміненого po-файла.

Розташування згенерованого MO-файлу можна налаштувати, а поле для нього використовувати Розмітка шаблонів.

Примітка

Якщо переклад буде вилучено, його файл PO буде вилучено зі сховища, але файл MO, який створено цим додатком, вилучено не буде. Файл MO доведеться вилучити зі сховища основного коду вручну.

Оновити файли po, порівнявши із pot (msgmerge)¶

Змінено в версії 5.13: Settings конфігурацію перенесено до Параметри формату файлу.

Ідентифікатор додатка:: weblate.gettext.msgmerge
Налаштування:: Цей додаток не має налаштувань.
Перемикачі:: Установка надбудови, Постоновлення сховища

Оновлює усі файли PO (відповідно до налаштування «Маски файлів»), встановлюючи відповідність файлу POT (який налаштовано параметром «Шаблон для нових перекладів») за допомогою msgmerge.

Цей додаток є необхідним при роботі з файлами gettext PO, де файл POT (шаблон) оновлюється новими рядками або змінами до існуючих рядків. Коли файл POT оновлюється в репозиторії, цей додаток автоматично об’єднує ці зміни у всіх мовних файлах PO, забезпечуючи:

Нові рядки, які можна перекладати, з’являються всіма мовами
Вилучені рядки позначено як застарілі
Змінені рядки позначені як такі, що потребують перевірки (нечіткі)

Most msgmerge command-line options can be set up through file format parameters configuration. Enable the po_remove_obsolete parameter to remove obsolete #~ entries when PO files are saved.

Дивись також

Оновити файл POT (Sphinx)¶

Added in version 5.17.

Ідентифікатор додатка:

weblate.gettext.sphinx

Налаштування:

interval

Частота оновлення

Як часто додаток повинен оновлювати файл POT під час оновлення компонента.

Доступні варіанти:¶
`daily`	Щодня
`weekly`	Щотижня
`monthly`	Щомісячно

normalize_header

Нормалізувати заголовок POT

Оновлює заголовки gettext і замінює коментарі-шаблони POT.

location_mode

Розташування у джерелі

Доступні варіанти:¶
`file`	Використовувати параметри формату файлів
`keep`	Видобути дані щодо розташування до файла POT
`omit`	Не видобувати дані щодо розташування

filter_mode

Фільтрування

За бажанням вилучіть рядки, які не потрібно перекладати, після вилучення даних за допомогою Sphinx.

Доступні варіанти:¶
`none`	Немає
`weblate_docs`	Документації Weblate

Перемикачі:

Установка надбудови, Ручний спусковий механізм, Постоновлення сховища

Оновлює шаблон gettext за допомогою засобу побудови gettext від Sphinx без завантаження конфігурації проєкту.

Sphinx requirements¶

This add-on requires sphinx-build, provided by the sphinx installation extra. The template for new translations must be a .pot file below a locales directory. The directory before locales is used as the Sphinx source directory and must contain conf.py.

Extraction uses Weblate’s bundled Sphinx configuration and does not load the project configuration. Weblate runs the Sphinx gettext builder, normalizes source references to paths relative to the source directory, and copies the generated template back to the configured template path.

Оновити файл POT (xgettext)¶

Added in version 5.17.

Ідентифікатор додатка:

weblate.gettext.xgettext

Налаштування:

interval

Частота оновлення

Як часто додаток повинен оновлювати файл POT під час оновлення компонента.

Доступні варіанти:¶
`daily`	Щодня
`weekly`	Щотижня
`monthly`	Щомісячно

normalize_header

Нормалізувати заголовок POT

Оновлює заголовки gettext і замінює коментарі-шаблони POT.

location_mode

Розташування у джерелі

Доступні варіанти:¶
`file`	Використовувати параметри формату файлів
`keep`	Видобути дані щодо розташування до файла POT
`omit`	Не видобувати дані щодо розташування

comment_mode

Коментарі до коду

Доступні варіанти:¶
`off`	Не видобувати коментарі
`all`	Видобути усі коментарі
`tagged`	Видобути коментарі із міткою

comment_tag

Мітка коментарів

Мітка, яку буде передано xgettext для видобування коментарів при використанні режиму коментарів із мітками.

checks

Перевірки xgettext

Додаткові перевірки чинності xgettext, які слід увімкнути для видобутих повідомлень.

Доступні варіанти:¶
`ellipsis-unicode`	ellipsis-unicode
`space-ellipsis`	space-ellipsis“
`quote-unicode`	quote-unicode“
`bullet-unicode`	bullet-unicode“

keyword

Додаткове ключове слово

Необов’язкове додаткове ключове слово, яке буде передано xgettext за допомогою –keyword.

keyword_exclusive

Використовувати ключові слова у виключний спосіб

When enabled, passes --keyword without a value to xgettext before the additional keyword, disabling all default keywords so that only the keyword specified above is recognized.

input_mode

Джерело вхідного сигналу

Виберіть, чи xgettext має зчитувати вихідні файли за шаблонами glob, чи з маніфесту POTFILES/POTFILES.in.

Доступні варіанти:¶
`patterns`	Шаблони вихідних файлів
`potfiles`	Маніфест POTFILES

language

xgettext: мова

Мова програмування, яка передається до xgettext, наприклад Python або C. Не заповнюйте, щоб xgettext визначив мову за суфіксом назв файлів.

source_patterns

Шаблони вихідних файлів

Шаблони пошуку, відокремлені символами нового рядка, що відносяться до репозиторія, для файлів, які потрібно видобути за допомогою xgettext.

potfiles_path

Шлях до POTFILES

Відносний шлях до POTFILES або POTFILES.in у репозиторії. Записи інтерпретуються відносно кореневого каталогу репозиторія. Якщо файл POTFILES.skip розміщений поруч із маніфестом, він виключає вказані в ньому файли з розпакування.

Перемикачі:

Установка надбудови, Ручний спусковий механізм, Постоновлення сховища

Оновлює шаблон gettext за допомогою xgettext для вибраних вихідних файлів.

xgettext requirements¶

This add-on requires xgettext. Configure either source file patterns or a POTFILES / POTFILES.in manifest. Source file patterns are repository-relative glob patterns and only matching repository files are passed to xgettext.

Entries in POTFILES or POTFILES.in are resolved relative to the repository root. They must be relative paths, stay inside the repository, and point to existing files. Blank lines and lines starting with # are ignored. If a POTFILES.skip file exists next to the manifest, its entries are excluded from extraction.

Automatic repository refresh runs are skipped unless the changed files match the configured source patterns, match files listed in the manifest, change a watched manifest, or change the add-on configuration.

Start from the build-system extraction setup when configuring this add-on. Autotools projects usually keep gettext inputs in po/POTFILES.in and options such as the gettext domain and xgettext flags in po/Makevars or related Makefile.am files. Use manifest mode with the same POTFILES.in when its entries are plain repository-relative source paths, and copy relevant extraction behavior into the add-on settings, for example the language, comment extraction, checks, and additional keyword.

For other build systems, use the source list or extraction command they already run as the source of truth. CMake, custom Makefiles, npm scripts, or project specific extraction scripts often call xgettext directly or generate an intermediate file list. Configure source patterns for simple layouts, or use manifest mode when the project maintains a plain file list. If a build-system manifest contains transformations or prefixes that are not file paths, convert it to plain repository-relative paths before using it as POTFILES.

Сполучити Git подання¶

Ідентифікатор додатка:

weblate.git.squash

Налаштування:

squash

Сполучення подань

Доступні варіанти:¶
`all`	Всі подання в одне
`language`	Для мови
`file`	Для файлу
`author`	Для кожного автора

append_trailers

Дописати кінцевики для обʼєднаного повідомлення про внесок

Рядки-кінцевики подібні до заголовків повідомлень електронної пошти за RFC 822. Їх дописують в кінці повідомлення про внесок у довільній формі, наприклад, «Co-authored-by: …».

commit_message

Повідомлення щодо подання

Це повідомлення про внесок буде використано замість поєднаних повідомлень про внески з обʼєднаних внесків.

Перемикачі:

Установка надбудови, Репозиторій після фіксації

Обʼєднати Git подання перед відправленням змін.

Підказка

Щоб уникнути непотрібних конфліктів, рекомендується налаштувати автоматичне отримання змін у вихідному коді за допомогою вебхуків або API, див. Оновлення сховищ.

Внески Git можна об’єднувати до запису змін з використанням одного з таких режимів:

Всі подання в одне
Для мови
Для файлу
Для кожного автора

Початкові повідомлення про внесок зберігаються, але авторство втрачається, якщо не позначено пункт За автором або повідомлення про внесок не налаштовано на його включення.

Початкові повідомлення про внески можна, якщо хочеться, перевизначити нетиповим повідомленням про внесок.

Трейлери (рядки внеску, подібні до Co-authored-by: ...) можна, якщо хочеться, вилучити з початкових повідомлень про внесок і дописати наприкінці об’єднаного повідомлення про внесок. Це також створює належний запис авторських прав Co-authored-by: для кожного перекладача.

Налагодити виведення JSON¶

Змінено в версії 5.12: Avoid spaces after separators додано опцію.

Removed in version 5.13: Замінено на Параметри формату файлу.

Скинути репозиторій до стану «upstream»¶

Added in version 5.17.

Ідентифікатор додатка:: weblate.hosted.reset
Налаштування:: Цей додаток не має налаштувань.
Перемикачі:: Установка надбудови, Щодня

Щоночі скидає всі зміни у репозиторії Weblate.

Форматувати файл властивостей Java¶

Ідентифікатор додатка:

weblate.properties.sort

Налаштування:

case_sensitive

Дозволити сортування ключів з урахуванням регістру

Перемикачі:

Попередня фіксація сховища

Форматує й упорядковує файл властивостей Java.

Встановлює усюди символи нового рядка Unix.
Встановлює форматування керівних послідовностей Unicode (якщо такі є) з використанням великих літер.
Вилучає порожні рядки і коментарі.
Упорядковує рядки за ключовими значеннями.
Відкидає рядки-повтори.

Видалення застарілого коментаря¶

Ідентифікатор додатка:

weblate.removal.comments

Налаштування:

age

Дні для збереження

Перемикачі:

Установка надбудови, Щодня

Вказати термін вилучення застарілих коментарів.

Це може бути корисним для вилучення застарілих коментарів, які могли перестати бути актуальними. Користайтеся цією можливістю обережно, оскільки те, що коментар застарів, не означає, що він перестав бути важливим.

Видалити застарілу пропозицію¶

Ідентифікатор додатка:

weblate.removal.suggestions

Налаштування:

`age`	Дні для збереження
`votes`	Поріг голосування	Поріг для видалення. Залиште поле порожнім, щоб видаляти пропозиції незалежно від кількості голосів. Це поле не діє, якщо голосування вимкнено.

Перемикачі:

Установка надбудови, Щодня

Встановити строк вилучення пропозицій.

Це може бути дуже корисним у поєднанні із голосуванням за пропозиції (див. Експертне рецензування) для вилучення пропозицій, які не отримують достатньої кількості позитивних голосів протягом вказаного часового проміжку.

Оновити файли RESX¶

Ідентифікатор додатка:: weblate.resx.update
Налаштування:: Цей додаток не має налаштувань.
Перемикачі:: Установка надбудови, Постоновлення сховища

Оновити усі файли перекладу, щоб вони відповідали одномовному основному файлу. Невикористані рядки вилучаються, а нові додаються як копії початкового рядка.

Підказка

Скористайтеся Очищення файлів перекладу, якщо ви хочете лише вилучити застарілі переклади.

Дивись також

Чи оновлює Weblate файли перекладів між перекладами?

Слак Вебхуки¶

Added in version 5.12.

Ідентифікатор додатка:

weblate.webhook.slack

Налаштування:

`webhook_url`	Адреса дієскрипту
`event_filter`	Події зміни для вмикання	Choose which change events should trigger this add-on. Події зміни для вмикання
`events`	Вибрані події зміни	Вибрані події зміни

Перемикачі:

Зміна події

Надсилає сповіщення до каналу Slack на основі вибраних подій.

Попередження

У вмісті сповіщень можуть міститися теги HTML. Це відома проблема, яку буде вирішено найближчим часом; див. https://github.com/WeblateOrg/weblate/issues/15056.

Підказка

Щоб отримати URL-адресу вебхука, виконайте кроки, описані в документації до Slack Incoming Webhooks.

Дієскрипт¶

Added in version 5.11.

Змінено в версії 5.15: Відповідність довжини секретного коду специфікації тепер підтверджена.

Ідентифікатор додатка:

weblate.webhook.webhook

Налаштування:

`webhook_url`	Адреса дієскрипту
`secret`	Секрет вебхука	Секрет стандартних вебхуків — це рядок, закодований у base64.
`event_filter`	Події зміни для вмикання	Choose which change events should trigger this add-on. Події зміни для вмикання
`events`	Вибрані події зміни	Вибрані події зміни

Перемикачі:

Зміна події

Надсилає сповіщення зовнішнім службам на основі вибраних подій, дотримуючись специфікації Standard Webhooks.

The request payload complies with the Weblate Messaging schema. The action field uses the action name listed in Вибрані події зміни. The OpenAPI description can also be found at /api/docs/. Sample request body:

{
   "change_id": 99,
   "action": "Translation changed",
   "timestamp": "2019-08-24T14:15:22Z",
   "target": "Nazdar svete!",
   "old": "Nazdar!",
   "source": "Hello, world",
   "url": "/translate/project-slug/component-slug/cs/?checksum=46add148a53cab6f",
   "author": "author-username",
   "user": "user-username",
   "project": "project-slug",
   "component": "component-slug",
   "translation": "cs"
}

Зразок тексту запиту з категоріями:

{
   "change_id": 8910,
   "action": "Component renamed",
   "timestamp": "2025-06-11T07:15:09Z",
   "target": ["new-name"],
   "old": ["component-slug"],
   "url": "/projects/project-slug/parent-category/child-category/sub-category/component-slug/",
   "user": "testuser",
   "project": "project-slug",
   "component": "component-slug",
   "category": [
      "sub-category",
      "child-category",
      "parent-category"
   ]
}

Зразки заголовків запиту:

{
   "webhook-id": "7f1c5477f6275a69af7b83236c20cb1a",
   "webhook-timestamp": "1748505623.044281",
   "webhook-signature": "v1,Ceo5qEr07ixe2NLpvHk3FH9bwy/WavXrAFQ/9tdO6mc="
}

webhook-signature — це список підписів HMAC, розділених пробілами, згенерованих за допомогою рядка secret, корисного навантаження запиту, webhook-timestamp та webhook-id. Це гарантує автентичність та цілісність запиту вебхука.

Наданий secret — це рядок у форматі base64 довжиною від 24 байтів (192 біти) до 64 байтів (512 бітів). Для легкої ідентифікації його можна починати з префікса whsec_.

Щоб перевірити запит, ви можете скористатися методом Webhook.verify з бібліотеки standardwebhooks або реалізацією «Стандартної специфікації вебхуків».

Дивись також

Застарілі доповнення¶

Налагодити виведення XML¶

Added in version 4.15.

Removed in version 5.13: Замінено на Параметри формату файлу.

Налагодити виведення YAML¶

Removed in version 5.13: Замінено на Параметри формату файлу.

Загальні додаткові параметри¶

Рушії компʼютерного перекладу¶

Доступні варіанти:¶
`alibaba`	Alibaba
`aws`	Amazon Translate
`anthropic`	Anthropic
`apertium-apy`	Apertium APy
`microsoft-translator`	Azure AI Translator
`azure-openai`	Azure OpenAI
`baidu`	Baidu
`cyrtranslit`	CyrTranslit
`deepl`	DeepL
`glosbe`	Glosbe
`google-translate-api-v3`	Розширений хмарний перекладач Google
`google-translate`	Базовий хмарний перекладач Google
`ltengine`	LTEngine
`libretranslate`	LibreTranslate
`mistral`	Mistral
`modernmt`	ModernMT
`mymemory`	MyMemory
`netease-sight`	Netease Sight
`ollama`	Ollama
`openai`	OpenAI
`sap-translation-hub`	Концентратор перекладів SAP
`systran`	Systran
`weblate`	Weblate
`weblate-translation-memory`	Пам’ять перекладів Weblate
`yandex`	Yandex
`yandex-v2`	Yandex v2
`youdao-zhiyun`	Youdao Zhiyun
`tmserver`	tmserver

Формат файлу¶

Доступні варіанти:¶
`apple-xliff`	XLIFF 1.2 з розширеннями Apple
`appstore`	Файли метаданих крамниці програм
`arb`	Файл ARB
`aresource`	Рядки ресурсів Android
`asciidoc`	Файли AsciiDoc
`ass`	Розширений файл субтитрів SubStation Alpha
`catkeys`	Ключі від котів хайку
`cmp-resource`	Ресурс Compose Multiplatform
`csv`	Файл CSV
`csv-multi`	Багатозначний файл CSV
`csv-simple`	Простий файл CSV
`dokuwiki`	Текстовий файл DokuWiki
`dtd`	Файл DTD
`flatxml`	Плоский XML-файл
`fluent`	Файл Fluent
`formatjs`	Формат.JS файлуJSON
`go-i18n-json`	Файл JSON go-i18n v1
`go-i18n-json-v2`	Файл JSON go-i18n v2
`go-i18n-toml`	Файл TOML go-i18n
`gotext`	файл JSON gotext
`gwt`	Властивості GWT
`html`	Файл HTML
`i18next`	Файл JSON i18next v3
`i18nextv4`	Файл JSON i18next v4
`idml`	Файл IDML
`ini`	Файл INI
`islu`	Файл INI Inno Setup
`joomla`	Мовний файл Joomla
`json`	Файл JSON
`json-nested`	Файл JSON із вкладеною структурою
`laravel`	Рядки PHP Laravel
`markdown`	Файл Markdown
`mdx`	Файл MDX
`mediawiki`	Текстовий файл MediaWiki
`mi18n-lang`	@draggable/мовний файл mi18n
`moko-resource`	Мобільний ресурс Kotlin
`nextcloud-json`	JSON-файл Nextcloud
`odf`	Файл OpenDocument
`php`	Рядки PHP
`plainxliff`	Файл перекладу XLIFF 1.2
`po`	gettext PO файл
`po-mono`	gettext PO файл (одномовний)
`poxliff`	XLIFF 1.2 із розширеннями gettext
`properties`	Властивост Java
`rc`	Файл RC
`resjson`	Файл RESJSON
`resourcedictionary`	файл ResourceDictionary
`resx`	Файл ресурсів .NET
`ruby-yaml`	Файл Ruby YAML
`srt`	Файл субтитрів SubRip
`ssa`	Файл субтитрів SubStation Alpha
`strings`	Рядки iOS
`stringsdict`	Файл Stringsdict
`sub`	Файл субтитрів MicroDVD
`tbx`	Файл TermBase eXchange
`toml`	TOML-файл
`ts`	Файл перекладу Qt Linguist (версія 2)
`ts1`	Файл перекладу Qt Linguist (версія 1)
`txt`	Звичайний текстовий файл
`webextension`	Файл JSON для WebExtension
`wxl`	Файл WixLocalization
`xliff`	XLIFF 1.2 із підтримкою замінників
`xliff2`	Файл перекладу XLIFF 2.0
`xliff2-placeables`	Файл перекладу XLIFF 2.0 з підтримкою розміщуваних елементів
`xlsx`	Excel Open XML
`xwiki-fullpage`	Повна сторінка XWiki
`xwiki-java-properties`	Властивості Java XWiki
`xwiki-page-properties`	Властивості сторінки XWiki
`yaml`	Файл YAML

Події зміни для вмикання¶

Доступні варіанти:¶
`content`	Події вмісту перекладу
`all`	Усі події зміни
`custom`	Вибрані події зміни

Вибрані події зміни¶

The following change actions can appear in notification payloads. Fedora Messaging uses the identifier column in message topics, while webhook payloads use the name column in the action field.

Доступні варіанти:¶
ID	Identifier	Назва	Опис
`0`	`resource_updated`	Ресурс оновлено	Файл перекладу було синхронізовано з його репозиторієм.
`1`	`translation_completed`	Переклад завершено	Переклад став повним у результаті окремого редагування. Автоматичний переклад, вивантаження перекладу та пакетні редагування не призводитимуть до появи цієї події.
`2`	`translation_changed`	Переклад змінено	Наявний переклад було змінено користувачем.
`3`	`comment_added`	Коментар додано	До рядка було додано коментар.
`4`	`suggestion_added`	Додано пропозицію	Було додано пропозицію перекладу.
`5`	`translation_added`	Додано переклад	Раніше не перекладений рядок було перекладено користувачем.
`6`	`automatically_translated`	Перекладено автоматично	Переклад було додано або змінено у результаті автоматичного перекладу. Цю подію буде створено замість «Переклад додано» або «Переклад змінено».
`7`	`suggestion_accepted`	Пропозицію прийнято	Пропозицію перекладу було прийнято як переклад.
`8`	`translation_reverted`	Пропозицію завернуто	Переклад було відновлено до ранішого значення.
`9`	`translation_uploaded`	Пропозицію завантажено	Переклад було додано або змінено у результаті вивантаження файла. Цю подію буде створено замість «Переклад додано» або «Переклад змінено».
`13`	`source_string_added`	Додано початковий рядок	Початковий рядок було додано поза сховищем або оновлення вивантаженням.
`14`	`component_locked`	Складник заблоковано	Складник було заблоковано для перекладу.
`15`	`component_unlocked`	Складник розблоковано	Складник було розблоковано для перекладу.
`17`	`changes_committed`	Записано зміни	Зміни з черги обробки складників було внесено до репозиторія.
`18`	`changes_pushed`	Зміни записано до сховища	Зміни у репозиторії було записано до основного репозиторія.
`19`	`repository_reset`	Відновлено початковий стан сховища	Стан репозиторія було відновлено до стану в основній гілці розробки.
`20`	`repository_merged`	Сховища об’єднано	Зміни в основній гілці розробки було об’єднано зі кодом на Weblate.
`21`	`repository_rebased`	Зміни зі сховища перенесено	Зміни у репозиторії було перенесено на код з основної гілки розробки.
`22`	`repository_merge_failed`	Не вдалося об’єднати сховища	Не вдалося об’єднати зміни з кодом в основній гілці розробки.
`23`	`repository_rebase_failed`	Не вдалося перенести зміни зі сховища	Не вдалося перенести зміни зі сховища.
`24`	`parsing_failed`	Не вдалося обробити дані	Weblate не вдалося обробити файл перекладу.
`25`	`translation_removed`	Переклад вилучено	Переклад мовою було вилучено.
`26`	`suggestion_removed`	Вилучено пропозицію	Пропозицію перекладу вилучено.
`27`	`translation_replaced`	Переклад замінено	Переклад було змінено внаслідок дії з пошуку із заміною. Буде надіслано замість «Переклад змінено».
`28`	`repository_push_failed`	Не вдалося записати зміни до сховища	Не вдалося записати зміни у сховищі до основної гілки.
`29`	`suggestion_removed_during_cleanup`	Вилучено пропозицію під час очищення	Застарілу пропозицію перекладу вилучено під час очищення.
`30`	`source_string_changed`	Змінено початковий рядок	Початковий рядок було змінено на Weblate.
`31`	`string_added`	Додано рядок	Новий рядок було додано на Weblate.
`32`	`bulk_status_changed`	Змінено пакетний стан	Стан перекладу одного або декількох рядків було пакетно змінено.
`33`	`visibility_changed`	Змінено видимість	Змінено видимість проєкту або складника.
`34`	`user_added`	Додано користувача	Користувачу було надано доступ.
`35`	`user_removed`	Вилучено користувача	Доступ користувача було вилучено.
`36`	`translation_approved`	Переклад затверджено	Переклад було затверджено під час рецензування.
`37`	`marked_for_edit`	Позначено для редагування	Переклад було позначено як такий, що потребує редагування.
`38`	`component_removed`	Складник вилучено	Складник перекладу було вилучено.
`39`	`project_removed`	Проєкт вилучено	Проєкт перекладу було вилучено.
`41`	`project_renamed`	Проєкт перейменовано	Проєкт перекладу було перейменовано.
`42`	`component_renamed`	Складник перейменовано	Складник перекладу було перейменовано.
`43`	`moved_component`	Пересунуто складник	Складник було переміщено у межах проєкту.
`45`	`contributor_joined`	Долучився учасник	Користувач зробив перший внесок до перекладу.
`46`	`announcement_posted`	Оприлюднено оголошення	Оприлюднено оголошення.
`47`	`alert_triggered`	Надіслано попередження	Спрацювало попередження щодо складника.
`48`	`language_added`	Додано мову	Додано переклад мовою.
`49`	`language_requested`	Надіслано запит щодо мови	Надійшов запит від користувача на нову мову.
`50`	`project_created`	Створено проєкт	Створено проєкт з перекладу.
`51`	`component_created`	Створено складник	Створено складник перекладу.
`52`	`user_invited`	Запрошено користувача	До проєкту запрошено користувача.
`53`	`repository_notification_received`	Отримано сповіщення щодо сховища	Weblate отримано сповіщення репозиторію від сайта сайтів розміщення коду.
`54`	`translation_replaced_file_by_upload`	Замінено файл перекладу вивантаженням	Файл перекладу було замінено вивантаженим файлом.
`55`	`license_changed`	Змінено умови ліцензування	Змінено відомості щодо ліцензування проєкту або складника.
`56`	`contributor_license_agreement_changed`	Ліцензійна угода співучасника змінена	Змінено ліцензіційну угоду учасника.
`57`	`screenshot_added`	Додано знімок екрана	З рядком пов’язано знімок вікна.
`58`	`screenshot_uploaded`	Знімок вивантажено	Вивантажено зображення знімка вікна.
`59`	`string_updated_in_the_repository`	Рядок оновлено у репозиторії	Під час синхронізації з репозиторієм змінено рядок.
`60`	`add-on_installed`	Додаток встановлено	Встановлено додаток.
`61`	`add-on_configuration_changed`	Змінено налаштування додатка	Змінено налаштування додатка.
`62`	`add-on_uninstalled`	Додаток вилучено	Додаток вилучено.
`63`	`string_removed`	Вилучено рядок	З перекладу було вилучено рядок.
`64`	`comment_removed`	Вилучено коментар	Вилучено коментар до рядка.
`65`	`comment_resolved`	Вирішено коментар	Коментар до рядка позначено як вирішений.
`66`	`explanation_updated`	Оновлено пояснення	Оновлено пояснення до початкового рядка.
`67`	`category_removed`	Вилучено категорію	Вилучено категорію складників.
`68`	`category_renamed`	Перейменовано категорію	Перейменовано категорію складників.
`69`	`category_moved`	Пересунуто категорію	Пересунуто категорію складників.
`70`	`saving_string_failed`	Не вдалося зберегти рядок	Weblate не вдалося зберегти змінений рядок.
`71`	`string_added_in_the_repository`	Рядок додано до репозиторія	Під час синхронізації даних з репозиторієм виявлено новий рядок.
`72`	`string_updated_in_the_upload`	Рядок оновлено під час завантаження	Під час обробки вивантаженого файла змінено рядок.
`73`	`string_added_in_the_upload`	Рядок додано під час завантаження	Під час обробки вивантаженого файла виявлено новий рядок.
`74`	`translation_updated_by_source_upload`	Переклад оновлено після завантаження джерела	Після вивантаження початкового файла переклад синхронізовано.
`75`	`component_translation_completed`	Переклад складника завершено	Після окремого редагування усі переклади мовою у складнику стали повністю перекладеними. Автоматичний переклад, вивантаження та пакетне редагування не призводять до надсилання цієї події.
`76`	`applied_enforced_check`	Застосовано примусову перевірку	Переклад було позначено як такий, що потребує редагування, примусовою перевіркою.
`77`	`propagated_change`	Розповсюджена зміна	Редагування перекладу поширено на інший відповідний рядок.
`78`	`file_uploaded`	Файл завантажено	До перекладу було вивантажено файл.
`79`	`extra_flags_updated`	Додаткові прапорці оновлено	Було оновлено додатокві прапорці початкового рядка.
`80`	`font_uploaded`	Шрифт вивантажено	Шрифт вивантажено.
`81`	`font_changed`	Шрифт змінено	Змінено вивантажений шрифт.
`82`	`font_removed`	Шрифт вилучено	Вилучено вивантажений шрифт.
`83`	`forced_synchronization_of_translations`	Примусова синхронізація перекладів	Файли перекладу було примусово синхронізовано з репозиторієм.
`84`	`forced_rescan_of_translations`	Примусове повторне сканування перекладів	Виконано примусове повторне сканування змін у файлах перекладу.
`85`	`screenshot_removed`	Знімок екрана вилучено	Знімок вікна вилучено.
`86`	`label_added`	Мітку додано	До рядка додано мітку.
`87`	`label_removed`	Мітку вилучено	Мітку вилучено з рядка.
`88`	`repository_cleanup`	Очищення репозиторію	Робочу ієрархію репозиторію було очищено.
`89`	`source_string_added_in_the_upload`	У завантаженому файлі додано вихідний рядок	Під час обробки вивантаженого файла було додано початковий рядок.
`90`	`source_string_added_in_the_repository`	До репозиторію додано вихідний рядок	Під час синхронізації з репозиторієм було додано рядок.
`91`	`project_backed_up`	Проект збережено	Було створено резервну копію проєкту.
`92`	`project_restored`	Проект відновлено	Проєкт було відновлено з резервної копії.
`93`	`component_restored`	Компонент відновлено	Складних було відновлено з резервної копії.
`94`	`user_edit_reverted`	Зміни користувача скасовано	Наслідки усіх позначених редагувань від користувача було скасовано.
`95`	`project_setting_changed`	Змінено налаштування проекту	Змінено параметр проєкту.
`96`	`component_setting_changed`	Змінено налаштування компонента	Змінено параметр складника.
`97`	`user_access_changed`	Змінено права доступу користувача	Змінено права доступу користувача.
`98`	`workspace_created`	Робочу область створено	Було створено робочий простір.
`99`	`workspace_setting_changed`	Налаштування робочого простору змінено	Налаштування робочого простору змінено.
`100`	`project_moved`	Проєкт перенесено	Проєкт було пересунуто до робочого простору або за його межі.
`101`	`remote_repository_updated`	Оновлено віддалений репозиторій	Завершено оновлення віддаленого сховища.
`102`	`remote_repository_update_failed`	Не вдалося оновити дані віддаленого репозиторію	Не вдалося оновити дані віддаленого репозиторію.
`103`	`alert_dismissed`	Попередження пропущено	Попередження щодо складника було відкинуто.
`104`	`alert_reopened`	Попередження повторно відкрито	Попередження складника було повторно відкрито після зміни його контексту.

Налаштовування списку додатків¶

Список додатків налаштовується WEBLATE_ADDONS. Щоб додати додаток, просто до цього параметра включіть абсолютну назву класу.

Написання додатка¶

Ви також можете написати власні додатки — створіть підклас від weblate.addons.base.BaseAddon, щоб визначити метадані додатка і реалізувати зворотний виклик, який виконуватиме обробку.

Дивись також

Розробка додатків

Виконання скриптів з додатка¶

Додатками також можна скористатися для виконання зовнішніх скриптів. Цю можливість інтегровано до Weblate, але тепер вам потрібно написати певний код обгортки вашого скрипту до стану додатка.

# Copyright © Michal Čihař <michal@weblate.org>
#
# SPDX-License-Identifier: GPL-3.0-or-later

"""Example pre commit script."""

from __future__ import annotations

from typing import ClassVar

from django.utils.translation import gettext_lazy

from weblate.addons.events import AddonEvent
from weblate.addons.scripts import BaseScriptAddon


class ExamplePreAddon(BaseScriptAddon):
    # Event used to trigger the script
    events: ClassVar[set[AddonEvent]] = {
        AddonEvent.EVENT_PRE_COMMIT,
    }
    # Name of the addon, has to be unique
    name = "weblate.example.pre"
    # Verbose name and long description
    verbose = gettext_lazy("Execute script before commit")
    description = gettext_lazy("This add-on executes a script.")

    # Script to execute
    script = "/bin/true"
    # File to add in commit (for pre commit event)
    # does not have to be set
    add_file = "po/{{ language_code }}.po"

Настанови щодо встановлення наведено у розділі Спеціальні перевірки якості, доповнення, автоматичні пропозиції та автоматичні виправлення.

Скрипт виконується у поточному каталозі, яким є кореневий каталог сховища системи керування версіями для будь-якого заданого складника.

Крім того, можна скористатися такими змінними середовища:

WL_VCS¶: Використана система керування версіями.

WL_REPO¶: Адреса основного сховища із кодом.

WL_PATH¶: Абсолютний шлях до сховища системи керування версіями.

WL_BRANCH¶: Гілка сховища, яку налаштовано у поточному складнику.

WL_FILEMASK¶: Маска файлів для поточного складника.

WL_TEMPLATE¶: Назва файла шаблона для одномовного перекладу (може бути порожньою).

WL_NEW_BASE¶: Назва файла, який використовується для створення перекладів (може бути порожньою).

WL_FILE_FORMAT¶: Формат файла у поточному складнику.

WL_LANGUAGE¶: Мова поточного оброблюваного перекладу (недоступна для скриптів керування на рівні складника).

WL_PREVIOUS_HEAD¶: Попередній HEAD при оновленні (доступно, лише якщо запускається скрипт обробки після оновлення).

WL_COMPONENT_SLUG¶: Ідентифікатор складника, який використовується для побудови адреси.

WL_PROJECT_SLUG¶: Ідентифікатор проєкту, який використовується для побудови адреси.

WL_COMPONENT_NAME¶: Назва складника.

WL_PROJECT_NAME¶: Назва проєкту.

WL_COMPONENT_URL¶: Адреса складника.

WL_ENGAGE_URL¶: Адреса роботи з проєктом.

Дивись також

Налаштовування складників

Обробка сховища після оновлення¶

Можна скористатися для оновлення файлів перекладу, коли міняється джерело у основному сховищі системи керування версіями. Слід пам’ятати, що Weblate «бачить» лише файли, які внесено до системи керування версіями, тому вам доведеться внести зміни до сховища у самому скрипті.

Наприклад, з Gulp ви можете зробити це за допомогою такого коду:

#! /bin/sh
gulp --gulpfile gulp-i18n-extract.js
git commit -m 'Update source strings' src/languages/en.lang.json

Обробка перекладів перед внесенням до сховища¶

Скористайтеся скриптом подання даних (commit) для автоматичного внесення змін до перекладу перед тим, як його буде внесено до сховища.

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

Журналювання діяльності додатків¶

Журнал діяльності додатків відстежує виконання додатків і може бути використаний для відстеження їхньої активності.

Each entry records whether processing is pending, successful, failed, or skipped. Skipped entries include the reason the add-on did not run, such as an incompatible component, no relevant changes, or a configured schedule that is not due yet. A successful entry can still mean that the add-on checked its inputs but found nothing to change.

For scope-wide add-ons that process components independently, the activity log contains a separate entry for each component.

Журнали можна вилучати через певний проміжок часу за допомогою налаштування ADDON_ACTIVITY_LOG_EXPIRY.

Додатки¶

Події, які запускають доповнення¶

Установка надбудови¶

Оновлення компонентів¶

Щодня¶

Зміна події¶

Ручний спусковий механізм¶

Репозиторій після додавання¶

Репозиторій після фіксації¶

Репозиторій post-push¶

Стан сховища після видалення¶

Постоновлення сховища¶

Попередня фіксація сховища¶

Попереднє натискання репозиторію¶

Попереднє оновлення сховища¶

Блок після збереження¶

Постсинхронізація блоку¶

Попереднє створення блоку¶

Вбудовані додатки¶

Автоматичний переклад¶

CDN локалізації JavaScript¶

CDN файлів перекладу¶

Вилучити порожні рядки¶

Очищення файлів перекладу¶

Додавання нових мов¶

Виявлення складників¶

Вимоги щодо розкриття інформації¶

Приклад із розв’язанням: news_<lang>.md¶

Приклади виявленння складників¶

Одна тека на мову¶

Компонування локалей Gettext¶

Складні назви файлів¶

Повторюваний код мови¶

Розділені рядки Android¶

Відповідність декільком шляхам¶

Повідомлення Fedora¶

Тема повідомлення¶

Текст повідомлення¶

Заголовки повідомлень¶

Приклади повідомлень¶

Масове редагування¶

Позначити незмінені переклади як «Потребує переробки»¶

Позначте нові рядки джерела як «Потребує перевірки»¶

Позначити нові переклади як «Потребує переробки»¶

Позначити оновлені переклади з репозиторія як «Потребує переписування»¶

Заповнити придатні лише для читання рядки початковими рядками¶

Генератор статистики¶

Заповнити переклади початковими рядками¶

Створення псевдолокалей¶

Перекладачі в коментарі¶

Оновити змінну ALL_LINGUAS у файлі «configure»¶

Налаштувати виведення gettext¶

Оновити шаблон gettext (Django)¶

Django requirements¶

Оновити файл LINGUAS¶

Оновити файл POT (Meson)¶

Meson requirements¶

Генерувати mo-файли¶

Оновити файли po, порівнявши із pot (msgmerge)¶

Оновити файл POT (Sphinx)¶

Sphinx requirements¶

Оновити файл POT (xgettext)¶

xgettext requirements¶

Сполучити Git подання¶

Налагодити виведення JSON¶

Скинути репозиторій до стану «upstream»¶

Форматувати файл властивостей Java¶

Видалення застарілого коментаря¶

Видалити застарілу пропозицію¶

Оновити файли RESX¶

Слак Вебхуки¶

Дієскрипт¶

Застарілі доповнення¶

Налагодити виведення XML¶

Налагодити виведення YAML¶

Загальні додаткові параметри¶

Рушії компʼютерного перекладу¶

Формат файлу¶

Події зміни для вмикання¶

Вибрані події зміни¶

Приклад із розв’язанням: `news_<lang>.md`¶