(简体中文)

本维基页面旨在提供一份社区文档，尤其是帮助新用户配置awesome。与此同时我们也为老手提供也有用的信息，包括数个linux发行版下 awesome 的编译，调试等。

注意:为了避免有人蓄意散播无用信息，故约定在编辑本页前请先注册。因为对于那些人来说，注册帐号是一个令人生厌的事。

欢迎注册并为awesome文档做贡献。

当前 awesome 发行版:

• 稳定版: awesome 3.4.11 (Pickapart).
• 开发版: 请点击下载使用awesome开发版的压缩包 git snapshots.
• 快照: Screenshots

本版Awesome的配置和操控已经发生有所改变，并且在不久的未来可能继续变更。但下面的文档会尽量的适用所有当前的版本。如果你恰巧遇到它没有涵盖的请尽量的完善它们。同时如果你发现需要特殊的说明的细节问题也可以顺便补上； 还有一些文档可能只是针对awesome的某一个版本有效，你可以对它的文档进行扩展编辑。

安装 & 用户基础

• FAQ - 常见的问题集!
• Building awesome -编译安装awesome
• awesome 3 configuration -awesome 3 配置和基本的API接口
• awesome 2.X to 3.X -Awesome配置升级
• awesome 3.0 to 3.1 -3.0到3.1版中配置的改变
• awesome 3.3 to 3.4 -3.4版本中配置的改变
• Quickly Setting up Awesome with Gnome -在gnome-session中用awesome的命令
• KDE and awesome -KDE与Awesome
• awesome-menu basics -Awesome菜单入门
• My first awesome -新手入门参考

开发基础

• Using Xephyr -使用Xephyr测试wm
• Debugging -调试相关
• Signals

历史&新闻

• awesome 3 review on penguinsightings

你也可以加入我们的IRC频道 #awesome 在 OFTC.

Statusbars and widgets

• Widgets in awesome - Awesome中widgets组件应用简介。
• Vicious - Vicious动态插件库。
• Obvious - Obvious插件源（有社区支持）。
• User Contributed Widgets
• Using Cairo within Awesome 在Awesome中使用Cairo。
• Titlebar and Statusbar height - 状态栏和标题栏的设置。
• Bashets - 在widgets组件中添加Lua库并用它调用本地shell脚本。

awesome 主题

• Theming with Beautiful - Awesome中应用beautiful库美化主题。
• User Contributed Themes - 一些基于beautiful的awesome主题。
• Customizing Fonts - 为awesome添加新字体。
• Nice Icons - 为新组件件添加漂亮的图标。

用户配置文件

实例参考 配置文件.

更多小贴示

• Autostart - 在Awesome启动时设置自动运行启动的程序。
• Autostop -在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 -色彩渐变vs数字变化(显示cpu温度和利用率)
• Problems with Java -调整java应用程序的外观
• Symbolic tag names -为标签添加“另类”的符号标示
• XRandR Screen Table -不喜欢用数字标示屏幕的请进
• Move Mouse - 抛弃鼠标，吾乃键盘控。
• Dbus, naughty and logs -让你的日志文件色彩斑斓
• Naughty log watcher -日志监视模块（非shell，纯Lua脚本）
• Using Xephyr -运行嵌套的X-server：为疯狂测试不同品质WindowsManager而生
• Using Multiple Screens -让你的awesome支持多屏幕，多显示器显示。
• nm-applet -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.
• Video wallpaper - 动态视频背景
• Transparency -xcompmgr：灰常给力的半透明效果
• Coverart display - Display Cover Art for current mpd song.
• Urxvt tips -urxvt-unicode配置文件小贴士。
• Irssi tips - Irssi使用小贴士。
• IM tips -使用即时聊天程序的注意事项。
• Remove icons - How to remove icons from the tasklist and show only current client.
• Custom Prompts - Customized prompts you can use with awful's prompt.
• Using dmenu - Use dmenu(with wmii colourscheme) instead of the default run prompt.
• Using dmenu to switch - 使用dmenu切换窗口
• Shutdown dialog -交互式关机，重启，挂机，锁屏对话框。
• Tree File Menu - Python一个树式文件菜单
• Cycling Random Wallpaper Or Xscreensaver - 随机图片背景与屏保。
• Blinking text - Blinking the text on textbox widget
• RPN Calculator - RPN calculator

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.

常用功能如下：

• 应用程序的配置文件.
• 独立运行的脚本语言.
• 作为嵌入式语言即时整程序的运行行为.

若有人对Lua有兴趣，请参阅文本教程。同时作为建议，请不妨阅读一下Lua简短参引。Awesome的框架就是采用Lua语言扩展构建的。下面是Lua在Awesome中的具体应用:

• awful - Awesome的标准库文件.
• awful.menu - 弹出菜单库
• Beautiful - 主题相关库
• Obvious - 基于Wicked而来的较新的插件组合
• Vicious - 模块化的插件，来自Wicked的分支
• Space Invaders - 在Awesome中玩“太空入侵者”小游戏
• Naughty - 弹出式提示栏
• Shifty - dynamic tagging library with advanced client matching and sane configuration
• Eminent - effortless wmii-style dynamic tagging library that does not require any rc.lua changes
• Rodentbane - a library for rapid control of the mouse cursor using just the keyboard

现在的许多朋友更倾向工作与相对完整的桌面环境，在这部分所包括多种链接，这些链接能在不同的程度上能丰富Awesome的功能，能让Awesome在轻量高效的窗口管理器和功能成熟的桌面环境（如KDE和GNOME）间游刃有余。

• Customizing GTK Apps - 不装gnome-settings-daemon也能用GTK主题.
• Terminals - 不同的终端，不同的享受.
• File Managers - 独立的文件管理器.
• Automounting - "gnome-volume-manager", "thunar-volman", 等自动挂载的相关内容
• Xscreensaver - 屏保的设定