Главная страница

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

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

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

Текущие версии Awesome:

• Стабильная: awesome 3.4.3 (Engines).
• В разработке: Архивы с версиями, находящимися в разработке, можно скачать, используя git snapshots.
• Скриншоты: Screenshots

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

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

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

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

• Использование Xephyr
• Отладка

[edit] Переводы

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

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

Languages:

English  • Français  • Italiano  • Русский

[edit] Обзоры и новости

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

[edit] Панели и виджеты

• Виджеты в Awesome - Краткое руководство по созданию виджетов в Awesome.
• Виджеты Wicked - Как добавлять динамические виджеты, используя библиотеку wicked.
• Obvious - Как использовать репозиторий Obvious (виджеты, поддерживаемые сообществом).
• Виджеты от пользователей awesome
• Использование Cairo в Awesome
• Высота заголовков и панелей - Маленькое how-to, которое поможет настроить высоту заголовков окон и панелей.

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

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

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

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

[edit] Прочие советы

• Советы по irssi - Здесь можно найти несколько советов по использованию irssi в Awesome.
• Автозапуск - Маленькая функция для автоматического запуска программ в Awesome.
• Запуск или переключение - Запуск приложения или переключение на него, если оно уже запущено.
• Revelation - Реализация Mac OS X Exposé в Awesome.
• Gradient - Визуализация числовых данных (например, использования процессора).
• Проблемы с Java - Что делать, если Java-приложения отображаются в виде серых прямоугольников.
• Таблица экранов XRandR - Если Вам не нравится использовать числа для обозначения экрана.
• Перемещение курсора - Как убрать курсор мыши с центра экрана, если Вы пользуетесь только клавиатурой.
• Rotate Clients - Functions to rotate all visible clients to the next position and keep the focus in place.
• Dbus, naughty и файлы журналов - Показ цветных уведомлений об изменениях в журналах.
• Naughty log watcher - Реализация слежения за журналами средствами Awesome (без shell-скриптов и dbus).
• Использование Xephyr - Как запускать вложенные X-сессии - отличное решение для тестирования новых сборок Awesome или различных конфигурационных файлов.
• Использование нескольких экранов - Как настроить X для использования нескольких экранов/мониторов с Awesome.
• nm-applet - Как настроить автоматический запуск nm-applet в Awesome.
• Уведомления Mcabber - Классные уведомления для mcabber с использованием naughty.
• Выпадающий терминал - Выпадающий терминал наподобие Yakuake/Tilda на Вашем рабочем столе.
• Управление окнами в стиле WMII - имитация управления тегами, реализованного в WMII.
• Пользовательские приглашения (prompts)
  • SSH: prompt - Приглашение для подключения по SSH с автозавершением имён хостов, похожее на стандартное приглашение для запуска программ.
  • Улучшенное приглашение для выполнения кода Lua - Автозавершение и усовершенствованная функция eval.
  • Автозавершение для Wikipedia - Приглашение для поиска статьи в Wikipedia с автозавершением названий.
  • Geo Prompt - Приглашение для вычисления расстояния между двумя положениями.
  • Просмотр man-страниц - Приглашение для просмотра man-страниц в Вашем любимом приложении.
  • Web-поиск - Приглашение для поиска в сети Интернет, позволяющее использовать любую поисковую систему.
  • Калькулятор - Простое приглашение-калькулятор, использующее xmessage для вывода результатов.

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

Обычно Lua используется:

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

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

• awful - стандартная библиотека Awesome, написанная на Lua.
• awful.menu - библиотека, реализующая всплывающее меню.
• Beautiful - библиотека, реализующая поддержку тем.
• Wicked - библиотека динамических виджетов.
• Obvious - новая реализация библиотеки виджетов, созданная после Wicked.
• Space Invaders - позволяет играть в Space Invaders прямо в Awesome.
• Naughty - библиотека всплывающих уведомлений.
• Shifty - простая в настройке библиотека для динамического присваивания тегов приложениям.
• Rodentbane - библиотека для управления курсором мыши с клавиатуры.

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

• Настройка GTK-приложений - Как использовать темы без gnome-settings-daemon.
• Эмуляторы терминала - Эмуляторы терминала, не зависящие от окружения рабочего стола.
• Файловые менеджеры - Легковесные файловые менеджеры.
• Автомонтирование - Замена "gnome-volume-manager", "thunar-volman", и т.д.