L'icône rouge permet de télécharger chaque page du wiki visitée au format PDF et la grise au format ODT →

Différences

Ci-dessous, les différences entre deux révisions de la page.

--- doc:environnements:x11:dwm [18/01/2015 17:25]
sogalpunx
+++ doc:environnements:x11:dwm [08/02/2015 04:54]
martinux_qc [Introduction]
@@ Ligne 12: / Ligne 12: @@
 ===== Introduction =====
 Voici la très bonne et très officielle présentation de dwm, disponible sur son site: http://dwm.suckless.org
 dwm est un gestionnaire de fenêtres dynamique pour X. Il gère les fenêtres selon 3 agencements différents: \\
   * tuilage : les fenêtres sont réparties entre une zone principale et une zone d'empilement. La zone principale contient la fenêtre dans laquelle vous travaillez, la zone d'empilement contenant les autres;
@@ Ligne 17: / Ligne 18: @@
   * flottant : dans cet agencement les fenêtres peuvent être redimensionnées et déplacées librement, c'est le comportement que l'on retrouve dans la plupart des autres gestionnaires et environnements de bureaux (XFCE, LXDE, etc...).
-Notes : les fenêtres de dialogues sont toujours en mode flottant. De plus, dwm est bien un gestionnaire de fenêtres, il ne leur apporte aucune décoration, ni bordure avec titres et boutons "Fermer", "Maximiser" ou "Réduire".
+Notes : les fenêtres de dialogue sont toujours en mode flottant. De plus, dwm est bien un gestionnaire de fenêtres, il ne leur apporte aucune décoration, ni bordure avec titres et boutons "Fermer", "Maximiser" ou "Réduire".
 dwm (et l'ensemble des outils du projet suckless.org) adhère à une philosophie minimaliste (voir http://suckless.org/philosophy). Il est écrit en C et sa configuration se fait dans un fichier écrit en C avant compilation. Cela peut paraître contraignant mais apporte une grande stabilité et la garantie que des options incompatibles ou erronées n'ont pas été indiquées (sans quoi une erreur empêcherait la compilation).
@@ Ligne 61: / Ligne 62: @@
 <code>patch -p1 < ../dwm-azertykey.diff</code>
 Ce qui devrait vous renvoyer une confirmation de succès:
-<code>
+<code diff>
 patching file config.def.h
 Hunk #1 succeeded at 68 (offset 3 lines).
@@ Ligne 67: / Ligne 68: @@
 </code>
 Nous allons pouvoir passer à la configuration, voici une version commentée en français du config.def.h :
-<code fichier>
+<code C>
 /* See LICENSE file for copyright and license details. */
@@ Ligne 194: / Ligne 195: @@
 Ceci permet une utilisation interactive, vous autorisant notamment à changer le numéro de version pour un code de version personnel et permet de créer un paquet .deb de votre version personnalisé de dwm.\\
-Une fois installé, vous pouvez le tester en sélectionnant la session adéquate dans votre gestionnaire de session (gdm3, kdm, slim...) ou en ajoutant la ligne:
+<note important>Lors de la première compilation, un fichier config.h est créé à partir du config.def.h. C'est ce config.h qui est pris en compte véritablement, pensez donc par la suite, soit à le modifier directement, soit à modifier le config.def.h puis, juste avant la compilation, à le copier sous le nom config.h.</note>
-<code fichier>exec /usr/local/bin/dwm</code>
+Une fois installé, vous pouvez le tester en sélectionnant la session adéquate dans votre gestionnaire de session (gdm3, kdm, slim...) ou en ajoutant la ligne:\\
+<code bash>exec /usr/local/bin/dwm</code>
 à votre fichier ~/.xinitrc.\\
 ===== Utilisation =====
+=== Comprendre la notion de tag (étiquettes): ===
-- fonctionnement des tags
+dwm ne fonctionne pas sur le modèle des espaces de travail, mais sur le principe des étiquettes (tags) que vous attribuez à une ou plusieurs fenêtre(s). C'est par exemple ce que vous faites de façon statique dans le config.def.h, mais cela peut être fait de façon dynamique. Ainsi la combinaison de touche [Shift+MODKEY+é] attribuera le 2ème tag à la fenêtre active. Vous pouvez sélectionner les tags grâce à la combinaison MODKEY+touche_correspondante. Pour reprendre notre exemple, si vous faites MODKEY+é vous sélectionnez toutes les fenêtres ayant le tag "é" et retrouvez donc celle précédemment étiquettée.
-- raccourcis clavier
+Le fonctionnement des tags est détaillé de fort belle manière ici: [[http://yeuxdelibad.net/Logiciel-libre/Suckless/dwm/index.html#etiquettes|dwm, chez thuban]].\\
-- utilisation souris
+=== Liste des raccourcis clavier : ===
-===== Astuces =====
+  * MODKEY+Shift+Entrée : ouvre un émulateur de terminal;
+  * MODKEY+b : affiche/cache la barre des tags;
+  * MODKEY+t : passer en agencement tuilage (tiling);
+  * MODKEY+f : passer en agencement flottant;
+  * MODKEY+m : passer en agencement monocle, la fenêtre principale est maximisée;
+  * MODKEY+space : passe de l'agencement courant à celui précédemment utilisé;
+  * MODKEY+j : passe le focus à la fenêtre suivante;
+  * MODKEY+k : passe le focus à la fenêtre précédente;
+  * MODKEY+h : réduit la taille de la zone principale;
+  * MODKEY+l : augmente la taille de la zone principale;
+  * MODKEY+Entrée : envoie la fenêtre sélectionnée vers la zone principale (ou l'envoie dans la pile si elle y est déjà);
+  * MODKEY+Shift+c : ferme la fenêtre sélectionnée;
+  * MODKEY+Shift+espace : bascule la fenêtre sélectionnée entre les agencements tuilage et flottant;
+  * MODKEY+Tab : sélectionne la vue précédente;
+  * MODKEY+Shift+[1..n] : donne à la fenêtre l'étiquette 1..n;
+  * MODKEY+Shift+0 : donner toutes les étiquettes à la fenêtre;
+  * MODKEY+Control+Shift+[1..n] : ajoute/retire l'étiquette numéro 1..n à la fenêtre sélectionnée, pratique si on veut donner une nouvelle étiquette à une fenêtre sans la faire disparaître. Équivalent à MODKEY+Shift+n puis MODKEY+Ctrl+n;
+  * MODKEY+[1..n] : voir toutes les fenêtres dont l'étiquette est 1..n;
+  * MODKEY+0 : voir toutes les fenêtres, quelle que soient leurs étiquettes;
+  * MODKEY+Control+[1..n] : ajoute/retire de la vue toutes les fenêtres avec l'étiquette 1..n;
+  * MODKEY+, : change d'écran, si il y en a plusieurs;
+  * MODKEY+Shift+q : quitte dwm (et votre session X par la même occasion);
+  * MODKEY+d : diminuer le nombre de fenêtres dans la zone principale;
+  * MODKEY+i : augmenter le nombre de fenêtres dans la zone principale.
-- attribution d'un tag à un programme
+=== dwm et la souris : ===
-- ajout commande shell et de son raccourci clavier
-- ajout commande static pour st tabbed
+Bien qu'étant conçu pour être piloté intégralement au clavier, il est possible d'utiliser la souris dans dwm:
-- modification du volume avec molette souris
-- présentation dwmstatus
+  * Clic-gauche sur symbole de l'agencement : bascule entre agencements précédents;
+  * Clic-milieu sur titre fenêtre : bascule des fenêtres depuis/vers la zone principale;
+  * Clic-milieu sur zone de status : ouvre un nouvel émulateur de terminal;
+  * Clic-gauche+MODKEY sur fenêtre : déplacer la fenêtre;
+  * Clic-droit+MODKEY sur fenêtre : redimensionner la fenêtre;
+  * Clic-milieu+MODKEY sur fenêtre : basculer la fenêtre en agencement flottant;
+  * Clic-gauche sur étiquette : voir les fenêtres possédant l'étiquette;
+  * Clic-droit sur étiquette : basculer entre les vues sélectionnées;
+  * Clic-gauche+MODKEY : attribuer l'étiquette cliquée à la fenêtre active;
+  * Clic-droit+MODKEY : basculer entre les étiquettes attribuées à une fenêtre.
+===== Astuces: =====
+=== Attribution d'un tag à un programme: ===
+Si vous souhaitez affecter une étiquette particulière à un programme de façon statique, cela est possible grâce aux règles de fenêtres qui se trouvent dans la partie du config.def.h\\
+**static const Rule rules[]**
+Une règle se définit sur le modèle suivant:\\
+<code C>
+{ "Classe_de_la_fenêtre",    Instance,    Titre,    Masque_d'étiquette,    Flottante?,    Num_écran },
+</code>
+dans lequel la classe, l'instance et le titre sont récupérables en lançant l'utilitaire xprop et en cliquant sur la fenêtre en question. La plupart du temps la classe suffit et instance et titre ont pour valeur NULL.\\
+Le masque d'étiquette répond à une logique particulière: 0 représente toutes les étiquettes, 1 << 2 représente la 3ème, 1 << 0 la 1ère, 1 << 7 la 8ème, etc... Le paramètre Flottante (isfloating dans le texte) prend pour valeur True ou False selon si la fenêtre doit nativement être flottante ou pas. Enfin Num_écran est le numéro de l'écran sur lequel s'affichera la fenêtre. "-1" représente l'écran actif.\\
+__**Exemple:**__
+<code C>
+static const Rule rules[] = {
+/* class        instance    title       tags mask     isfloating   monitor */
+{ "Dwb",              NULL,       NULL,       1 << 1,       False,       -1 },
+{ "Iceweasel",        NULL,       NULL,       1 << 1,       False,       -1 },
+{ "Gimp",             NULL,       NULL,       1 << 3,       False,       -1 },
+{ "Inkscape",         NULL,       NULL,       1 << 3,       False,       -1 },
+};
+</code>
+Toutes les fenêtres ayant pour classe Dwb s'ouvriront en ayant l'étiquette 2.\\
+=== Ajout commande shell et de son raccourci clavier: ===
+Il est bien entendu possible, et indispensable d'ailleurs, de paramétrer vos propres raccourcis clavier pour éxécuter un programme, un script etc... En voici la syntaxe:\\
+<code C>
+  { ControlMask|Mod1Mask,         XK_i,           spawn,          SHCMD("dwb") },
+  { ControlMask|Mod1Mask,         XK_m,           spawn,          SHCMD("st -e mutt -y") },
+  { ControlMask|Mod1Mask,         XK_p,           spawn,          SHCMD("st -e mcabber") },
+  { ControlMask|Mod1Mask,         XK_g,           spawn,          SHCMD("gimp") },
+</code>
+On voit que dans un premier temps on définit les touches modificatrices utilisées (ici Ctrl+Alt) associées à une touche du clavier (notée XK_et-sa-lettre). En bout de ligne, on voit que l'on utilise la fonction de dwm appelé SHCMD pour lancer le programme voulu. En somme, Ctrl+Alt+i ouvre dwb, Ctrl+Alt+m ouvre mutt dans l'émulateur de terminal st, Ctrl+Alt+p ouvre mcabber dans st également et enfin Ctrl+alt+g lance Gimp.\\
+Si vous souhaitez utiliser une touche non alpha-numérique (ex: ImpÉc), il faut récupérer son code avec l'utilitaire xev et le mettre à la place de XK_ et de mettre 0 à la place des modificateurs (en effet, ces touches spéciales s'emploient souvent seule).\\
+<code fichier>
+  { 0,                            0xff61,         spawn,          SHCMD("scrot -z") },
+</code>
+Dans cet exemple, j'utilise la touche ImpÉc (PrtScr), pour faire une capture d'écran à l'aide de scrot. Sur mon clavier, le code de cette touche est 0xff61.\\
+__Note sur la définition de l'émulateur de terminal:__ \\
+Le terminal à utiliser se définit dans le config.def.h grâce à la ligne:\\
+<code C>
+/* commande d'exécution de l'émulateur de terminal par défaut du système */
+static const char *termcmd[]  = { "x-terminal-emulator", NULL };
+</code>
+Si vous utilisez Debian, je vous recommande de laisser x-terminal-emulator. Cela vous permettra par la suite de choisir le terminal par défaut grâce au système d'"alternatives" de Debian (commande root update-alternatives --config x-terminal-emulator). Vous y gagnerez en souplesse et ne serez plus obligé de modifier la configuration de dwm et de le compiler à chaque changement.\\
+=== Ajout commande static pour st tabbed: ===
+Pour les utilisateurs de l'émulateur de terminal st et de tabbed, une interface générique à onglet, il est intéressant de définir une constante permettant de lancer l'un dans l'autre directement, sans utiliser la fonction interne SHCMD. Cela nous économise le lancement d'un processus de /bin/sh supplémentaire. Il suffit de rajouter cette ligne en dessous de celle définissant l'émulateur de terminal :\\
+<code C>
+static const char *tabbedst[] = { "tabbed", "-c", "-r", "2", "st", "-w", "''", NULL };
+</code>
+=== Modification du volume avec molette de la souris: ===
+Il est possible de modifier le volume sonore simplement en faisant jouer la molette de la souris dans la zone de status de la barre de dwm. Pour cela, ajoutez les lignes suivantes à la fin du fichier de configuration, dans la section "buttons definitions":\\
+<code C>
+   { ClkStatusText,        0,              Button4,        spawn,          SHCMD("amixer -q set Master 2dB+ unmute") },
+   { ClkStatusText,        0,              Button5,        spawn,          SHCMD("amixer -q set Master 2dB- unmute") },
+</code>
+=== Présentation dwmstatus: ===
+dwmstatus est un petit programme permettant d'afficher toutes sortes d'informations utiles dans la zone de statut de la barre. La version téléchargeable sur le site du projet suckless n'est qu'un squelette vous permettant d'en faire ce que bon vous semble. Voici le code de celui que j'utilise, il est constitué d'exemples trouvés ici et là et adapté à mon ordinateur:\\
+<code C>
+/*
+** Compile with:
+** gcc -Wall -pedantic -std=c99 -lX11 status.c
+*/
+#include
+#include
+#include
+#include
+#include
+#include
+#include
+#include
+#include
+#include
+#include
+#include
+#include
+#include
+#include
+#include
+static Display *dpy;
+void setstatus(char *str) {
+	XStoreName(dpy, DefaultRootWindow(dpy), str);
+	XSync(dpy, False);
+}
+char *
+smprintf(char *fmt, ...)
+{
+  va_list fmtargs;
+  char *buf = NULL;
+  va_start(fmtargs, fmt);
+  if (vasprintf(&buf, fmt, fmtargs) == -1){
+    fprintf(stderr, "malloc vasprintf\n");
+    exit(1);
+  }
+  va_end(fmtargs);
+  return buf;
+}
+char*
+runcmd(char* cmd) {
+  FILE* fp = popen(cmd, "r");
+  if (fp == NULL) return NULL;
+  char ln[50];
+  fgets(ln, sizeof(ln)-1, fp);
+  pclose(fp);
+  ln[strlen(ln)-1]='\0';
+  return smprintf("%s", ln);
+}
+char *
+loadavg(void)
+{
+    double avgs[3];
+    if (getloadavg(avgs, 3) < 0) {
+        perror("getloadavg");
+        exit(1);
+    }
+    return smprintf("%.2f %.2f %.2f", avgs[0], avgs[1], avgs[2]);
+}
+char *getdatetime() {
+	char *buf;
+	time_t result;
+	struct tm *resulttm;
+	if((buf = malloc(sizeof(char)*65)) == NULL) {
+		fprintf(stderr, "Cannot allocate memory for buf.\n");
+		exit(1);
+	}
+	result = time(NULL);
+	resulttm = localtime(&result);
+	if(resulttm == NULL) {
+		fprintf(stderr, "Error getting localtime.\n");
+		exit(1);
+	}
+	if(!strftime(buf, sizeof(char)*65-1, "%d %h %H:%M:%S", resulttm)) {
+		fprintf(stderr, "strftime is 0.\n");
+		exit(1);
+	}
+	return buf;
+}
+int getbattery() {
+	FILE *fd;
+	int energy_now, energy_full;
+	fd = fopen("/sys/class/power_supply/BAT0/energy_now", "r");
+	if(fd == NULL) {
+		fprintf(stderr, "Error opening energy_now.\n");
+		return -1;
+	}
+	fscanf(fd, "%d", &energy_now);
+	fclose(fd);
+	fd = fopen("/sys/class/power_supply/BAT0/energy_full", "r");
+	if(fd == NULL) {
+		fprintf(stderr, "Error opening energy_full.\n");
+		return -1;
+	}
+	fscanf(fd, "%d", &energy_full);
+	fclose(fd);
+	return (((float)energy_now / (float)energy_full) * 100);
+	}
+int
+getvolume() {
+  int volume;
+  sscanf(runcmd("amixer | grep -A 6 Master | grep 'Playback'\
+| grep -o '[0-9%]*%'"), "%i%%", &volume);
+  return volume;
+}
+int main(void) {
+	char *status;
+    char *avgs = NULL;
+	char *datetime;
+	int bat0;
+	int volume = 0;
+	if (!(dpy = XOpenDisplay(NULL))) {
+		fprintf(stderr, "Cannot open display.\n");
+		return 1;
+	}
+	if((status = malloc(200)) == NULL)
+		exit(1);
+	for (;;sleep(1)) {
+        avgs = loadavg();
+		datetime = getdatetime();
+		bat0 = getbattery();
+		volume = getvolume();
+		snprintf(status, 200, "%s | %s | Ω %d%% | ♫ %d%%", avgs, datetime, bat0, volume);
+        free(avgs);
+		free(datetime);
+		setstatus(status);
+	}
+    free(status);
+	XCloseDisplay(dpy);
+	return 0;
+}
+</code>
+Il affiche la charge système, la date et l'heure, le niveau de batterie et le volume.\\
-===== Conclusion =====
+===== Conclusion: =====
+dwm est un excellent gestionnaire de fenêtre, je l'utilise au quotidien et l'apprécie particulièrement. La gestion des fenêtres est très bonne, grâce aux commandes clavier, il est extrêmement simple de les déplacer, de les étiquetter, de les rappeler, de les basculer d'un écran à l'autre. dwm est très sobre en ressources et d'une stabilité à toute épreuve. Sa mise en place est un peu délicate et peut rebuter toutefois (configuration pré-compilation, manipulation de fichiers source en C, dénuement apparent). J'espère que ce tutoriel et les sources dont il s'inspire saura vous aider à l'apprivoiser.\\
 --- //[[sogalpunx@volted.net|Sogal 'Seb' Punx]] 18/01/2015 17:24//

doc/environnements/x11/dwm.txt · Dernière modification: 25/01/2017 08:24 par sogal

Debian-facile

Différences

Pied de page des forums