Obvious/es

El repositorio Obvious tiene una serie de widgets para tu desktop que proveen información útil. Es un proyecto independiente que tiene el apoyo de la comunidad.

Obteniendo Obvious

Primero ve a tu directorio awesome en XDG_CONFIG_HOME

$ cd $XDG_CONFIG_HOME/awesome

Después clona el repositorio en este lugar.

$ git clone git://git.mercenariesguild.net/obvious.git

Puedes ver que widgets estan disponibles revisando las carpetar en el directorio obvious.

Agregando widgets al escritorio

Ya que tienes el repositorio es momento de agregar los widgets que quieres. Ve al directorio al que estas interesado y lee el readme que esta ahí. Esto explicará como agregar ese widget en particular. Generalmente es muy facil y generalmente sigue los siguientes pasos.

   * "require" el modulo hasta arriba de tu rc.lua.
   * Configurar algunas opciones del módulo.
   * Agregar el widget a la lista de widgets de tu wibox.
   * Agrega los bindings. 

Muchas veces, las configuraciones/bindings/ no son necesarias, así que solo dos líneas valen la pena cambiar. Ejemplo (el control volumen):

   * require("obvious.volume_alsa") -- Cargar el módulo
   * obvious.volume_alsa.setchannel("Master") -- Configurar el módulo
   * obvious.volume_alsa(), -- Agregar el volumen a mis widgets list
   * awful.key({ modkey }, "m", obvious.volume_alsa.mute), -- Agregar un bind para el widget 

Escribiendo nuevos módulos

Siente libre de escribir un módulo de obvious si crees que hace falta, ya sea para ti o para la comunidad awesome. Envialos a awesome-devel@naquadah.org. Revisa la API Documentation para ver de que funciones puedes echar mano