Main Page/ru



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

Замечание: Из-за наплыва спамеров для редактирования страниц необходимо создать учетную запись. Хотя это требование может показаться раздражающим, спам раздражает не в меньшей степени.

Не стесняйтесь регистрироваться и вносить свой вклад в документацию.

Текущие версии Awesome:
 * Стабильная: awesome.
 * В разработке: Архивы с версиями, находящимися в разработке, можно скачать, используя git snapshots.
 * Скриншоты: Скриншоты

Документация
Настройки Awesome изменялись между основными версиями и в дальнейшем могут развиваться. Некоторые из приведенных документов пытаются охватить все существующие версии. Пожалуйста, внесите исправления, если для какой-то из них требуются дополнительные объяснения. Другие документы могут относиться только к определённой версии Awesome. Пожалуйста, исправьте их, если версия не указана.

Установка и базовая настройка

 * Awesome 3.x - Manpage и клавиатурные сочетания.
 * Часто задаваемые вопросы - Если возникли какие-то проблемы, для начала посмотрите здесь!
 * Сборка Awesome - Инструкции по сборке / установке Awesome.
 * Настройка Awesome 3 - Помощь по настройке Awesome 3 и основам API.
 * acc - Конвертирование конфигурационного файла Awesome 2.X в Awesome 3.X.
 * Переход с 3.0 на 3.1 - Параметры конфигурации, изменившиеся между версиями.
 * Переход с 3.3 на 3.4 - Изменения в версии 3.4.
 * Переход с 3.4 на 3.5 - Изменения в версии 3.5
 * Быстрая настройка Awesome в Gnome - Как использовать Awesome внутри сессии gnome с помощью нескольких команд.
 * KDE и Awesome
 * Мой первый awesome

Разбираем Awesome

 * Layout- схемы, пояснения
 * Теги - Описание и настройка тегов
 * Панель задач - Описание и настройка панели задач
 * Использование D-Bus - Использование D-Bus для взаимодействия со скриптами и приложениями
 * Известные проблемы

Основы разработки

 * Использование Xephyr
 * Отладка
 * Сигналы

Переводы
Некоторые части документации были переведены на различные языки. Переведённые документы могут содержать дополнительную информацию, относящуюся к языку или странам.

ЗАМЕЧАНИЕ: После ознакомления со страницей перевода, рекомендуется ознакомится с англоязычным оригиналом, т.к. с момента перевода в него могут быть внесены изменения, и часть статьи или кода может устареть.

Если для страницы доступен перевод, в её верхней части отображается врезка. Вот пример со страницы Часто задаваемые вопросы:

Обзоры и новости

 * обзор Awesome 3 на сайте penguinsightings
 * Awesome: ещё один шаг к идеальному wm

Также Вы можете присоединится к нашему IRC каналу #awesome на OFTC.

Русскоязычные сообщества

 * Одноклассники
 * Контакт
 * LOR - linux.org.ru
 * Habrahabr - Статьи по Awesome на хабре

Панели и виджеты

 * Виджеты от пользователей awesome - English
 * Widget_Layouts - схемы для виджетов
 * Виджеты в Awesome - Краткое руководство по созданию виджетов в Awesome.
 * Vicious - Как добавлять динамические виджеты, используя библиотеку vicious.
 * Виджеты Wicked - Как добавлять динамические виджеты, используя библиотеку wicked. Библиотека считается устаревшей, сейчас используется Vicious.
 * Obvious - Как использовать репозиторий Obvious (виджеты, поддерживаемые сообществом).
 * Использование Cairo в Awesome
 * Высота заголовков и панелей - Маленькое how-to, которое поможет настроить высоту заголовков окон и панелей.
 * Bashets - Маленькая библиотека Lua, облегчающая использование ваших shell скриптов и передачу данных из них вашим виджетам.
 * Автоскрытие launcher - Автоматическое скрытие лаунчера при запуске приложения.
 * Lain - Расширяет возможности настройки и удобства использования.

