Accueil

Le but de ce wiki est de fournir une documentation créée par la communauté, surtout pour aider les nouveaux utilisateurs à configurer awesome. Nous proposons également des informations de développement, notamment des tutoriels pour installer awesome sur de nombreuses distributions, des tutoriels de débogage, etc.

Pour bien commencer, nous vous proposons de lire cette page : débuter avec awesome

Remarque : pour éviter les spammers, vous devez créer un compte pour modifier les pages. Créer un compte pour éditer est ennuyeux, mais le spam aussi.

N’hésitez pas à vous enregistrer et à contribuer dans cette documentation.

Dernières versions d’awesome :

• Ancienne stable : awesome 2.3.6, obsolète.
• Stable : awesome 3.4.3 (Engines).
• Développement : sous forme d’archives sur notre serveur git.

Une liste de thèmes et captures d’écran est disponible si vous souhaitez voir à quoi peut ressembler awesome.

La configuration et les contrôles d’awesome ont changé entre les versions majeures et pourraient bien encore évoluer dans les prochaines. Certains des documents suivants essaient de décrire toutes les versions existantes. Vous êtes invités à les modifier si une version manque d’explications. De même, certains peuvent être relatifs à une version précise d’awesome. Nous vous invitons à les modifier si les informations qu’ils proposent correspondent à une version qui n’est pas mentionnée.

[edit] Utilisateurs : installation et bases

• Foire aux questions : commencez par là si vous avez des problèmes !
• Installer awesome : une liste d’instructions pour compiler ou installer awesome.
• Configuration d'awesome 3 : trouvez de l’aide pour comprendre la configuration d’awesome 3 et les bases de l’interface de programmation.
• Qu’est-ce qui a changé lors du passage de la version 3.3 à la 3.4 ?
• Options de configuration qui ont changé entre les versions 3.0 et 3.1 d’awesome
• Convertisseur de configuration pour awesome 2.x vers 3.x
• Mettre en place awesome avec KDE
• Mettre en place awesome avec Gnome : quelques commandes pour dire à gnome d’utiliser awesome
• Personnaliser les applications GTK : utiliser des thèmes sans avoir recours à gnome-settings-daemon
• Pages de manuel
• Bases d’awesome-menu pour awesome 2

[edit] Développement : bases

• Utiliser Xephyr
• Debogage

[edit] Traductions

Des morceaux de cette documentation ont déjà été traduits en plusieurs langues. Les documents traduits peuvent contenir des informations supplémentaires concernant des langues étrangères ou d’autres pays.

Par défaut, la plupart des pages sont rédigées en anglais. Si des traductions sont disponibles, une barre est affichée en haut. Voici un exemple pour la Foire aux questions :

Languages:

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

[edit] Critiques et informations

• awesome 3 sur DLFP
• awesome 3 sur penguinsightings

[edit] Barres de statut et widgets

• Widgets dans awesome : un court guide sur l’implémentation de widgets dans awesome.
• Widgets avec wicked : comment ajouter des widgets dynamiques à l’aide de la bibliothèque wicked.
• Obvious : comment ajouter le dépôt obvious, lequel fournit un support communautaire de wigdets.
• Widgets proposés par les utilisateurs
• Utiliser Cairo dans awesome
• Hauteurs des barres de statut et de titre : petit tutoriel pour vous aider à personnaliser les hauteurs des barres de statut et de titre.

[edit] Changer l’apparence d’awesome

• Changer l’apparence avec beautiful : changer l’apparence d’awesome 3 avec la bibliothèque beautiful.
• Thèmes proposés par des utilisateurs : nombreux thèmes awesome à utiliser avec beautiful.
• Fontes personnalisées : comment ajouter de nouvelles fontes à votre système.
• Jolies icônes : où trouver de jolies icônes pour vos widgets.

[edit] Fichiers de configuration d’utilisateurs

Des exemples de fichiers de configuration d’autres utilisateurs sont disponibles.

[edit] Autres astuces

