SnapFly(0.8)

ИМЯ
SnapFly - Легковесное GTK меню, которое можно запустить как в режиме 'демона' (при этом его можно будет вызвать в любом месте экрана под курсором мыши без значка в трее) так и в обычном режиме, со значком в системном лотке. Является форком проекта adeskmenu.

ОБЗОР
snapfly [ -v ] [ -c config_file ]

ОПЦИИ

-v  Показать номер версии и выйти.

-c config_file
    Использовать config_file как файл конфигурации.

РАСПОЛОЖЕНИЕ ФАЙЛОВ

Расположение конфигурационного файла
    Конфигурационный файл находится в директории ~/.config/snapfly и называется config.

Расположение файла пользовательского меню
    Файл пользовательского меню находится в директории ~/.config/snapfly и называется usermenu.

Расположение файла с черным списком пунктов меню
    "Черный список"(blacklist) пунктов меню может быть директорией или файлом, и распологается в ~/.config/snapfly/blacklist.

ФАЙЛ КОНФИГУРАЦИИ

Файл конфигурации имеет вид параметр=значение (между параметр, знаком равно и значением не должно быть пробелов). Если параметру задано недопустимое значение - он принимает значение по умолчанию. Строки, в начале которых стоит символ '#', являются комментариями.

terminal
    Задает эмулятор терминала, используемый при запуске программы. Значение: полный путь к эмулятору терминала.

systray
    Определяет, показывать значок в трее или нет. Значение: true или false.

rounded
    Уровень скругления углов окна. Если установить значение в 0, то прорисовка будет происходить гораздо быстрее. Значение: 0-255.

menu_width
    Задает ширину меню. Значение: любое положительное целое число.

bg_color
    Задает цвет фона меню. Значение: цвет в HTML формате (#0A0B0C).

border_color
    Задает цвет обрамления меню. Значение: цвет в HTML формате (#0A0B0C).

hide_list
    Скрывает пункты, специфичные для определенной DE. Значение: список, разделенный запятыми (GNOME,KDE,LXDE,ROX,Old). После последнего элемента списка запятая не ставится.

category_click
    Переходить в выбранную категорию при клике мышью на название категории, или переходить в выбранную категорию при наведении мыши на название категории. Значение: false (переключать категории по наведению мыши) или true (переключать категории по клику).

favorites
    В случае заданных переменных среды, таких как $BROWSER или $EMAIL_READER, они будут отображаться в категории Избранное. Значение: true или false. desktop_dirs Если переменная задана - то поиск .desktop файлов будет проводиться только в указанных директориях. Если переменная не задана - будет использоваться стандартный список директорий для поиска (/usr/share/applications/,$HOME/.local/share/applications/,/usr/local/share/applications/,/usr/share/applications/kde4/,/usr/local/share/applications/kde4/). Символ '~' заменяется на домашнюю директорию текущего пользователя. Значение: список директорий, разделённый запятыми.

ПОЛЬЗОВАТЕЛЬСКОЕ МЕНЮ

В SnapFly есть возможность добавлять свои категории и пункты меню. Файл пользовательского меню находится в ~/.config/snapfly/usermenu. Структура файла:

@Название_Категории##/путь/к/изображению/категории.png
    Эта строка создает новую категорию в меню. Сразу же после этой строки идут объявления пунктов этой категории. В файле пользовательского меню может быть объявлено неограниченное количество категорий.

/путь/к/программе/в/Название_Категории##/путь/к/изображению/пункта.png##Наименование Пункта##Описание Пункта
    Эта строка создает новый пункт в категории Название_Категории. После объявления категории может быть объявлено неограниченное число пунктов. Переменная $HOME заменяется на домашнюю директорию текущего пользователя.

Также, Вы можете добавлять свои пункты меню создавая .desktop файлы в директории ~/.local/share/applications/.

ЧЕРНЫЙ СПИСОК

Чёрный список, это список названий .desktop файлов, которые не должны отображаться в меню.

Для создания чёрного списка, необходимо знать имя .desktop файла приложения, эту информацию можно увидеть в эмуляторе терминала при запуске SnapFly в отладочном режиме.

~/.config/snapfly/blacklist
    Чёрный список, он может быть либо файлом, либо директорией.

В случае, если ~/.config/snapfly/blacklist является файлом, то имена .desktop файлов в нем должны перечисляться построчно.

В случае, если ~/.config/snapfly/blacklist/ - директория, то SnapFly не будет отображать те файлы или символьные ссылки, имена которых совпадают с .desktop файлами, находящимися в этой директории.

Если в системе установлен pyinotify, то при изменении чёрного списка можно не перезапускать snapfly.

ПЕРЕМЕННЫЕ ОКРУЖЕНИЯ

Когда определена переменная SNAPDEBUG, SnapFly будет выводить в stdout дополнительную информацию.

Пример запуска SnapFly в режиме отладки:

SNAPDEBUG= snapfly

БАГИ

Сообщать о всех найденных багах желательно сюда: http://code.google.com/p/snapfly/issues/list . Там же можно найти и список всех найденных багов.