Obvious/ru

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

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

$ cd $XDG_CONFIG_HOME/awesome

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

$ git clone git@github.com:hoelzro/obvious.git

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

Добавление виджетов на рабочий стол
Итак, Вы загрузили репозиторий, теперь можно добавить виджеты. Перейдите в директорию с интересующим Вас виджетом и прочитайте прилагаемый файл 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, содержащий полное описание.