LatteDock/FAQ/uk

←Панель Латте

Що таке панель Латте? З чого розпочався проект?

Панель Латте — панель на основі бібліотек Плазми, безпосередній наступник панелі Now. Латте є результатом об'єднаних зусиль розробників панелі Now та панелі Candil.

Як додати кнопки запуску?

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

Підказка: ви можете додати їх поза межами ділянки керуванян задачами, але це спричинить проблеми із анімацієї для розмірів <64 пікселів та надмірного споживання пам'яті.

Як додати аплети?

Клацніть правою кнопкою миші на стільниці Плазми, виберіть Додати віджети. З панелі навігації списком віджетів Плазми перетягніть і скиньте будь-який потрібний вам віджет на вашу панель Латте.

Як увімкнути режим редагування у Латте?

У режимі редагування користувач може вилучати аплети, перевпорядковувати їх і отримувати доступ до додаткових параметрів у різних областях. Щоб увімкнути його, слід просто викликати вікно параметрів Латте.

Як пересувати або вилучати аплети?

You should go to Edit Mode (when the settings window is shown) and then you can drag any applet you want to be placed elsewhere. You can also remove it while under "Edit Mode" by right clicking on it or by pressing the [X] button in the tooltip above the applet.

Чи можна вимкнути параболічний ефект для певного аплета?

You should go to Edit Mode (when the settings window is shown) and hover afterwards the specific applet. Its tooltip contains a lock icon that will disable parabolic effect for that applet when clicked.

My launcher and its window are not associated correctly OR my launcher is using a low-resolution icon?

That issue means that plasma libtaskmanager has not associated your launcher and app windows correctly to the relevant desktop file. Plasma is trying to be smart enough in order to correctly identify which desktop files are associated to which specific windows, but there are cases when it fails. Best way to solve this is to check the StartupWMClass record in the desktop file. This record should point at the proper WM_CLASS record at all times. For example even though the Latte Dock desktop file is called org.kde.latte-dock.desktop, its StartupWMClass is lattedock. In order to correctly identify the StartupWMClass of an application, you can use xprop.

Приклад:

1. Віддайте команду xprop у консолі
2. Клацніть на вікні, яким ви цікавитеся
3. Знайдіть наприкінці виведених до консолі даних запис WM_CLASS(STRING) =
4. Додайте раніше згаданий запис до файла desktop програми у полі StartupWMClass

For instance, with "Gimp 2.10", even though its desktop file is called gimp.desktop, its StartupWMClass is "gimp-2.10". StartupWMClass is not needed to be added for "Gimp" since plasma developers have taken special care to map it properly through /etc/xdg/taskmanagerrulesrc.

How Latte Dock (auto)starts and why is a widget provided?

Latte starts from the menu; there is no need to place the widget on your desktop. It is there for testing purposes. Automatic start can be enabled through Settings Window -> Tweaks.

Джерелом натхнення слугувала якась інша панель? Яке місце займає панель Латте серед інших панелей?

Latte Dock has an architecture inspired and based on Plasmashell, but we also took some inspiration from Plank, e.g.: its Visibility modes.

Яку технологію і мову програмування використано?

Latte is mostly written in Qt/QML and C++14, but this project would not be possible without KDE Frameworks 5.

Гаразд, ви переконали мене спробувати! Як встановити панель і які у неї залежності?

You can download the sources, install the required dependencies and build Latte. Please read README and INSTALLATION. But if you have any problems or doubts, you can ask the development team.

Which distributions have packages for it, so that I can install it through the package manager?

Please read at the bottom of Latte Dock's Main Page the Repositories section.

Why is the displayed window not smooth after the launcher's bouncing animation?

Try the following steps:

1. Відкрийте сторінку Системні параметри -> Програми -> Супровід запуску -> (вимкніть анімацію) Керування задачами
2. If the problem persists, then your application desktop file might be missing the "StartupWMClass" record. In Inkscape's case, that would be: StartupWMClass=inkscape. You can use the xprop application in order to identify its correct value.

Якими є базові параметри налаштовування?

Latte is highly configurable. We invite you to explore and configure latte to your liking from the config window. 👍 But some special features are: Visibility, Zoom Effect and Add widgets/plasmoids from KDE Plasma.

Where are the configuration(s) stored?

Be careful! It is recommended to make a backup of those if you want to keep the original configurations.

cat ~/.config/lattedock-appletsrc

cat ~/.config/lattedockrc

Inside ~/.config/lattedock-appletsrc I see several things. Can you explain a little the idea behind those?

Config is organized based on Containments (e.g. [Containments][1]). Each of those have a number to distinguish one from the other, and each one also has different blocks of options. That's where "applets" come into play and each "Containment" has its applets (usually one - [Containments][1][Applets][2]). So it goes like:

[Containments][NumberOfContainment][Applets][NumberOf_Applet]

Now, applet-2 may be a series of launchers, a Plasma Widget, anything. Each and every applet also has multiple blocks of configuration. A block might be used for generic "applet" configuration (e.g. [Containments][1][Applets][2]) or some more specific options (e.g. [Containments][1][Applets][2][Configuration][General]).

