首页

本维基的目标是提供一份由社区自助的文档，尤其是帮助新用户使用和配置 awesome。我们在这里也有开发人员感兴趣的内容，包括如何编译 awesome (若干相关的分发行版)、如何调试、等等。

注意: 由于垃圾信息制造者 (spammers) 的存在，您必须先创建一个账号然后才能编辑页面。非要创建一个账号才能编辑虽然很麻烦，但是这样能有效避免垃圾信息。

请您放心的注册账号，帮助我们完善文档。

当前 awesome 版本列表:

• 稳定: awesome 3.4.
• 开发: awesome 开发版本的档案包可以从这里下载 git snapshots.
• 截图: 截图

Configuration and control of awesome have changed between major versions and may as well continue to evolve in future ones. 下列文档中的某些可能适用于所有版本。但如果其中某些只针对一个特定版本的文档遗漏了相应的版本号，请指正它们。

安装 & 基础

• 常见问题 - 如果您有问题，请先浏览这里。
• 编译 Awesome - 介绍了如何编译 / 安装 awesome。
• Awesome 3 配置文件 - 帮您理解 awesome 3 的配置文件和基础 API。
• awesome 2.X to 3.X Awesome 配置文件格式转换器 (只限于 2.x 升级至 3.x)
• awesome 3.0 to 3.1 升级过程中需要注意的配置文件的变化。
• awesome 3.3 to 3.4 升级过程中需要注意的配置文件的变化。
• GNOME 和 Awesome - 怎样通过一组命令让 awesome 和您的 gnome 会话协同工作。
• KDE 和 Awesome
• man pages
• awesome-menu basics

开发的基础

• Using Xephyr
• Debugging

翻译

一部分文档已经被翻译成不同的语言。被翻译的文档中可以包含和本国语言相关的附加信息。

如果某个页面被翻译过，在它的上方会显示一条可用的语言列表。例如常见问题页面中的可用语言列表:

Languages:

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

评论 & 新闻

• awesome 3 review on penguinsightings

状态栏和零件

• Widgets in awesome - 在 awesome 中安装和使用零件的指南。
• Vicious - 如何使用 vicious 开发库添加动态零件。
• Obvious - 如何使用 Obvious 仓库 (由社区支持)。
• User Contributed Widgets
• Using Cairo within Awesome
• Titlebar and Statusbar height - 如何调节状态栏和标题栏高度。
• Bashets - 让您将 shell 脚本作为零件内容的提供者。

主题

• Theming with Beautiful - 如何通过 beautiful 开发库设置您 Awesome-3 的主题。
• User Contributed Themes - 若干采用 beautiful 的 Awesome 主题。
• Customizing Fonts - 如何向您的系统添加新字体。
• Nice Icons - 在哪里能找到用于您的零件的漂亮图标。

用户配置文件

用户配置文件的示例在这里。

其他技巧

• irssi tips - 在 awesome 里使用 irssi 的一些技巧。
• Autostart - Small function providing autostart functionality for awesome.
• Run or raise - Run a client, or pop to it if it is already running.
• Revelation - Implementing Mac OS X Exposé in awesome.
• Gradient - Visual feedback on numerical data (e.g. processor usage).
• Problems with Java - What to do if your java apps look grey.
• XRandR Screen Table - If you don't like using numbers for screens.
• Move Mouse - Move the mouse from the centre of the screen for mouseless working.
• Dbus, naughty and logs - Display colorized notifications of your logs.
• Naughty log watcher - Native implementation (no shell scripts/dbus required).
• Using Xephyr - How to run nested X sessions - good for testing new builds of awesome or different config files.
• Using Multiple Screens - How to setup X with multiple screens/monitors for use with awesome.
• nm-applet - How to setup nm-applet to start automatically in awesome.
• Mcabber notifications - Cool notifications for mcabber via naughty
• Drop-down terminal - Toggle a video game-like console on the top of your screen like Yakuake/Tilda.
• Scratchpad manager - Basic scratchpad manager for the awesome window manager.
• WMII-like tag management - mimic WMII's way of tag managment
• urxvt tips - See here for some awesome urxvt tips.
• Custom Prompts - User contributed run prompts
  • SSH: prompt - Statusbar ssh prompt similar to Run: prompt with hostname completion.
  • Improving the Lua prompt - Completion and a more useful eval for the Lua prompt.
  • Wikipedia Completion - Wikipedia prompt with article completion.
  • Geo Prompt - Prompt for calculating the distance between two locations.
  • Manual Pages Prompt - Prompt for reading manual pages in your favorite application.
  • Web Search Prompt - Prompt for searching the web, giving you acess to any search form.
  • Calculator Prompt - Simple calculator prompt utilizing xmessage to display results.
  • Identi.ca Prompt - Post dents/tweets directly from the wm.

LUA程序设计语言是一个简洁、轻量、可扩展的脚本语言。Lua combines simple procedural syntax with powerful data description constructs based on associative arrays and extensible semantics. Lua is dynamically typed, runs by interpreting bytecode for a register-based virtual machine, and has automatic memory management with incremental garbage collection, making it ideal for configuration, scripting, and rapid prototyping.

Common uses of Lua are:

• A configuration language for applications.
• A standalone scripting language.
• An embedded language in applications to modify runtime behaviour.

To get introduced into Lua, please read this tutorial for the newcomers to the language. As a suggestion, please consider to get this Lua Short Reference. The Awesome framework is build with Lua as the extension language. Some of all extensions can be see below:

• awful - the standard awesome Lua library.
• awful.menu - a popup menu library.
• Beautiful - a theming library.
• Obvious - a new implementation of a widget library made since Wicked.
• Vicious - a modular widget library derived from Wicked.
• Space Invaders - allows you to play Space Invaders with Awesome
• Naughty - a popup notification library
• Shifty - dynamic tagging library with advanced client matching and sane configuration
• Rodentbane - a library for rapid control of the mouse cursor using just the keyboard

Most people these days are used to having a more complete desktop. This section includes links to various apps that are lightweight and useful from within awesome to fill the gaps between just a window manager and a full-blown desktop environment like KDE or GNOME.

• Customizing GTK Apps - How to use themes without gnome-settings-daemon.
• Terminals - Replacements for desktop environment terminals.
• File Managers - Lightweight stand-alone File Managers.
• Automounting - A replacement for "gnome-volume-manager", "thunar-volman", etc.