• Astuces irssi : page à voir pour des astuces sur irssi.
• Démarrage automatique : petite fonction fournissant une fonction de démarrage automatique pour awesome.
• Lancer ou mettre au premier plan : lancer un client, ou le mettre au premier plan s’il tourne déjà.
• Revelation : implémentation de « Exposé » de Mac OS X dans awesome.
• Gradient : retour visuel sur des données numériques, par exemple l’utilisation du processeur.
• Problèmes avec Java : que faire si vos applications Java sont grises.
• Tableau d’écrans XRandR : si vous n’aimez pas utiliser des nombres pour vos écrans.
• Dépalcer la souris : déplacer la souris du centre de l’écran, pour travailler sans souris.
• Faire tourner les clients : fonctions pour tourner entre les clients visibles et garder le focus en place.
• Dbus, naughty et journaux : afficher des notifications colorées de vos journaux.
• Visionneur de journaux naughty : implémentation native sans script de console et sans dbus.
• Utiliser Xephyr : comment lancer des sessions X embarquées, pour tester par exemple des nouvelles versions d’awesome ou des fichiers de configuration différents.
• Multi-écran : comment configurer X pour utiliser awesome avec plusieurs écrans ou moniteurs.
• Network Manager : Comment configuer le lancement automatique de nm-applet dans awesome.
• Notifications Mcabber : notifications sympas de mcabber en utilisant naughty.
• Console tombante : activer une console tombant du haut de l’écran comme dans les jeux vidéos, du même genre que Yakuake ou Tilda.
• Gestion des onglets à la wmii
• Invites de commande personnalisées : invites de commande fournies par des utilisateurs
  • Invite SSH : invite ssh en barre de statut similaire à l’invite « Run: » avec complétion des noms d’hôte.
  • Invite Lua améliorée : complétion et évaluation plus utile de l’invite Lua.
  • Invite Wikipédia : invite Wikipedia avec complétion du nom d’article.
  • Invite géographique : invite pour calculer la distance entre deux endroits.
  • Invite « pages de manuel » : invite pour lire les pages de manuel dans votre application préférée.
  • Invite de recherche Internet : invite pour chercher sur Internet, donnant accès à n’importe quel formulaire de recherche.

Description du langage Lua :

« Lua is a fast, light-weight, embeddable scripting language. 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. »

Exemples d’utilisations courantes de Lua :

• Langage de configuration pour des applications ;
• Langage scripté auto suffisant ;
• An embedded language in applications to modify runtime behaviour.

Pour vous familiariser avec Lua, nous invitons les nouveaux utilisateurs de ce langage à lire ce tutoriel. Vous pouvez également regarder du côté de cette courte référence Lua. Le système awesome est conçu avec Lua en tant que langage d’extension. Parmi ces extensions, on trouve :

• awful : la bibliothèque Lua standard d’awesome ;
• awful.menu : bibliothèque de menu popup ;
• beautiful : bibliothèque de thèmes d’apparence ;
• wicked : bibliothèque de widgets dynamiques ;
• obvious : une nouvelle bibliothèque implémentant des widgets, plus récente que wicked ;
• Space Invaders : vous permet de jouer à Space Invaders dans awesome ;
• naughty : bibliothèque de notification sous forme de popup ;
• shifty : bibliothèque d’onglets dynamiques et de configuration avancée des clients ;
• rodentbane : bibliothèque de contrôle rapide du pointeur de sourie en utilisant simplement votre clavier.

De nos jours, la plupart des gens sont habitués à avoir un système de bureau un peu plus complet. Cette section propose des liens vers des applications qui sont légères et utiles, permettant à awesome de combler les fossés entre un simple gestionnaire de fenêtres et un environnement de bureau complet comme KDE ou Gnome :

• Consoles virtuelles : remplaçants pour les consoles virtuelles de bureau ;
• Gestionnaires de fichiers : gestionnaires de fichiers légers et auto suffisants ;
• Montage automatique des volumes : remplaçant de gnome-volume-manager ou autre thunar-volman.