Плазма/Створення пакунка загальної теми

From KDE Wiki Sandbox
This page is a translated version of the page Plasma/Create a Global Theme Package and the translation is 100% complete.
Other languages:

Як створити власний пакунок-оболонку

Спочатку вам слід встановити Навігатор темами вигляду Плазми, який є частиною пакунка plasma-sdk.

Навігатор темами вигляду Плазми є доволі простою програмою. На правій панелі програми розташовано три пункти:

  • Список встановлених тем вигляду у вашій системі, за допомогою якого ви можете вибрати тему і почати її безпосереднє редагування.
  • Відкрити теку тем — відкриває каталог, у якому зберігаються теми вигляду.
    /home/ваше_ім'я_користувача/.local/share/plasma/look-and-feel/
  • Нова тема, де ви зможете вказати усі параметри вашої теми, зокрема її назву, автора тощо. Вам слід заповнити усі поля, інакше ви не зможете скористатися кнопкою Гаразд. Після натискання кнопки Гаразд ви маєте побачити сповіщення Компонування Плазми успішно дубльовано.

Тепер ви можете вибрати вашу нову тему вигляду зі списку доступних тем і редагувати її у головному вікні програми.

  • Головне вікно
    Тут все майже зрозуміло. Ви можете редагувати ваш пакунок вигляду (назва, автор тощо). Ці параметри зберігаються до файла metadata.desktop у каталозі даних пакунка. Також ви зможете скористатися двома кнопками:
  • Компонування з поточних налаштувань Плазми
    Зберігає поточне компонування вашої стільниці, зокрема розташування панелей, аплети Плазми, фонове зображення тощо. Усі ці параметри зберігаються до:

    .local/share/plasma/look-and-feel/назва_вашої_теми/contents/layouts/org.kde.plasma.desktop-layout.js

    Це файл коду javascript, який виконується, коли ви позначаєте пункт «Використовувати компонування стільниці з теми» у модулі вигляду «Системних параметрів». Якщо у вашій темі вигляду компонування стільниці не змінюється, ви можете безпечно вилучити цей файл.

    Вміст файла Javascript повторно створюватиме налаштування Плазми, копіюючи вміст вашого поточного основного файла налаштувань Плазми: ~/.config/plasma-org.kde.plasma.desktop-appletsrc


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

  • Типові параметри з поточного налаштування
    Створює файл:
    .local/share/plasma/look-and-feel/назва_вашої_теми/contents/"default"
    Зберігаються такі параметри:
    • стиль віджетів
    • схема кольорів
    • піктограми
    • тема Плазми
    • тема вказівників
    • перемикач вікон
    • перемикач стільниць
    • декорації вікон.

Ви також можете додати зображення, яке буде використано для попереднього перегляду і яке зберігатиметься у теці .local/share/plasma/look-and-feel/назва_вашої_теми/contents/preview

Як додати залежності з KDE Store

Спочатку, вам слід додати рядок

X-KPackage-Dependencies=

до вашого файла metadata.desktop. Погляньом на цей приклад:

Схеми кольорів Плазми Elementary Luna

X-KPackage-Dependencies=kns://colorschemes.knsrc/api.kde-look.org/1001720

kns:// — назва протоколу

colorschemes.knsrc — тип ресурсу, який слід отримати (у нашому випадку це схема кольорів). Ось список доступних ресурсів у моїй системі (/etc/xdg):

  • aurorae.knsrc
  • cgcgtk3.knsrc
  • cgcicon.knsrc
  • cgctheme.knsrc
  • colorschemes.knsrc
  • comic.knsrc
  • discover_ktexteditor_codesnippets_core.knsrc
  • emoticons.knsrc
  • icons.knsrc
  • kfontinst.knsrc
  • ksysguard.knsrc
  • kwineffect.knsrc
  • kwinscripts.knsrc
  • kwinswitcher.knsrc
  • lookandfeel.knsrc
  • plasma-themes.knsrc
  • plasmoids.knsrc
  • sddmtheme.knsrc
  • servicemenu.knsrc
  • wallpaper.knsrc
  • xcursor.knsrc


api.kde-look.org/1001720 — адреса даних, що зберігаються на сервері. Здається, частина api.kde-look.org/ завжди залишається незмінною — змінюється лише ідентифікатор. Ідентифікатор можна звизначити з адреси у крамниці kde: для адреси https://store.kde.org/p/1001720 ідентифікатором буде 1001720.

Ви можете вказати декілька залежностей. Ось приклад з metadata.desktop United:

X-KPackage-Dependencies=kns://colorschemes.knsrc/api.kde-look.org/1001495,kns://plasma-themes.knsrc/api.kde-look.org/998797,kns://aurorae.knsrc/api.kde-look.org/1136954

У JSON:

X-KPackage-Dependencies: { "kns://colorschemes.knsrc/api.kde-look.org/1001495", "kns://plasma-themes.knsrc/api.kde-look.org/998797", "kns://aurorae.knsrc/api.kde-look.org/1136954" }

Встановити пакунок обгортки можна за допомогою команди, відданої з термінала:

kpackagetool5 -i "назва вашої теми"

Тему буде встановлено до .local/share/plasma/look-and-feel/

Буде встановлено залежності, вказані у metadata.desktop, отже ви зможете виконати тестування у вашій системі. Щоб ознайомитися із переліком параметрів, віддайте команду kpackagetool5 -h.

Загальносистемні залежності (експериментальне)

Загальносистемні залежності можна вказати з використанням схеми адрес AppStream. Докладніший опис можна знайти тут.

Щоб визначити ресурс, який слід шукати, ви можете виконати пошук у вашій системі за допомогою команди appstreamcli search <щось>

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