darktable user manual

Використання сценаріїв Lua

Table of Contents

#Огляд

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

Darktable постачається з низкою вбудованих сценаріїв. Основним засобом керування сценаріями є сервісний модуль Сценарії, доступний у режимі “Світловий стіл”. До виходу версії Darktable 5.6 скрипти потрібно було попередньо встановлювати.

Вичерпну документацію щодо написання сценаріїв на мові Lua в Darktable можна знайти в документації Lua для Darktable. Для детального ознайомлення із самою мовою Lua зверніться до довідкового посібника з Lua.

#Увімкнення сценаріїв

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

To use a supplied script, you first must enable it. In this example we will enable the script rename-images which will spawn a utility module in the lighttable.

  1. Переконайтеся, що сценарії ввімкнено в розділі Налаштування > Опції Lua.

  2. Identify in which folder the script you want to enable lives. An overview of all scripts is available in darktable’s lua documentation. In our example rename-images is contained in the folder contributed.

  3. Знайдіть модуль Сценарії у нижньому лівому куті режиму “Світловий стіл” і розгорніть його.

  4. Select the action: start/stop scripts from the dropdown.

  5. Under scripts select the appropriate folder from the dropdown (in our example contributed).

  6. Find the script you want to enable by using the arrows to flip through the pages. In our example, rename-images is (as of this writing) on the last page.

  7. Click the grayed-out start/stop icon to the left of the script’s name to start it. The icon should turn white and the script’s user interface (if it has one) will appear in a panel in the appropriate view. In this example, an additional utility module rename images will appear in the lighttable’s right panel.

#Використання власних сценаріїв

If you want to use custom scripts it is recommended to place them inside the configuration directory into lua/<name>/. Replace <name> with a string of your liking, e.g. user. darktable will pick up those folders and offer the included scripts to be enabled by selecting the corresponding folder within the scripts module. More information on how darktable loads scripts is availabe in the programmers guide.

#Встановлення та оновлення сценаріїв

Стосується лише версій Darktable до версії 5.6, де сценарії не були включені до комплекту поставки та їх потрібно було встановлювати, дотримуючись наступних інструкцій.

#Завантаження та встановлення

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

Darktable слід запустити хоча б один раз, щоб налаштувати каталоги. Каталоги конфігурацій для більшості типів встановлення перелічені на сторінці Каталог конфігурації.

Для більшості варіантів встановлення (пакет дистрибутива Linux, AppImage, Flatpak, macOS та Windows) сценарії Lua можна встановити з графічного інтерфейсу Darktable. Переконайтеся, що git встановлено у вашій системі. Якщо ні, скористайтеся менеджером пакетів для його встановлення.Потім, перебуваючи в режимі Світлового столу, розгорніть модуль встановлення сценаріїв Lua у лівому нижньому куті. Переконайтеся, що вибрано опцію “Встановлення сценаріїв” і встановіть їх. Перезапустіть Darktable, щоб модуль сценаріїв з’явився у лівому нижньому куті.

Деякі платформи потребують додаткових або альтернативних кроків:

Пакети Linux Snap

Встановлення через графічний інтерфейс Darktable наразі не працює, тому вам доведеться скористатися наступним підходом. Завантажте сценарії Lua за допомогою git, а потім створіть файл luarc, щоб Darktable міг завантажити менеджер скриптів. Закрийте Darktable, відкрийте термінал і виконайте наступне:

cd ~/snap/darktable/current
git clone https://github.com/darktable-org/lua-scripts.git lua
echo 'require "tools/script_manager"' >> luarc

Перезапустіть Darktable двічі, і модуль сценаріїв має з’явитися в лівому нижньому куті.

macOS

Як варіант, можна скористатися консоллю:

cd ~/.config/darktable/
git clone https://github.com/darktable-org/lua-scripts.git lua

Windows

Git можна отримати з git for windows або за допомогою менеджера пакетів Windows winget у командному рядку з командою winget install git.git. Якщо ви використовуєте дистрибутив gitforwindows.org, також встановіть Git Bash Shell, оскільки це допоможе у налагодженні сценаріїв, якщо це необхідно.

#Оновлення

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

Snap

cd ~/snap/darktable/current/lua
git pull

Flatpak

cd ~/.var/app/org.darktable.Darktable/config/darktable/lua
git pull

Linux і macOS

cd ~/.config/darktable/lua/
git pull

Windows

cd %LOCALAPPDATA%\darktable\lua
git pull

Translations