As you can tell, we can't document everything about those numerous options here, but here is the deal: You can tweak every applet separately, you can change the order applets appear with appletOrder=No_of_Applet;No_of_Another, under [Containments][1][General]* , you can manually change the iconSize at the same block, if you want shadows, what the zoomLevel must be, etc. A sample is provided here so you can see it for yourself.

• You see, it contains all the other applets and you tweak it under general options.

Чи є якісь параметри налаштування для досвідчених користувачів, які ніколи не варто чіпати?

None is forbiden, as long as you take frequent backups of your configuration. Use cron or similar software to automate the procedure and place them in an safe place.

Як увімкнути загальні клавіатурні скорочення Латте?

У більшості випадків вам слід перейти до сторінки Системні параметри -> Загальні скорочення -> Панель Латте і увімкніть потрібні вами клавіатурні скорочення.

• Super + цифра: активувати завдання
• Super + Ctrl + цифра: новий екземпляр завдання
• Super + `: показати приховану панель

Чи можна скористатися клавішею Super (Windows) для відкриття засобу запуску програм?

Спочатку переконайтеся, що Панель Латте закрито.

Варіант 1

Звичайно ж, можна, але доведеться додати до вашого файла ~/.config/kwinrc такий код:

[ModifierOnlyShortcuts]
Meta=org.kde.lattedock,/Latte,org.kde.LatteDock,activateLauncherMenu

Потім перезавантажте KWin за допомогою такої команди:

qdbus org.kde.KWin /KWin reconfigure

Варіант 2

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

kwriteconfig5 --file ~/.config/kwinrc --group ModifierOnlyShortcuts --key Meta "org.kde.lattedock,/Latte,org.kde.LatteDock,activateLauncherMenu"
qdbus org.kde.KWin /KWin reconfigure

Латте 0.8 вимикає Максимізовані вікна без рамки у плазмоїді керування активним вікном. Що робити?

Latte v0.8 supports BorderLess Maximized Windows per layout simultaneously. In order for this to work it had to support that feature internally. You can try the following:

1. Disable BorderLess Maximized Windows from Active Window Control
2. Go to Latte Settings -> Layouts -> Choose tab (Preferences) and enable Support borderless maximized windows in different layouts
3. Return to your layouts and a new column called Borderless must have been added, add a check mark in that column for the layout you want that feature and click Apply

Оце тобі... Латте не запускається. Чи є якийсь зразок налаштувань, за яким можна відновити роботу панелі?

You have been told to take backups. Unfortunatelly unless you post your configuration to get help, little can be done now; just `killall -9 latte-dock`, delete your configuration and restart Latte in order to reconfigure it. A configuration exists [here](http://pastebin.ca/3772307) but it's most likely useless to you.

Чи можна скоригувати параметри, зокрема відстань панелі від краю екрана?

You can minimize the distance, but not directly tweak it. Go to Latte Setting -> Tweaks and select Shrink thickness margins

Чи є якісь попередньо завантажені компонування для Латте 0.6?

In Latte v0.7 the layouts have been added by default in Appearance page. For previous v0.6 the users can use Preloaded Layouts file, that contains four of the most used layouts (Default, Unity, Plasma, Favourite)

Чи можна змінити піктограму засобу запуску або його параметри команди?

Ви можете налаштувати це у середовищі Плазми і скористатися перетягуванням зі скиданням на панель Латте.

Чи можна перевпорякувати невідповіним чином розташовані кнопки запуску та аплети за допомогою файлів налаштувань?

If you misplaced a launcher (or a whole applet), open ~/.config/lattedock-appletsrc. Search your launcher and decide where you want to place it. Cut

;file:///usr/share/applications/myapp.desktop

(yes, the semicolon too) and paste it after the launcher - and its semicolon - you wish. Be very careful; Only the last launcher doesn't need a semicolor afterwards! So if you are copying your launcher between two others, you have to make sure that both before and after your launcher, a semicolon exists. Let's see an example; let's say you need to copy `transmission-qt` launcher:

..;file:///usr/share/applications/kchmviewer.desktop;file:transmission-qt;file:....

If what you want to reposition is a whole applet, rather than a launcher in an applet, you will find `appletOrder` very usefull. Just note your applet's number and change the order in which applets are written in the previously mentioned option. Have I mentioned to keep a backup before you edit? I did now.

What effects does Latte Dock provide? Can launchers rotate, shake or dim when clicked?

Latte only has the zoom effect and the shadows, but we are very concerned about delivering an excellent user experience.

Як вимкнути усі ефекти, щоб із піктограмами не відбувалося нічого після натискання?

Анімації можна вимкнути за допомогою вибору значення Вікно налаштувань Латте -> Вигляд -> Анімації -> Немає

Кнопки запуску зникають до того, як буде показано відповідне вікно, хоча так не повинно бути. Що робити?

Так, знаємо. Але таку поведінку регламентовано libtaskmanager Плазми. Докладніше про це: вада у Латте 72, звіт щодо вади у KDE.

I set Animations to None, but when clicking on an launcher its icon is momentarily disappeared.

This bug is already fixed in current master and will be included in the next (0.6.0) release. So all you have to do is git pull the latest changes of master, or wait for the next stable version if you like so.

Деякі аплети на панелі показано надто малими, починаючи з Плазми 5.10, як це виправити?

In Plasma 5.10, the plasma developers decided that the applets in the panels should have a maximum size that they shouldnt overcome. You can change this at plasma systemsettings-> Icons -> Advanced -> Panel -> set a size of 256px.

My left dock behaves strangely from Plasma 5.10 and beyond, can I fix this?

In Plasma 5.10, the kwin developers introduced the gestures functionality for touch screens which is enabled by default for all systems. You can disable it through plasma systemsettings -> Workspace Behavior -> Touchscreen. Relogin your plasma session if the change doesnt take effect immediately.

Звіт щодо вади у KWin Звіт щодо вади у Плазмі

Поки усе працює добре, але майбутнє за Wayland. Що чути про це?

Ми плануємо реалізувати підтримку у Плазмі 5.10, зараз працюємо над експериментальною підтримкою.

Коли було реалізовано підтримку Wayland, чи буде вилучено з панелі Латте автоматичну залежність від X11?

It's still a long way off for Wayland to replace X11, but it's possible to build Latte without dependencies X11, however we are still working on supporting Wayland.

На час написання цієї сторінки, які проблеми з Qt 5.8?

If you are brave enough to mess with technical details, you may want to look here and here

Чи можна наказати панелі Латте запускатися лише у сеансі Плазми?

Так, це можна зробити. Виконайте такі настанови:

1. Перейдіть на сторінку програми Системні параметри Плазми -> Запуск і вихід -> Автозапуск
2. Виберіть Панель Латте у списку програм
3. Додатково -> Автоматичний запуск лише у Плазмі

Чи якість завади або потенційні проблеми, про які мені слід знати?

Software as everything else in life, isn't perfect; we constantly try to make a better software and you can help us out with this by reporting every possilbe problem you may find. To answer the question though, there isn't a bug serious enough to prevent you from trying Latte Dock.

Чи є у авторів програми якісь сподівання та побажання щодо можливостей самої Плазми?

The most important feature needed from KWin in wayland is the distrors to provide access at kwayland's priviliged apis (and/or) for the users, a confirmation from them that Latte requests such apis

Як часто будуть випускатися нові версії? Які ваші плани?

The first priority to release a stable version is for all the needed features to have been implemented and no major crashes to appear. So we try to keep the schedule but on the other hand it will be ready when it is ready.

Я не маю ніякого досвіду, але хочу допомогти. Що робити?

As we write this F.A.Q. much help is needed to make Latte stable with multiscreen setups. You could clone the `multiscreens` branch and report back any issues. Also normal bug reports, reports about problems with specific Plasma or Qt versions, strange desktop behavior or even wishes about new features are all welcome :-)

Вмію програмувати. Що можу зробити?

First step is to know what you are after and then to `fork` this repo; after that you can hunt bugs, add new features - or make more stable those already existing. Discuss your changes and if they are good and reasonable enough, we are more than happy for your pull request.

Як встановити прогарму з поточної гілки master?

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

git clone https://github.com/psifidotos/Latte-Dock.git`
cd Latte-Dock
sh install.sh

