Rodentbane/ru

Rodentbane является реализацией keynav в модуле Lua для Awesome. Он позволяет оперативно управлять курсором мыши исользуя для этого клавиатуру, и может значительно ускорить вашу производительность. Он может использоваться в ситуациях когда не хватает обычных сочетаний клавиатуры оконного менеджера и приложения, а вам необходимо использовать события мыши (нажатие клавиши). (На вскидку можно придумать flash объекты на веб странице) Он не предназначен для полноценной замены мышы, для этого вам потребуется установить клавиатурные сочетания и использовать программы которые поддерживают полный контроль над клавиатурой (такие как Awesome).

Arch Linux
Если вы используете Arch Linux, PKGBUILD уже доступен через aur, скачайте его здесь: http://aur.archlinux.org/packages.php?ID=26406

PLD Linux
Если вы испозуете PLD Linux, установите awesome-plugin-rodentbane используя poldek: poldek -i awesome-plugin-rodentbane

Ручная установка
Если вы используете другие операционные системы или желаете установить библиотеку вручную, вы можете скачать ее из git репозитория здесь.

Установите его следующим образом: git clone git://git.glacicle.com/awesome/rodentbane.git sudo cp rodentbane/rodentbane.lua /usr/share/awesome/lib/

Основы использования
Для того чтобы использовать rodentbane, вам нужно всего лишь добавить require("rodentbane") в начало вашего конфигурационного файла rc.lua. Послпе этого вы можете вызвать rodentbane.start любымо удобным для вас сочетанием клавиш, и вас сразу будет доступен rodentbane с дефолтной клавиатурной конфигурацией.


 * Примечание: В данный момент, rodentbane требует наличия пакетов xdotool или xte (обычно находится в пакете "xautomation") для имитации щелчка мыши. Он будет использовать тот, который обраружит в системе.

Способы работы с Rodentbane
После вызова rodentbane.start, все клавиши перехватываются и вы переходите в "rodentbane mode". В этом режиме, вы можете использовать только клавиши, которые установили для rodentbane. Несколько линий рисуется на экране, разделяя его на 4 части. Вы можете использовать определенные клавиши для разделения области пополам горизонтально или вертикально, после чего вы можете симулировать щелчок в центре (теперь уже уменьшенной) области, или разделить ее пополам еще раз. Вы можете также переместить выбранную область в любом направлении. Это значит, что вы можете найти нужное место для нажатия (в худшем случае) по логарифмическому значению времени.

Сочетания клавиш по умолчанию
h              Разделить влево j              Разделить вниз k              Разделить вверх l              Разделить вправо

Shift+h        Переместить область влево Shift+j        Переместить область вниз Shift+k        Переместить область вверх Shift+l        Переместить область вправо

u              Отменить последнюю операцию разделения или перемещения Space          Нажатие в центре области Mod1+Space     Двойной щелчок в центре области Control+Space  Нажатие средней кнопки мыши в центре области Shift+Space    Нажатие правой кнопки мыши в центре области Return         Only warp the cursor the the spot in the center of the area

Нажатие любой клавиши не завершает работу в режиме rodentbane.

Пользовательские клавиатурные сочетания
Вы можете определить свои собственные клавиши вызвав функцию rodentbane.bind похожим образом вы определяете обычные клавиши в Awesome.

Для вызова функции используйте: rodentbane.bind(modkeys, key, func)

With modkeys as the table of modkeys that should be pressed, key as a string keysym for the key to be pressed, and func for the function to be called when it is pressed.

Например, для добавления щелчка левой клавиши мыши привяжем сочетание control+h: rodentbane.bind({"Control"}, "h", function   rodentbane.warp -- Place the cursor in the center of the active area    rodentbane.click(1) -- Click button 1 (left)    rodentbane.stop -- Leave rodentbane mode end)


 * Примечание: После того, как вы определить пользовательское сочетание клавиш, стандартное больше не будет работать. Если вы хотите использовать совместно стандартные и пользовательские клавиши, добавьте вызов rodentbane.binddefault в ваш rc.lua.

Внешний вид Rodentbane
Вы можете использовать beautiful для изменения настройки внешнего вида rodentbane. По умолчанию, Rodentbane использует ваши цвета beautiful.border_focus как цвет разделительных линий и использует толщину линии 2. Вы можете переопределить их настроив beautiful.rodentbane_bg и beautiful.rodentbane_width соответсвенно.

Функции Rodentbane
Это справка по всем значимым функциям представленным в rodentbane.


 * rodentbane.start([screen, recall])

Запускает "rodentbane mode". Screen это экран на котором будет запущен Rodentbane, по умолчанию это текущий экран. Если recall = true, будет вызывана область которая использовалась последний раз.


 * rodentbane.stop

Завершает "rodentbane mode", ничего не делает.


 * rodentbane.cut(dir)

Разделяет текущую область по направлениям. Может принимать одно из следующих значени {"up", "right", "down", "left"}.


 * rodentbane.move(dir[, ratio=0.5])

Перемещает текущую область в заданном направлении. Может принимать одно из следующих значений {"up", "right", "down", "left"}. Ratio определяет на сколько перемещать, ratio = 0.5 (по умолчанию) переместит область на половину его размера, ration = 2 переместит ее на 2 размера.


 * rodentbane.warp

Warps курсор по центру активной области.


 * rodentbane.click([button=1])

Симулирует щелчок мыши в текущей позиции курсора.


 * rodentbane.undo

Undo the last operation that changed the active area.


 * rodentbane.binddefault

Связывает все сочетания клавиш по умолчанию. Она автоматически вызывается если не будут определены пользовательские привязки клавиш при время первом вызове start.


 * rodentbane.bind(modkeys, key, func)

Присваивает клавиши для "rodentbane mode".