Obvious

Репозиторий Obvious - это набор виджетов для Awesome, выводящих различную полезную информацию. Это независимый проект, поддерживаемый сообществом.

Получение репозитория Obvious

Для начала перейдите в каталог awesome, находящийся в XDG_CONFIG_HOME (обычно это ~/.config).

$ cd $XDG_CONFIG_HOME/awesome

Затем скопируйте репозиторий:

$ git clone git://git.mercenariesguild.net/obvious.git

Теперь можно узнать, какие виджеты доступны, перейдя в каталог obvious и посмотрев список директорий в нём. Также список виджетов доступен по ссылке The Mercenaries Guild.

Добавление виджетов на рабочий стол

Итак, Вы загрузили репозиторий, теперь можно добавить виджеты. Перейдите в директорию с интересующим Вас виджетом и прочитайте прилагаемый файл readme. Из него Вы узнаете об особенностях реализации виджета. Как правило, добавление виджета - довольно простая процедура, состоящая из нескольких шагов:

• Добавить в начало Вашего rc.lua вызов "require" с именем нужного модуля.
• Настроить некоторые параметры модуля.
• Добавить виджет в список wibox'а.
• Добавить сочетания клавиш для управления виджетом.

В большинстве случаев настройка параметров и сочетаний клавиш не требуется, поэтому всё, что нужно - изменить две строчки. Пример (управление громкостью):

• require("obvious.volume_alsa") -- Загрузка модуля
• obvious.volume_alsa.setchannel("Master") -- Настройка модуля
• obvious.volume_alsa(), -- Добавьте это в список виджетов
• awful.key({ modkey }, "m", obvious.volume_alsa.mute), -- Добавление сочетания клавиш

Написание новых модулей

Если у Вас есть отличная идея и Вы хотите реализовать её, не стесняйтесь написать модуль obvious и отправить его на awesome-devel@naquadah.org. Вы должны быть подписаны на этот список рассылки. Ознакомьтесь с документацией по API для получения информации о функциях, которые Вы можете использовать в модулях. Также посмотрите файл "CONTRIBUTING" в исходном коде obvious, содержащий полное описание.