Использование тем

 * Темы от пользователей Awesome - Несколько тем Awesome для использования с библиотекой beautiful.
 * Темы от пользователей Awesome - English
 * Темы Beautiful - Как настроить тему Вашего Awesome-3 при помощи библиотеки beautiful.
 * Настройка шрифтов - Как добавить новые шрифты в систему.
 * Значки - Где найти хорошие значки для Ваших виджетов.
 * Picturesque - Автоматическая смена обоев. В данный момент не работает, требуется переработка.

Пользовательские конфигурационные файлы

 * Примеры конфигурационных файлов пользователей Awesome можно найти здесь.
 * Примеры других конфигурационные файлы. - English
 * awesome-copycats

Прочие советы

 * Автозапуск - Маленькая функция для автоматического запуска программ в Awesome.
 * Autostop - Простой метод выполнения программ при завершении awesome.
 * Раскладка клавиатуры - виджет раскладки клавиатуры с использованием kbdd и D-Bus
 * Разбираем правила(rules) - Описывается awful.rules - способы настройки и управления окнами.
 * Обои "Изображение дня NASA" - Использования "Изображение дня NASA" как обоев (требуется feh)
 * Запуск или переключение - Запуск приложения или переключение на него, если оно уже запущено.
 * Revelation - Реализация Mac OS X Exposé в Awesome.
 * Документирование клавиатурных сочетаний - Добавляем документацию для каждого сочетания клавиш и отображаем его в панели помощи
 * Клавиатурные сочетания и цифровая клавиатура - Использование цифровой клавиатуры для переключения тегов и отображения связнных с ними меню
 * Градиент - Визуализация числовых данных (например, использования процессора).
 * Проблемы с Java - Что делать, если Java-приложения отображаются в виде серых прямоугольников.
 * Символические названия тегов - Изменения названия тегов на мистический символический вид.
 * Таблица экранов XRandR - Если Вам не нравится использовать числа для обозначения экрана.
 * Перемещение курсора - Как убрать курсор мыши с центра экрана, если Вы пользуетесь только клавиатурой.
 * Dbus, naughty и логи - Показ цветных уведомлений об изменениях в журналах.
 * Наблюдатель логов Naughty - Реализация слежения за журналами средствами Awesome (без shell-скриптов и dbus).
 * Использование Xephyr - Как запускать вложенные X-сессии - отличное решение для тестирования новых сборок Awesome или различных конфигурационных файлов.
 * Redshift - Интеграция Redshift с Awesome для регулировки цветовой температуры экрана.
 * Nm-applet - Как настроить автоматический запуск nm-applet в Awesome.
 * Уведомления Mcabber - Классные уведомления для mcabber с использованием naughty.
 * Выпадающий терминал - Выпадающий терминал наподобие Yakuake/Tilda на Вашем рабочем столе.
 * Scratchpad manager - Менеджер scratchpad для оконного менеджера Awesome.
 * Управление тегами в стиле WMII - имитация управления тегами, реализованного в WMII.
 * Видеообои - Воспроизведение видео в качестве фонового рисунка, используя mplayer.
 * Прозрачность - Прозрачные окна, используя xcompmgr.
 * Minitray - Позовляет включать и выключать отображение трея.
 * Отображение обложки песни - Отображение обложки для текущей песни при использовании mpd.
 * Советы Urxvt - Советы по использованию rxvt-unicode в awesome.
 * Советы по irssi - Здесь можно найти несколько советов по использованию irssi в Awesome.
 * Советы по использованию месенджеров - Здесь собраны советы по использованию различных IM в Awesome.
 * Удаление иконок - Как удалить иконки из списка задач, оставив только текущее приложение.
 * Использование dmenu - Использование цветовых схем, интегрирование в beautiful, и Run or Raise.
 * Запуск команд в фоне - Запуск shell скриптов в фоне (без загрузки awesome!) и возвратом результата.
 * Диалог выключения - Простой диалог для выключения/перезагузки/спящего режима/блокировки экрана.
 * Меню "Файловое дерево" - Скрипт для создания меню файлового дерева.
 * Случайные обои или Скринсейвер - Периодическая замена фона или запуск Xscreensaver через определенный промежуток.
 * Мигающий текст - Реализация мигающего текста на текстовом виджете.
 * RPN калькулятор - калькулято RPN (Reverse Polish Notation)
 * "Модальные" сочетания клавиш - Настройка действия клавиш в зависимости от режима
 * Улучшаем рендеринг шрифтов
 * Глобальное отключение уведомлений запуска - Если вас раздражает заторможенный/занятый курсор мыши.
 * Сохранение мультитегового состояния - Позволяет вам запомнить мультитеговое отображение, и переключаться между тегами с сохранением этого состояния.
 * Панель Conky - Конфигурация Conky в стиле строки состояния, которая не перекрывается окнами
 * Conky HUD - Неперекрываемая конфигурая для Conky
 * Обход плагинов перехватывающих клавиатурный ввод - Это известный баг/особенность, существующий в Firefox более 10 лет.
 * Отображение информации MPD с помощью mpdcron - позволяет вывести информацию о треке используя mpdcron
 * Autostart with consolekit - Использование меню awesome для restart/shutdown/hibernate/suspend вашего компьютера.
 * Vmware - Awesome и приложение vmware
 * Отображение/скрытие системного трея - Как добавить сочетание клавиш для переключения видимости системного трея.
 * Перевод текста - позволяет перевести выделенный текст.
 * Справочная информация - позволяет выводить всплывающее уведомление с подсказкой.
 * Отключаем DPMS - отключаем авто отключение экрана для полноэкранных приложений

