Розділ 7. Створення скриптів для Lokalize

Перелік функцій Lokalize можна розширити за допомогою скриптів, написаних декількома інтерпретованими мовами програмування, зокрема Python і JavaScript. Скрипти, зазвичай, вбудовуються до графічного інтерфейсу Lokalize як пункти меню (для яких ви можете призначити клавіатурне скорочення). Розташування і назва пункту меню для скрипту визначається у супутньому файлі .rc. Під час кожного запуску Lokalize програма шукає у теці ТЕКА_ПРОЕКТУ/lokalize-scripts файли .rc і додає їх до файла кешу, який зберігається за адресою ТЕКА_ПРОЕКТУ/lokalize-scripts/scripts.rc (отже, зазвичай, цей файл не потрібно додавати до сховища системи керування версіями). Крім того, у файлах RC містяться шляхи до скриптів, які можна вказувати відносно теки файла .rc або системної теки скриптів (програма перевірить обидва шляхи). Насправді, ці шляхи мають бути відносними, якщо ви маєте намір використовувати файл .rc спільно з іншими учасниками перекладу. Отже, ви, наприклад, можете вказати ../../scripts/lokalize/opensrc.py, щоб програма завантажила скрипт з загальної теки скриптів kf5-l10n (тобто теки, яка не є специфічною для вашої мови).

Приклади файлів .rc можна знайти у теці, куди встановлено Lokalize (зазвичай, /usr/share/lokalize/scripts/) і у сховищі KDE. За цією адресою ви можете знайти додаткові приклади скриптів, зокрема заснований на JavaScript check-gui.js — скрипт, який запускається у автоматичному режимі під час кожного зберігання файла (цього можна досягти за допомогою особливого параметра у файлі .rc). Якщо ви знайомі з Python або JavaScript, його код буде для вас очевидним.

Нижче наведено посилання на документацію API. Всі пункти, позначені записом Q_SCRIPTABLE, можна використовувати у скриптах.