Для виконання останньої команди, безпосередньо перед встановленням, доведеться ввести пароль root.

Як встановити програму з певної гілки?

Якщо ви хочете виконати тестування якихось можливостей, яких немає у гілці master, ви можете отримати гілку, яку вам хочеться встановити. Припустімо, вам потрібна гілка multi2:

git clone https://github.com/psifidotos/Latte-Dock.git`
cd Latte-Dock
git pull
git branch multi2
git checkout multi2
git pull origin multi2

Зберіть у звичайному режимі.

Мною додано аплет, але його показано без тіні, не так як інші піктограми

Well, if an applet (or more) hasn't a shadow, you should either double-check that option All is set under Latte Settings -> Appearance

Що трапиться, якщо перетягнути і скинути пункти файлів на кнопки запуску?

Файл буде передано із параметром до відповідної програми зі створенням її нового екземпляра (наприклад, передавання зображення до Kolourpaint призведе до відкриття цього зображення у Kolourpaint)

Чи є якісь відомі проблеми із сумісністю з певними драйверами до відеокарток?

If you have Intel Graphics and experiment problems with the rendering e.g. pixelated graphics, corrupt text, etc, you can try changing the rendering method 2D from SNA to UXA.

/etc/X11/xorg.conf.d/20-intel.conf

section     "Device"
Identifier  "Intel Graphics"
Driver      "intel"
Option      "AccelMethod"  "uxa"
EndSection

My Dock don't show anymore when i activate the auto-hide or the dodge window feature

Apparently some features from plasma can hinder the dock's ability to show itself when touching the screen border. Plasma 5.10 added the option to execute actions on swiping over a border on a touch screen. You can find this option in the system preferences under: Desktop behavior -> Touch screen. If you have your dock on the same border a touch gesture is activated the dock may not be able to show itself. Try deactivating the gesture on that border, then close and restart your session and check if the problem was fixed. (#676)