Пользовательские приглашения (prompts)

 * Custom Prompts - Английская версия всех пользовательских приглашений
 * SSH: prompt - Приглашение для подключения по SSH с автозавершением имён хостов, похожее на стандартное приглашение для запуска программ.
 * Улучшенное приглашение Lua prompt - Автозавершение и усовершенствованная функция eval.
 * Автозавершение для Wikipedia - Приглашение для поиска статьи в Wikipedia с автозавершением названий.
 * Geo Prompt - Приглашение для вычисления расстояния между двумя положениями.
 * Просмотр man-страниц - Приглашение для просмотра man-страниц в Вашем любимом приложении.
 * Web-поиск - Приглашение для поиска в сети Интернет, позволяющее использовать любую поисковую систему.
 * Калькулятор - Простое приглашение-калькулятор, использующее xmessage/Naughty для вывода результатов.
 * Identi.ca Prompt - Отправка твитов непосредственно из WM.
 * Запуск в терминале используя ключевое слово - Строка запуска позволяет испльзовать ":" для запуска команды в терминале.
 * Запуск команды в терминалеl - Mod-Shift-r служит для выполения команды в терминале
 * Перевод текста - Использование Google Translate для перевода текста.

Работа с несколькими экранами (screens)

 * Использование нескольких экранов - Как настроить X для использования нескольких экранов в Awesome.
 * Fullscreens на несколько экранов - Как растянуть приложение на несколько экранов/мониторов
 * Объединение тегов - описывается реализация объединения тегов с разных экранов в единую систему
 * Переключение окна на другое рабочее пространстов - Функция переключения окна на соседний экран, влево или вправо.
 * Перемещение приложения на другой монитор - Как перенести приложение экран влево или вправо при использовании 2х и более экранов.
 * Перемещение приложения на заданный монитор - Как переместить приложение на заданный экран (если их более 2х).
 * Передача фокуса на определенный экран - Как передать курсор/фокус ввода на заданный монитор.
 * Libreoffice Multi-monitor - Настройка Libreoffice для корректной работы с несколькими мониторами.

Расширения Lua
Lua - это быстрый, легковесный, встраиваемый скриптовый язык. Lua сочетает простой процедурный синтаксис с мощными конструкциями для описания данных, основанными на ассоциативных массивах, и расширяемой семантикой. Lua имеет динамическую типизацию и автоматическое управление памятью с помощью инкрементного сборщика мусора; программы на Lua компилируются в байт-код, исполняемый на регистровой виртуальной машине. Всё это делает Lua идеальным для использования в конфигурационных файлах программ, скриптах и для быстрого создания прототипов.

