Додатки

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

Підказка

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

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

../_images/addons.webp

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

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

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

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

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

  • Рядки змінюються в репозиторії.

  • Додається рядок.

  • Додано новий переклад.

Щодня

Запускається щодня, але доповнення зазвичай розподіляють щоденне навантаження між компонентами залежно від 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 }}

Нетипова група відповідності на основі формального виразу

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

../_images/addon-discovery.webp

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

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

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

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

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

(?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 broker URL

The AMQP broker URL to connect to.

publish_timeout

Publish timeout

How many seconds to wait for the broker delivery acknowledgement.

connection_attempts

Connection attempts

How many times to try connecting to the broker.

retry_delay

Retry delay

How many seconds to wait between connection attempts.

ca_cert

CA certificate bundle (PEM)

Paste only PEM certificate blocks, each starting with «—–BEGIN CERTIFICATE—–» and ending with «—–END CERTIFICATE—–«.

client_key

Client private key (PEM)

Paste a single unencrypted PEM private key block. Encrypted private keys are not supported.

client_cert

Client certificate (PEM)

Paste only the PEM certificate block starting with «—–BEGIN CERTIFICATE—–»; do not paste the output from «openssl x509 -text».

event_filter

Change events to trigger

Choose which change events should trigger this add-on. Change events to trigger

events

Selected change events

Selected change events
Перемикачі:

Зміна події

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

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

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

All messages have topic weblate.<action>.<project>.<category...>.<component>.<translation>. The action is lowercase textual representation of action with underscores instead of space, for example resource_updated; see Selected change events 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.
Перемикачі:

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

Оновлює шаблон 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.

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.

preset

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

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

Доступні варіанти:

glib

„GLib
Перемикачі:

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

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

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.

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.

filter_mode

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

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

Доступні варіанти:

none

Немає

weblate_docs

Документації Weblate
Перемикачі:

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

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

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.

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.

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.

input_mode

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

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

Доступні варіанти:

patterns

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

potfiles

Маніфест POTFILES

language

xgettext: мова

Programming language passed to xgettext, for example Python or C. Leave blank to let xgettext guess the language from file extensions.

source_patterns

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

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

potfiles_path

Шлях до POTFILES

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

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

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

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.

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

Change events to trigger

Choose which change events should trigger this add-on. Change events to trigger

events

Selected change events

Selected change 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

Change events to trigger

Choose which change events should trigger this add-on. Change events to trigger

events

Selected change events

Selected change events
Перемикачі:

Зміна події

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

The request payload complies with the Weblate Messaging schema. The action field uses the action name listed in Selected change events. 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

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

Change events to trigger

Доступні варіанти:

content

Translation content events

all

All change events

custom

Selected change events

Selected change events

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

Сховища об’єднано

21

repository_rebased

Зміни зі сховища перенесено

22

repository_merge_failed

Не вдалося об’єднати сховища

23

repository_rebase_failed

Не вдалося перенести зміни зі сховища

24

parsing_failed

Не вдалося обробити дані

25

translation_removed

Переклад вилучено

26

suggestion_removed

Вилучено пропозицію

27

translation_replaced

Переклад замінено

28

repository_push_failed

Не вдалося записати зміни до сховища

29

suggestion_removed_during_cleanup

Вилучено пропозицію під час очищення

30

source_string_changed

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

31

string_added

Додано рядок

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

Отримано сповіщення щодо сховища

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

Не вдалося зберегти рядок

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

Remote repository updated

102

remote_repository_update_failed

Remote repository update failed

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

Список додатків налаштовується 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) для автоматичного внесення змін до перекладу перед тим, як його буде внесено до сховища.

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

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

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

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