Обычно Lua используется:
 * В качестве языка для настройки приложений.
 * Как отдельный скриптовый язык.
 * Как язык, встраиваемый в приложения для управления ими во время выполнения.

Для того, чтобы начать изучение Lua прочтите краткое введение в Lua. Для более глубокого изучения с Lua прочитайте это руководство для начинающих. Также советуем почитать Краткое руководство по Lua. Также есть руководство на русском, но только по версии 5.1 и очень краткое руководство для тех кто знает другие языки программирования и хочет узнать, что такое Lua Lua за 60минут. Awesome использует Lua в качестве языка для расширения функциональности. Ниже перечислены некоторые из доступных расширений:


 * awful - стандартная библиотека Awesome, написанная на Lua.
 * awfu.rules - библиотека реализующая правила работы с клиентами
 * awful.menu - библиотека, реализующая всплывающее меню.
 * Beautiful - библиотека, реализующая поддержку тем.
 * Wicked - библиотека динамических виджетов. Считается устаревшей.
 * Obvious - новая реализация библиотеки виджетов, созданная после Wicked.
 * Vicious - Модульная библиотека виджетов, происходящая от Wicked.
 * Bashets - Маленькая библиотека Lua, облегчающая использование ваших shell скриптов и передачу данных из них вашим виджетам.
 * Space Invaders - позволяет играть в Space Invaders прямо в Awesome.
 * Naughty - библиотека всплывающих уведомлений.
 * Rodentbane - библиотека для управления курсором мыши с клавиатуры.
 * Collision - Мощный клавиатурно-ориентированный модуль навигации и изменения размеров с визуальной индикацией и обратной связью
 * Radical - Мощная и расширяемя система меню
 * Flaw - Объектно-ориентированная библиотека для управления виджетами.
 * Couth - еще одна библиотека расширений -- включающая всплывающие(popup) уведомления для alsa и mpd.
 * Keychains - Использование связки клавиш в awesome
 * Hints - Оконные подсказки для фокусировки на окне
 * Vain - Альтернативная система схем(layout)
 * Lain - Расширяет возможности настройки и удобства использования, является наследником Vain, для версии Awesome 3.5
 * Blingbling - Красивый набор виджетов, основанный на Cairo
 * ezconfig - Клавиатурные сочетания в стиле Emacs для Awesome (например  вместо  )
 * cheeky - Простой type-ahead переключатель окон (использующий родные меню приложений)
 * keyjoy - Изменение свойств мыши и клавиатуры для отдельного приложения используя правила.
 * Динамические теги
 * Shifty - простая в настройке библиотека для динамического присваивания тегов приложениям.
 * Tyrannical - Конфигурационная система для awful определяющая динамические теги и приложения(духовный наследник Shifty)
 * Eminent - Легкая библиотека динамических тегов(wmii подобная), не требующая каких либо изменений в rc.lua

Дополнительно
На сегодняшний день большинство людей привыкли к более полным рабочим столам. Этот раздел включает ссылки на различные легковесные и полезные приложения, которые можно запускать в Awesome, чтобы уменьшить разрыв между простым оконным менеджером и полнофункциональным окружением, таким как KDE или GNOME.


 * Настройка GTK-приложений - Как использовать темы без gnome-settings-daemon.
 * Эмуляторы терминала - Эмуляторы терминала, не зависящие от окружения рабочего стола.
 * Файловые менеджеры - Легковесные файловые менеджеры.
 * Автомонтирование - Замена "gnome-volume-manager", "thunar-volman", и т.д.
 * Блокировка экана - замена для gnome-screensaver, и прочих.
 * Календари - Календари и решения для повестки дня (текстовые, графические, интерактивные, ...)
 * Управление питанием - Замена gnome-power-manager или kpowersave