herbstluftwm - En ligne dans le Cloud

PROGRAMME:

Nom

herbstluftwm - un gestionnaire de fenêtre de mosaïque manuel pour X

SYNOPSIS

herbstluftwm [OPTION ...]

DESCRIPTION

Démarre le herbstluftwm gestionnaire de fenêtres activé DISPLAY. Il écoute également les appels de
Herbstclient(1) et les exécute. La liste des disponibles COMMANDES est répertorié ci-dessous.

OPTION peut être:

-c, --démarrage automatique PATH
utilisé PATH comme fichier de démarrage automatique au lieu de celui dans $XDG_CONFIG_HOME

-v, --version
version imprimée et sortie

-l, --fermé à clé
Initialement, définissez le paramètre monitors_locked sur 1

--verbeux
imprimer des informations détaillées sur stderr

Ce manuel documente l'interface de script et de configuration. Pour un plus verbeux
présentation voir herbstluftwm-tutoriel (7).

CARRELAGE ALGORITHME

Le concept de tuilage de base est que la mise en page est représentée par un arbre binaire. Au démarrage
vous voyez un grand cadre sur tout l'écran. Un cadre remplit exactement l'un des
Les conditions suivantes:

1. Le cadre contient des fenêtres :

Il montre quelques clients et les arrange. Les algorithmes de mise en page actuels sont :

· 0 : vertical - les clients sont placés les uns en dessous des autres

· 1 : horizontal - les clients sont placés les uns à côté des autres

· 2 : max - tous les clients sont maximisés dans ce cadre

· 3 : grille - les clients sont disposés dans une grille presque quadratique

2. Le cadre est divisé en sous-cadres :

Il est divisé en exactement deux sous-cadres dans un paramétrable fraction soit à la verticale
ou de manière horizontale. Il produit donc deux cadres qui remplissent les mêmes conditions (nouveau
les cadres sont toujours sur le point de contenir fenêtres). Si vous divisez un cadre déjà
contient des fenêtres, les fenêtres sont héritées par le premier nouveau cadre enfant.

Si une nouvelle fenêtre apparaît, elle est placée dans le cadre actuellement focalisé. Seules les feuilles du
l'arborescence du cadre peut être focalisée.

Une trame peut être supprimée, elle est alors fusionnée avec sa trame voisine. En raison de la disposition
structure d'un arbre binaire, chaque trame (c'est-à-dire nœud dans l'arbre binaire) a exactement un
voisine.

L'analogie avec un arbre binaire est expliquée de la meilleure façon avec un petit exemple : Au démarrage
vous avez un arbre binaire simple, avec un cadre pouvant contenir des clients :

C

Lors du fractionnement (par exemple avec la commande scission vertical 0.5) vous obtiendrez ceci :

V
/ \
CC

Vous pouvez également diviser le cadre de gauche horizontalement et vous obtiendrez :

V
/ \
HC
/ \
CC

Si vous changez le focus sur le client de droite et supprimez ce cadre, il sera
fusionné avec le sous-arbre de gauche et vous obtiendrez :

H
/ \
CC

La disposition La commande imprime la disposition actuelle de toutes les balises sous forme d'arborescence.

CADRE INDEX

La position exacte d'un cadre dans l'arborescence peut être décrite par son indice lequel est
juste une chaîne de caractères. L'algorithme de recherche commence à la trame racine et en sélectionne une
de ses deux sous-arbres en fonction de chaque caractère de l'index.

Les caractères sont interprétés comme suit :

· 0 : sélectionnez le premier sous-arbre

· 1 : sélectionnez le deuxième sous-arbre

· . : sélectionner le sous-arbre ayant le focus

· / : sélectionne le sous-arbre n'ayant pas le focus

Ainsi, une chaîne vide fait référence au cadre racine, et "00" fait référence au premier sous-arbre du
premier sous-arbre du cadre racine.

Dans un cas particulier, la chaîne "@" fait toujours référence à l'image actuellement focalisée.

MOTS CLÉS

Les balises sont très similaires aux espaces de travail, aux bureaux virtuels ou aux groupes de fenêtres. Chaque balise a un
disposition. Il y a une liste de balises. Vous pouvez ajouter ou supprimer des balises de manière dynamique.

MONITEURS

Moniteurs dans herbstluftwm sont totalement indépendants des écrans physiques réels. Cette
signifie que vous pouvez par exemple diviser votre écran en deux moniteurs virtuels pour afficher deux balises à
une fois sur grand écran.

Chaque moniteur affiche exactement une balise sur un rectangle spécifié à l'écran.

Chaque moniteur peut avoir un nom, qui peut être défini via ajouter_moniteur ainsi que renommer_moniteur. Il peut
être dérangé par le renommer_moniteur commander. Un nom de moniteur est une chaîne arbitraire non vide
qui ne doit pas commencer par +, - ni aucun chiffre.

Un moniteur peut être référencé de différentes manières :

· par son indice absolu tel qu'indiqué dans le liste_moniteurs commander.

· par son indice relatif : un + ou - suivi d'un delta, ex : +3

· par sa position relative par rapport au moniteur focalisé. -l désigne le moniteur à gauche du
moniteur focalisé, -r à droite de, -u au-dessus de et -d en dessous de, respectivement.

· par "" (une chaîne vide) qui représente le moniteur actuel.

· par son nom.

COMMANDES

herbstluftwm est contrôlé par des commandes internes, qui peuvent être exécutées via Herbstclient(1)
ou via des raccourcis clavier.

quitter
Quitte herbstluftwm.

Recharger
Exécute le fichier de démarrage automatique.

version
Imprime la version de l'instance herbstluftwm en cours d'exécution.

écho [ARGS ...]
Imprime tout donné ARGS séparés par un seul espace et un saut de ligne par la suite.

oui
Ignore tous les arguments et renvoie toujours le succès, c'est-à-dire 0.

non
Ignore tous les arguments et renvoie toujours un échec, c'est-à-dire 1.

liste_commandes
Répertorie toutes les commandes disponibles.

liste_moniteurs
Liste des moniteurs actuellement configurés avec leur index, zone (sous forme de rectangle), nom (si
nommé) et la balise actuellement consultée.

liste_règles
Répertorie toutes les règles actives. Chaque ligne est constituée de tous les paramètres auxquels la règle a été appelée
avec, plus son étiquette, séparés par des tabulations.

liste_keybinds
Répertorie toutes les clés liées avec leur commande associée. Chaque ligne se compose d'une clé
combinaison et la commande avec ses paramètres séparés par des tabulations.


Les onglets dans les paramètres de commande ne sont pas échappés !

bloquer
Augmente la moniteurs_verrouillés réglage. Utilisez ceci si vous voulez faire plusieurs fenêtres
actions à la fois (c'est-à-dire sans repeindre entre les étapes simples). Voir également: ouvrir

ouvrir
Diminue la moniteurs_verrouillés paramètre. Si moniteurs_verrouillés est changé à 0, alors tout
les moniteurs sont repeints à nouveau. Voir également: bloquer

raccourci clavier clé - KEY COMMAND [ARGS ]
Ajoute une liaison de touche. Lorsque clé - KEY est enfoncé, l'interne COMMAND (avec son ARGS) est
réalisé. Un raccourci clavier est une liste (éventuellement vide) de modificateurs (Mod1, Mod2, Mod3,
Mod4, Mod5, Alt, Super, Control/Ctrl, Shift) et une touche (voir keysymdef.h pour une liste
des clés). Les modificateurs et la clé sont concaténés avec - or + comme séparateur. S'il y a
déjà une liaison pour cela clé - KEY, il sera écrasé. Exemples:

· raccourci clavier Mod4+Ctrl+q quitter

· keybind Mod1-i bascule always_show_frame

· raccourci clavier Mod1-Maj-espace cycle_layout -1

délier la clé clé - KEY|-F|--tout
Supprime le raccourci clavier pour clé - KEY. La syntaxe pour clé - KEY est défini dans raccourci clavier. Si -F or
--tout est donné, alors toutes les combinaisons de touches seront supprimées.

lier la souris BOUTON ACTION [COMMAND ...]
Ajoute une liaison de souris pour le mode flottant. Lorsque BOUTON est enfoncé, le spécifié
ACTION sera réalisée. BOUTON a une syntaxe similaire à la clé - KEY argument du raccourci clavier :
Il se compose d'une liste de modificateurs (séparés par - or +, les modificateurs valides sont répertoriés dans
la description de raccourci clavier) et exactement un nom de bouton :

· B1 ou Bouton1

· B2 ou Bouton2

· B3 ou Bouton3

· B4 ou Bouton4

· B5 ou Bouton5

ACTION doit être l'une des actions suivantes :

· déplacer : Déplace la fenêtre en faisant glisser le curseur.

· redimensionner : redimensionne la fenêtre en faisant glisser un coin.

· zoom : redimensionne la fenêtre dans les quatre directions tout en gardant le centre de la
constante de fenêtre.

· appeler : appelle uniquement le COMMAND tandis que client.drag des liens vers le client sur
ce en quoi consistera l' BOUTON a été effectuée.

Alors qu'un ACTION est effectuée, client.dragged est le client qui est glissé. Par exemple:

· zoom Mod1-Button3 lié à la souris

· mousebind Mod1-B4 substitut d'appel WID clients.dragged.winid spawn transset-df
--inc -i WID 0.05

· mousebind Mod1-B5 substitut d'appel WID clients.dragged.winid spawn transset-df
--dec -i WID -m 0.2 0.05

dissocier la souris
Supprime toutes les liaisons de souris.

frayer EXÉCUTABLE [ARGS ]
Génère un EXÉCUTABLE avec ses ARGS. Pour plus de détails, voir man 3 vice-président exécutif. exemple:

· spawn xterm -e man 3 execvp

wmexec [GESTIONNAIRE DE FENETRE [ARGS ]]
Exécute le GESTIONNAIRE DE FENETRE avec ses ARGS. Ceci est utile pour changer le gestionnaire de fenêtres
dans la session en cours sans redémarrer la session. Si non ou invalide
GESTIONNAIRE DE FENETRE est donné, puis herbstluftwm est redémarré. Pour plus de détails voir man 3 vice-président exécutif.
Mise en situation :

· boîte ouverte wmexec

chaîne SÉPARATEUR [COMMANDES ...]
la chaîne s'attend à un SÉPARATEUR et une liste de COMMANDES avec argumentation. Les commandes doivent
être séparés par le spécifié SÉPARATEURL’ SÉPARATEUR peut par n'importe quel mot et est seulement
reconnu comme séparateur entre les commandes s'il correspond exactement SÉPARATEUR. "chaîne"
affiche les sorties ajoutées de toutes les commandes et renvoie le code de sortie de la dernière
commande exécutée. Les exemples sont :

· Créez un tag nommé "foo" et utilisez-le directement :

chaîne , ajouter foo , utiliser foo

· Faites pivoter la mise en page dans le sens des aiguilles d'une montre :

chaîne .-. verrouiller .-. tourner .-. tourner .-. tourner .-. ouvrir

Les contre-exemples sont :

· Cela ne créera qu'un tag appelé "foo," :

chaîne , ajouter foo, utiliser foo

· Séparateur "." défini, mais "," est utilisé :

chaîne . ajouter foo , utiliser foo

ainsi que SÉPARATEUR [COMMANDES ...]
"et" se comporte comme la commande en chaîne mais n'exécute que la commande spécifiée COMMANDES tout en
les commandes renvoient le code de sortie 0.

or SÉPARATEUR [COMMANDES ...]
"ou" se comporte comme la commande en chaîne mais n'exécute que la commande spécifiée COMMANDES jusqu'à un
La commande renvoie le code de sortie 0.

! COMMAND
"!" exécute la commande fournie, mais inverse sa valeur de retour. Si le fourni
La commande renvoie une valeur différente de zéro, "!" renvoie un 0, si la commande renvoie un zéro, "!" Retour
et 1.

Essai COMMAND
"try" exécute la commande fournie, imprime sa sortie, mais renvoie toujours le succès,
c'est-à-dire 0.

silencieux COMMAND
"silent" exécute la commande fournie, mais rejette sa sortie et ne renvoie que son
code de sortie.

focus_nth INDEX
Concentre la nième fenêtre dans un cadre. La première fenêtre a INDEX 0. Si INDEX est négatif
ou supérieur à l'index de la dernière fenêtre, la dernière fenêtre est focalisée.

faire du vélo [DELTA]
Fait défiler la sélection dans le cadre actuel en DELTA. Si DELTA est omis, DELTA = 1
sera utilisé. DELTA peut être négatif ; DELTA = -1 signifie : cycle en sens inverse
direction par 1.

cycle_all [--saut-invisible] [DIRECTION]
Parcourt toutes les fenêtres et tous les cadres de la balise actuelle. DIRECTION = 1 signifie
vers l'avant, DIRECTION = -1 signifie en arrière, DIRECTION = 0 n'a aucun effet. DIRECTION
la valeur par défaut est 1. S'il y a plusieurs fenêtres dans le cadre, il agit de la même manière que
le cycle commander. (Le cycle_tout commande concentre le congé suivant/précédent dans le
disposition arbre.). Si --saut-invisible est donné, alors cela ne fait que parcourir tous les éléments visibles
windows et ignore les fenêtres invisibles dans la mise en page max. La fenêtre focalisée est relevée.

cadre_cycle [DIRECTION]
Parcourt toutes les images de la balise actuelle. DIRECTION = 1 signifie en avant, DIRECTION
= -1 signifie en arrière, DIRECTION = 0 n'a aucun effet. DIRECTION la valeur par défaut est 1.

cycle_layout [DELTA [DISPOSITIFS ...]]
Fait défiler l'algorithme de mise en page dans le cadre actuel en DELTA. DELTA la valeur par défaut est 1. Vous
pouvez trouver une liste d'algorithmes de mise en page ci-dessus. Si une liste de DISPOSITIFS est donné,
cycle_layout fera défiler ceux-ci au lieu de la liste d'algorithmes de mise en page par défaut.
Chaque nom de mise en page doit apparaître au plus une fois. Exemple:

· cycle_layout -1

· cycle_layout 1 grille verticale

set_layout LAYOUT
Définit l'algorithme de mise en page dans le cadre actuel sur LAYOUT. Pour la liste des mises en page,
consultez la liste des algorithmes de mise en page ci-dessus.

close IDWIN
Ferme la fenêtre spécifiée normalement ou la fenêtre focalisée si aucune n'est donnée
explicitement. Voir la section sur WINDOW IDS comment référencer une certaine fenêtre.

fermer_ou_supprimer
Ferme la fenêtre focalisée ou supprime l'image courante si aucune fenêtre n'est focalisée.

fermer_et_supprimer
Ferme la fenêtre focalisée et supprime le cadre actuel si aucune autre fenêtre n'est présente
dans ce cadre.

scission ALIGNER [FRACTION]
Divise le cadre focalisé en deux sous-cadres avec un FRACTION entre 0 et 1
qui vaut par défaut 0.5. ALIGNER fait partie de

· top

· bas (= vertical)

· à gauche,

· bon (= horizontal)

· exploser

· auto (répartir sur le côté le plus long)

Il spécifie laquelle des deux moitiés sera vide après la scission. L'autre moitié
sera occupé par le cadre actuellement focalisé. Après la scission, l'origine
Le cadre de mise au point restera concentré. Un spécial ALIGNER le mode est exploser, qui divise
le cadre de telle sorte que les tailles et les positions des fenêtres soient conservées autant que
possible. Sinon FRACTION est donné à exploser mode une fraction optimale est choisie
automatiquement. Exemple:

· diviser exploser

· fond fendu 0.5

· horizon divisé 0.3

· fente verticale 0.5

· diviser h

concentrer [-i|-e] DIRECTION
Déplace le focus de l'image actuelle à l'image ou au client suivant dans DIRECTION lequel est
dans:

· à gauche]

· à droite]

· en haut]

· vers le bas]

If -i (interne) est donné ou default_direction_external_only n'est pas défini, puis le suivant
client dans DIRECTION peut également être dans le même cadre. S'il n'y a pas de client dans
ce cadre ou -e (externe) est donné, puis la prochaine image dans spécifié DIRECTION sera
concentre-toi.

La direction entre les images est définie comme suit : Le focus est dans une feuille du
arbre binaire. Chaque nœud interne de l'arbre se souvient de la dernière direction de focus (enfant 0
ou enfant 1). L'algorithme utilise le chemin le plus court possible à partir de la feuille (le
cadre focalisé) à la racine jusqu'à ce qu'il soit possible de changer le focus dans le
DIRECTION. De là, la mise au point revient à la feuille.

Exemple : la mise au point est sur l'image A. Après l'exécution concentration bon la mise au point sera au cadre
C.

Arbre : V,0 Ecran : (avant)
╲ │ B C │
╲ └─────┘└─────┘
H,1 H,0
╲ ╱ ╲ │ A* ││ D │
A* BCD └─────┘└─────┘

Arbre : V,0 Écran : (après focus à droite)
╲ │ B ││ C* │
╲ └─────┘└─────┘
H,1 H,0
╲ ╱ ╲ │ A ││ D │
ABC* D

Si le client actuellement focalisé est flottant, alors la fenêtre flottante suivante dans le
la direction spécifiée est focalisée et élevée.

If focus_crosses_monitor_boundaries est défini et aucun client ou cadre n'est trouvé dans le
spécifié DIRECTION, puis le prochain moniteur dans ce DIRECTION est concentré.

focus_edge [-i|-e] DIRECTION
Concentre la fenêtre sur le bord de la balise dans le DIRECTIONL’ DIRECTIONS
ainsi que -e se comporter comme spécifié au concentration commander.

If -i (interne) est donné ou default_direction_external_only est désactivé, alors la fenêtre
sur le bord de la balise sera mis au point. Sinon, seul le cadre sur le bord de l'étiquette
sera focalisé, et la fenêtre qui a été focalisée en dernier dans ce cadre sera focalisée.

augmenter IDWIN
Élève la fenêtre spécifiée. Voir la section sur WINDOW IDS sur la façon de référencer un
certaine fenêtre. Son résultat n'est visible qu'en mode flottant.

Conseil
La IDWIN peut également spécifier une fenêtre non gérée, bien que l'achèvement de l'augmentation
La commande ne répertorie pas les ID des fenêtres non gérées.

sauter à IDWIN
Met le focus sur la fenêtre spécifiée. Voir la section sur WINDOW IDS pour savoir comment
référence une certaine fenêtre.

apporter IDWIN
Déplace la fenêtre spécifiée vers l'image actuelle et la focalise. Voir la section sur
WINDOW IDS sur la façon de référencer une certaine fenêtre.

redimensionner DIRECTION FRACTIONDELTA
Modifie la fraction suivante dans spécifié DIRECTION by FRACTIONDELTA. DIRECTION se comporte
comme spécifié à la concentration commander. Vous ne devez pas omettre le signe - or +, parce que dans
versions futures, le comportement peut changer si le signe est omis. Exemple:

· redimensionner à droite +0.05

· redimensionner vers le bas -0.1

décalage_bord [-i|-e] DIRECTION
Déplace la fenêtre focalisée sur le bord d'une balise dans le DIRECTIONL’
DIRECTIONS se comporter comme spécifié au concentration commande et -i ainsi que -e se comporter comme spécifié
au focus_edge commander.

décalage [-i|-e] DIRECTION
Déplace la fenêtre focalisée sur l'image suivante dans le DIRECTIONL’ DIRECTIONS
ainsi que -i|-e se comporter comme spécifié au concentration commander. Si le client ciblé est flottant
au lieu d'être en mosaïque, le client est déplacé vers la fenêtre ou le bord de l'écran suivant.

shift_to_monitor MONITOR
Déplace la fenêtre focalisée vers la balise sur le spécifié MONITOR .

supprimez
Supprime le cadre focalisé et fusionne ses fenêtres avec son cadre voisin.

tourner
Fait pivoter la mise en page sur la balise ciblée dans le sens inverse des aiguilles d'une montre de 90 degrés. Ceci seulement
manipule l'alignement des cadres, pas leur contenu.

set Nom VALEURE
Définit le paramètre spécifié Nom à VALEURE. Tous REGLAGES sont répertoriés dans la rubrique
ci-dessous.

obtenez Nom
Imprime la valeur du paramètre Nom. Tous REGLAGES sont répertoriés dans la section ci-dessous.

basculer Nom
Bascule le réglage Nom s'il s'agit d'un paramètre entier : si sa valeur est différente de 0, il
devient 0 ; sinon sa valeur précédente (qui n'était pas égale à 0) est restaurée.

valeur_cycle Nom VALEURS
Valeur de cycles du réglage Nom à travers VALEURS: c'est-à-dire qu'il recherche la première occurrence
de la valeur actuelle dans VALEURS et change la valeur à la suivante dans la liste ou à la
le premier si la fin est atteinte ou si la valeur actuelle n'a pas été trouvée. Exemple:

· cycle_value frame_gap 0 5 10 15

· cycle_value frame_bg_normal_color rouge vert bleu

moniteur_cycle [DELTA]
Moniteur de cycles focalisé par DELTA. DELTA la valeur par défaut est 1.

focus_monitor MONITOR
Met le focus sur le moniteur spécifié.

ajouter TAG
Crée une nouvelle balise vide nommée TAG.

utilisé TAG
Bascule le moniteur focalisé sur spécifié TAG.

utiliser_index INDEX [--saut-visible]
Bascule le moniteur focalisé sur le TAG avec le spécifié INDEX. Si INDEX commence avec
+ ou -, puis INDEX est traité par rapport au courant TAG. Si --saut-visible est passé
ainsi que INDEX est relatif, les balises déjà visibles sur un moniteur sont ignorées.
Par exemple, cela revient en arrière dans les balises :

· use_index -1 --skip-visible

utiliser_précédent
Bascule le moniteur focalisé sur la balise précédemment visualisée.

merge_tag TAG [CIBLE]
Supprime la balise nommée TAG et déplace toutes ses fenêtres pour marquer CIBLE. Si CIBLE est omis,
la balise ciblée sera utilisée.

rebaptiser ANCIEN ÉTIQUETTE NOUVELLE ÉTIQUETTE
Renomme la balise nommée ANCIEN ÉTIQUETTE à NOUVELLE ÉTIQUETTE.

Bougez TAG
Déplace la fenêtre focalisée vers la balise nommée TAG.

move_index INDEX [--saut-visible]
Déplace la fenêtre focalisée vers la balise spécifiée par INDEX. Analogique à l'argument pour
utiliser_index: Si INDEX commence par + ou -, puis il est traité de manière relative. Si --saut-visible
est passé avec un index relatif, les balises déjà visibles sont ignorées.

balise_lock [MONITOR ]
Verrouillez la commutation de balise sur le moniteur spécifié. Si aucun argument n'est donné, le
le moniteur actuellement focalisé est utilisé. Lorsque la commutation de balise est désactivée pour un moniteur,
les commandes utilisé ainsi que utiliser_index n'ont aucun effet lorsqu'ils y sont exécutés. Lorsque
swap_monitors_to_get_tag est activé, en passant à une étiquette qui se trouve sur un verrou verrouillé
moniteur, passe à ce moniteur au lieu de le voler à partir de là. L'état de verrouillage de
un moniteur est indiqué par "[LOCKED]" dans le liste_moniteurs sortie.

déverrouiller_tag [MONITOR ]
Réactive le changement de balise sur le moniteur spécifié. Si aucun argument n'est donné, le
le moniteur actuellement focalisé est utilisé. C'est l'opération inverse pour lock_tag et a
pas d'autres effets secondaires mais la suppression de ce verrou.

disjoindre_rects RECTS
Prend une liste de rectangles et les divise en plus petits morceaux jusqu'à ce que tous les rectangles
sont disjoints, les rectangles résultants sont imprimés ligne par ligne. Cette commande ne
modifiez la liste actuelle des moniteurs ! Cela peut donc être utile en combinaison avec le
commande set_monitors.

· Par exemple disjoin_rects 600x400+0+0 600x400+300+250 imprime ceci :

300x150+300+250
600x250+0+0
300x150+0+250
300x150+600+250
600x250+300+400

· Dans l'exemple ci-dessus, deux moniteurs sont divisés en 5 moniteurs, qui graphiquement
veux dire:

┌──────┐
│ └──────┘
┌───┼───┐ ┌─┐┌───┐┌──┐
│ │ │ │ disjoindre │ ││ ││ │
│ ─────────> └─┘└───┘└──┘
│ ┌───────┐
└───────┘

set_monitors RECTS
Définit la liste des moniteurs exactement à la liste des rectangles donnés :

· Le iième moniteur existant est déplacé vers le iième donné RECHERCHER

· De nouveaux moniteurs sont créés s'il y en a plus RECTS puis surveille

· Les moniteurs existants sont supprimés s'il y a plus de moniteurs que RECTS

détecter_monitors -l|--liste|--no-disjoindre
Définit la liste des moniteurs sur les moniteurs Xinerama disponibles. Si le Xinerama
l'extension est manquante, elle retombera sur un moniteur sur tout l'écran. Si
les moniteurs détectés se chevauchent, ils seront divisés en plusieurs moniteurs disjoints
mais couvrent la même zone en utilisant disjoin_rects.

If -l or --liste est passé, la liste des rectangles des moniteurs physiques détectés est
imprimé. Donc hc detect_monitors est équivalent à la commande bash hc set_monitors $(hc
disjoin_rects $(hc detect_monitors -l)).

ajouter_moniteur RECHERCHER [TAG [Nom]]
Ajoute un moniteur sur le rectangle spécifié RECHERCHER et affiche TAG sur elle. TAG actuellement, en ce moment
ne doit pas être affiché sur un autre moniteur. RECHERCHER est une chaîne de la forme LxH±X±Y. Si
non ou un vide TAG est donné, alors n'importe quel tag gratuit sera choisi. Si un Nom est donné, vous
peut faire référence à ce moniteur par son nom au lieu d'utiliser un index. Exemple:

· add_monitor 1024x768-20+0 mynewtag principal

supprimer_moniteur MONITOR
Supprime le moniteur spécifié.

move_monitor MONITOR RECHERCHER [PAD-UP [PADDRIGHT [PADDOWN [PAVILLON]]]]
Déplace le moniteur spécifié vers le rectangle RECHERCHER. RECHERCHER est défini comme dans ajouter_moniteur. Si
non ou un tampon vide est donné, il n'est pas modifié.

augmenter_moniteur [MONITOR ]
Élève le moniteur spécifié ou le moniteur actuel si MONITOR est omis.

renommer_moniteur MONITOR Nom
(Re)nomme un moniteur déjà existant. Si Nom est vide, il supprime le moniteur
nom.

empiler
Imprime la pile de moniteurs avec les balises visibles et leurs couches sous forme d'arborescence. le
l'ordre de la pile imprimée est de haut en bas. Le style est configuré par le style_arbre
réglage.

moniteur_rect [[-p] MONITOR ]
Imprime le rectangle du moniteur spécifié au format : X Y W H Sinon MONITOR or
actu est donné, alors le moniteur actuel est utilisé. Si -p est fourni, puis le reste
rect sans le tampon autour de ce moniteur est imprimé.

chemin MONITOR [PAD-UP [PADDRIGHT [PADDOWN [PAVILLON]]]]
Définit le pad du moniteur spécifié sur le padding spécifié. Si non ou un rembourrage vide
est donné, il n'est pas modifié.

list_padding [MONITOR ]
Répertorie le remplissage du moniteur spécifié, ou le moniteur actuellement focalisé si non
moniteur est donné.

disposition [TAG [INDEX]]
Imprime la disposition du cadre avec INDEX on TAG, dans un joli style d'arbre. Son style est
défini par le style_arbre réglage. Sinon TAG est donné, la balise actuelle est utilisée. Sinon
INDEX est donnée, la trame racine est utilisée. Spécifier INDEX sans préciser TAG (c'est à dire
utiliser la balise actuelle), passez une chaîne vide comme TAG.

Un exemple de sortie est :

╾─┐ sélection horizontale 50%=1
verticale : 0xe00009
└─┐ sélection verticale 50%=0
vertical : 0xa00009 [FOCUS]
verticale : 0x1000009

décharger [TAG [INDEX]]
Imprime les mêmes informations que le disposition commande mais dans un format lisible par machine.
Sa sortie peut être relue avec le charge commander.

Un exemple de sortie (formaté par la suite) est :

(divisé horizontalement : 0.500000 : 1
(clients verticaux : 0 0xe00009)
(divisé verticalement : 0.500000 : 1
(clients verticaux : 0 0xa00009)
(clients verticaux : 0 0 x1000009)))

charger [TAG] LAYOUT
Charge un donné LAYOUT description à spécifier TAG ou balise actuelle si non TAG est donné.

Attention
LAYOUT est exactement un paramètre. Si vous l'appelez manuellement depuis votre shell ou
à partir d'un script, citez-le correctement !

complet POSITION [COMMAND ARGS ]
Imprime le résultat de la complétion de tabulation pour le partiel COMMAND avec facultatif ARGS. Vous
n'en ont généralement pas besoin, car il existe déjà une fonction de complétion de tabulation pour bash. Exemple:

· compléter 0 m

imprime toutes les commandes commençant par m

· compléter 1 bascule fra

imprime tous les paramètres commençant par fra qui peuvent être basculés

complete_shell POSITION [COMMAND ARGS ]
Se comporte comme complet avec les extras suivants, utiles pour compléter sur posix
coquilles:

· Les séquences d'échappement sont supprimées dans COMMAND ainsi que ARGS.

· Un espace est ajouté à chaque résultat d'achèvement complet.

· Les caractères spéciaux seront échappés dans la sortie.

émettre_crochet ARGS
Émet un crochet personnalisé à tous les herbstclients inactifs.

statut_tag [MONITOR ]
Imprimer une liste séparée par des tabulations de toutes les balises pour le spécifié MONITOR indice. Sinon MONITOR
indice est donné, le moniteur focalisé est utilisé. Chaque nom de balise est préfixé par un caractère,
qui indique son état :

· . la balise est vide

· : la balise n'est pas vide

· + la balise est affichée sur le spécifié MONITOR , mais ce moniteur n'est pas focalisé.

· # la balise est affichée sur le spécifié MONITOR et il est concentré.

· - l'étiquette est vue sur un autre MONITOR , mais ce moniteur n'est pas focalisé.

· % l'étiquette est vue sur un autre MONITOR et il est concentré.

· ! le tag contient une fenêtre urgente


Si vous utilisez un onglet dans l'un des noms de balises, alors tag_status est probablement tout à fait inutile
pour vous.

flottant [[TAG] on|de rabais|basculer|statuts]
Modifie la balise actuelle en mode flottant/en mosaïque sur spécifié TAG ou l'imprime en cours
statut. Sinon TAG est donné, la balise actuelle est utilisée. Si aucun argument n'est donné, flottant
le mode est basculé. Si statuts est donné, alors on or de rabais est imprimé, selon le
état flottant de TAG.

régner [[--]FLAG|[--]LABEL|[--]CONDITION|[--]CONSÉQUENCE ...]
Définit une règle qui sera appliquée à tous les nouveaux clients. Son comportement est décrit dans
le DES RÈGLES .

incontrôlable LABEL|--tout|-F
Supprime toutes les règles nommées LABEL. Si --all ou -F est passé, alors toutes les règles sont supprimées.

plein écran [on|de rabais|basculer]
Définit ou bascule l'état plein écran du client ciblé. Si aucun argument n'est donné,
le mode plein écran est basculé.

pseudotuile [on|de rabais|basculer]
Définit ou bascule l'état de pseudotile du client ciblé. Si un client est
pseudotile, puis en mode mosaïque le client est seulement déplacé mais pas redimensionné - le client
size restera la taille flottante. La seule raison de redimensionner le client est de s'assurer
qu'il rentre dans son carreau. Si aucun argument n'est donné, le mode pseudotile est basculé.

arbre_objet [PATH]
Imprime l'arbre des objets. Si le chemin de l'objet PATH est donné, seul le sous-arbre
à partir de PATH est imprimé. Voir le OBJETS pour plus de détails.

attr [PATH [NOUVELLE VALEUR]
Imprime les enfants et les attributs de l'objet donné adressé par PATH. Si PATH is
un attribut, puis imprimez la valeur de l'attribut. Si NOUVELLE VALEUR est donné, attribuer NOUVELLE VALEUR à
l'attribut donné par PATH. Voir l' OBJETS pour plus de détails.

get_attr ATTRIBUT
Imprimer la valeur du spécifié ATTRIBUT comme décrit dans le OBJETS .

set_attr ATTRIBUT NOUVELLE VALEUR
Attribuer NOUVELLE VALEUR à l'spécifié ATTRIBUT comme décrit dans le OBJETS .

nouveau_attr [bool|Couleur|int|un magnifique|uint] PATH
Crée un nouvel attribut avec le nom et dans l'objet spécifié par PATH. Son genre est
spécifié par le premier argument. Le nom de l'attribut doit commencer par my_.

supprimer_attr PATH
Supprime l'attribut défini par l'utilisateur PATH.

remplacer IDENTIFICATEUR ATTRIBUT COMMAND [ARGS ...]
Remplace toutes les occurrences exactes de IDENTIFICATEUR in COMMAND et le ARGS par la valeur de
le ATTRIBUT. Notez que le COMMAND est également remplacé par la valeur de l'attribut s'il
équivaut à IDENTIFICATEUR. La commande remplacée avec ses arguments est alors exécutée. Exemple:

· remplacer MYTITLE clients.focus.title echo MYTITLE

Imprime le titre de la fenêtre actuellement sélectionnée.

sprintf IDENTIFICATEUR Format [CARACTÉRISTIQUES ...] COMMAND [ARGS ...]
Remplace toutes les occurrences exactes de IDENTIFICATEUR in COMMAND et le ARGS par la corde
spécifié par Format. Chaque %s dans Format représente la valeur de l'attribut suivant dans
CARACTÉRISTIQUES, semblable à la printf(1) commande. La commande remplacée avec ses arguments
puis est exécuté. Exemples:

· sprintf STR title=%s clients.focus.title echo STR

Imprime le titre de la fenêtre actuellement focalisée précédé de title=.

· sprintf X tag=%s tags.focus.name règle une fois X

Déplace le client suivant qui apparaît vers la balise actuellement ciblée.

· sprintf X %s/%s tags.focus.index tags.count echo X

Indique quelle balise est ciblée et combien de balises il y a

· sprintf l somelongstring echo lll

Imprime une chaîne longue trois fois, séparées par des espaces.

mktemp [bool|int|un magnifique|uint] IDENTIFICATEUR COMMAND [ARGS ...]
Crée un attribut temporaire avec le type donné et remplace toutes les occurrences de
IDENTIFICATEUR in COMMAND ainsi que ARGS by par le chemin de l'attribut temporaire. Le remplacé
La commande avec ses arguments est alors exécutée. Le statut de sortie de COMMAND Est retourné.

comparer ATTRIBUT OPÉRATEUR VALEURE
Compare la valeur de ATTRIBUT avec VALEURE en utilisant la méthode de comparaison OPÉRATEUR. Si
la comparaison réussit, elle renvoie 0, sinon 1. Les opérateurs sont :

· =: ATTRIBUTla valeur de est égale VALEURE

· !=: ATTRIBUTla valeur de n'est pas égale VALEURE

· le: ATTRIBUTvaleur de <= VALEURE

· lt: ATTRIBUTvaleur de VALEURE

· ge: ATTRIBUTvaleur de >= VALEURE

· gt: ATTRIBUTvaleur de > VALEURE

La Les opérateurs le,lt,ge,gt ne peut être utilisé que si ATTRIBUT est du type entier ou
entier non signé. Notez que le premier paramètre doit toujours être un attribut et le
seconde une valeur constante. Si vous souhaitez comparer deux attributs, utilisez le substitut
commander:

remplacer les balises FC.focus.frame_count \
comparer tags.focus.client_count gt FC

Il renvoie le succès s'il y a plus de clients sur la balise ciblée que de cadres.

obtenir Nom
Obtient la valeur de la variable d'environnement Nom.

Setenv Nom VALEURE
Définir la valeur de la variable d'environnement Nom à VALEURE.

indéfini Nom
Désactive la variable d'environnement Nom.

REGLAGES

Les paramètres configurent le comportement de herbstluftwm et peuvent être contrôlés via le set, obtenez
ainsi que basculer commandes. Il existe deux types de paramètres : les chaînes et les valeurs entières. Une
valeur entière est définie, si sa valeur est 1 ou une autre valeur différente de 0. Une valeur entière est
non défini, si sa valeur est 0.

frame_gap (entier)
L'écart entre les images en mode mosaïque.

frame_padding (entier)
Le remplissage à l'intérieur d'un cadre en mode mosaïque, c'est-à-dire l'espace entre la bordure d'un
cadre et les fenêtres qu'il contient.

window_gap (entier)
L'espace entre les fenêtres dans un cadre en mode mosaïque.

snap_distance (entier)
Si un client est déplacé en mode flottant, il s'accroche aux clients voisins si le
la distance entre eux est plus petite que snap_distance.

snap_gap (entier)
Spécifie l'espace restant si un client déplacé s'accroche à un bord en mode flottant. Si
snap_gap est défini sur 0, aucun espace ne restera.

mouse_recenter_gap (entier)
Spécifie l'espace autour d'un moniteur. Si le moniteur est sélectionné et la position de la souris
serait restauré dans cet espace, il est placé au centre du moniteur. C'est
utile, lorsque le moniteur a été laissé par le mouvement de la souris, mais est resélectionné par le clavier.
Si l'écart est de 0 (par défaut), la souris n'est jamais recentrée.

frame_border_active_color (Chaîne/Couleur)
La couleur de bordure d'un cadre focalisé.

frame_border_normal_color (Chaîne/Couleur)
La couleur de bordure d'un cadre flou.

frame_border_inner_color (Chaîne/Couleur)
La couleur de la bordure intérieure d'un cadre.

frame_bg_active_color (Chaîne/Couleur)
La couleur de remplissage d'une image focalisée.

frame_bg_normal_color (Chaîne/Couleur)
La couleur de remplissage d'un cadre non focalisé (elle n'est visible que si always_show_frame est défini).

frame_bg_transparent (Entier)
S'il est défini, l'arrière-plan des cadres est transparent. Cela signifie qu'un rectangle est découpé
de l'intérieur de telle sorte que seule la bordure du cadre et une bande de largeur
frame_transparent_width peut être vu. Utiliser frame_active_opacity ainsi que frame_normal_opacity
pour une vraie transparence.

frame_transparent_width (entier)
Spécifie la largeur du cadre restant coloré avec frame_bg_active_color if
frame_bg_transparent est réglé.

frame_border_width (entier)
Largeur de bordure d'un cadre.

frame_border_inner_width (entier)
La largeur de la bordure intérieure d'un cadre. Doit être inférieur à frame_border_width, car
il n'ajoute pas à la largeur de la bordure du cadre mais en fait partie.

focus_crosses_monitor_boundaries (entier)
Si elle est définie, la commande de mise au point dépasse les limites du moniteur. S'il n'y a pas de client dans le
direction donnée pour la mise au point, le moniteur dans la direction spécifiée est mis au point.

raise_on_focus (entier)
Si défini, une fenêtre est levée si elle est focalisée. La valeur de ce paramètre n'est utilisée que dans
mode flottant.

raise_on_focus_temporarily (Entier)
Si défini, une fenêtre est levée temporairement si elle est focalisée sur sa balise. Temporairement dans
ce cas signifie que la fenêtre reviendra à sa position d'empilement précédente si
une autre fenêtre est focalisée.

raise_on_click (entier)
S'il est défini, une fenêtre est levée si l'on clique dessus. La valeur de ce paramètre est seulement remarquée
en mode flottant.

window_border_width (entier)
Largeur de bordure d'une fenêtre.

window_border_inner_width (entier)
La largeur de la bordure intérieure d'une fenêtre. Doit être inférieur à window_border_width,
car il n'ajoute pas à la largeur de la bordure de la fenêtre mais en fait partie.

window_border_active_color (Chaîne/Couleur)
Couleur de bordure d'une fenêtre ciblée.

window_border_normal_color (Chaîne/Couleur)
Couleur de bordure d'une fenêtre floue.

window_border_urgent_color (Chaîne/Couleur)
Couleur de bordure d'une fenêtre floue mais urgente.

window_border_inner_color (Chaîne/Couleur)
Couleur de la bordure intérieure d'une fenêtre.

always_show_frame (entier)
S'il est défini, tous les cadres sont affichés. S'il n'est pas défini, seules les images avec focus ou avec des fenêtres dans
il sont affichés.

frame_active_opacity (entier)
Opacité du cadre focalisé en pourcentage. Nécessite un gestionnaire de composition en cours d'exécution pour prendre
effet réel.

frame_normal_opacity (entier)
Opacité du cadre non focalisé en pourcentage. Nécessite un gestionnaire de composition en cours d'exécution pour prendre
effet réel.

default_frame_layout (Entier)
Index de la disposition du cadre, qui est utilisé si un nouveau cadre est créé (par scission ou sur un
nouvelle étiquette). Pour une liste des indices valides et leurs significations, consultez la liste des mises en page
algorithmes ci-dessus.

default_direction_external_only (Entier)
Ce paramètre contrôle le comportement de la mise au point et du décalage si aucun -e or -i l'argument est
donné. s'il est défini, la mise au point et le décalage changent le cadre mis au point même s'il y a d'autres
clients dans ce cadre dans le DIRECTION. Sinon, un client dans le cadre actuel
est sélectionné s'il est dans le DIRECTION.

gapless_grid (entier)
Ce paramètre affecte la taille du dernier client dans un cadre organisé par grille
disposition. S'il est défini, le dernier client remplit toujours l'espace dans ce cadre. S'il n'est pas réglé,
alors le dernier client a la même taille que tous les autres clients de cette trame.

smart_frame_surroundings (entier)
S'il est défini, les bordures et les espaces du cadre seront supprimés lorsqu'il n'y a aucune ambiguïté concernant le
cadre focalisé.

smart_window_surroundings (entier)
Si défini, les bordures de fenêtre et les espaces seront supprimés et minimes lorsqu'il n'y a pas d'ambiguïté
concernant la fenêtre focalisée. Cette décoration de fenêtre minimale peut être configurée par le
theme.objet minimal.

focus_follows_mouse (entier)
Si défini et qu'une fenêtre est focalisée par le curseur de la souris, cette fenêtre est focalisée (cette fonctionnalité
est également connu sous le nom de mise au point bâclée). S'il n'est pas défini, vous devez cliquer pour modifier le focus de la fenêtre
par la souris.

Si une autre fenêtre est masquée par le changement de focus (par exemple lors d'une pseudo-fenêtre
dans la mise en page max), un clic supplémentaire est nécessaire pour modifier la mise au point.

focus_stealing_prevention (entier)
S'il est défini, seuls les téléavertisseurs et les barres des tâches sont autorisés à modifier le focus. S'il n'est pas défini, tous
les applications peuvent demander un changement de focus.

monitors_locked (entier)
S'il est supérieur à 0, les clients sur tous les moniteurs ne sont plus déplacés ou redimensionnés.
S'il est défini sur 0, la disposition des moniteurs est à nouveau activée et tous les moniteurs
sont réorganisés si leur contenu a changé entre-temps. Tu ne devrais pas changer
ce paramètre manuellement en raison de problèmes de simultanéité ; utiliser les commandes bloquer ainsi que ouvrir
à la place.

swap_monitors_to_get_tag (entier)
Si défini : si vous souhaitez afficher une étiquette qui est déjà affichée sur un autre moniteur, le
le contenu du moniteur sera échangé et vous verrez la balise recherchée sur le moniteur ciblé. Si
pas défini, l'autre moniteur est mis au point s'il affiche la balise souhaitée.

auto_detect_monitors (entier)
Si défini, detect_monitors est automatiquement exécuté à chaque fois qu'un moniteur est connecté,
déconnecté ou redimensionné.

tree_style (chaîne)
Il contient les caractères qui sont utilisés pour imprimer un bel arbre ascii. Il doit contenir au
au moins 8 caractères. par exemple X|:#+*-. produit un arbre comme :

X-.racine
#-. enfant 0
| #-* enfant 01
| +-* enfant 02
+-. enfant 1
: #-* enfant 10
: +-* enfant 01

Valeurs utiles pour style_arbre sont : ╾│ ├└╼─┐ ou -| |'--. ou ├╰╼─╮.

wmname (chaîne)
Il contrôle la valeur de la propriété _NET_WM_NAME sur la fenêtre racine, qui spécifie
le nom du gestionnaire de fenêtres en cours d'exécution. La valeur de ce paramètre n'est pas mise à jour si
la propriété _NET_WM_NAME réelle sur la fenêtre racine est modifiée en externe. Exemple
usage:

· cycle_value wmname herbstluftwm LG3D

pseudotile_center_threshold (Int)
Si supérieur à 0, il spécifie la plus petite distance entre un pseudotuile centré
fenêtre et la bordure du cadre ou du carreau auquel elle est affectée. Si cette distance est
plus bas que pseudotile_center_threshold, il est aligné en haut à gauche du client
tuile.

update_dragged_clients (entier)
S'il est défini, le contenu de la fenêtre d'un client est redimensionné immédiatement lors du redimensionnement avec le
Souris. S'il n'est pas défini, le contenu du client est redimensionné après le relâchement du bouton de la souris.

DES RÈGLES

Les règles sont utilisées pour modifier les propriétés par défaut de certains clients lorsqu'elles apparaissent. Chaque
la règle correspond à un certain sous-ensemble de tous les clients et définit un ensemble de propriétés pour
eux (appelé CONSÉQUENCEs). Une règle peut être définie avec cette commande :

régner [[--]FLAG|[--]LABEL|[--]CONDITION|[--]CONSÉQUENCE ...]

Chaque règle consiste en une liste de FLAGs, CONDITIONs, CONSÉQUENCEs et, éventuellement, un LABEL.
(chacun d'entre eux peut éventuellement être préfixé de deux tirets (--) pour fournir un plus
iptables(8)-comme sentiment).

Chaque règle peut recevoir une étiquette personnalisée en spécifiant le LABEL propriété:

· [--]libellé=VALEURE

Si plusieurs étiquettes sont spécifiées, la dernière de la liste sera appliquée. Si aucune étiquette n'est
donné, alors la règle recevra un nom entier qui représente l'index de la règle
depuis le dernier incontrôlable -F commande (qui est déclenchée dans le démarrage automatique par défaut).

Conseil
Les étiquettes de règle sont par défaut un index incrémentiel. Ces étiquettes par défaut sont uniques, sauf si
vous attribuez à une règle différente un entier personnalisé LABEL. Les étiquettes par défaut peuvent être capturées
les Imprimer l'étiquette drapeau.

Si un nouveau client apparaît, herbstluftwm essaie d'appliquer chaque règle à ce nouveau client comme
suit : si chaque CONDITION de cette règle correspond à ce client, alors chaque
CONSÉQUENCE est exécuté. (Si aucune condition n'est donnée, alors cette règle est exécutée pour
chaque client)

Chaque CONDITION est constitué d'un propriété nom, un opérateur et un Plus-value. Les opérateurs valides sont :

· ~ correspond si le client propriété correspond à la regex Plus-value.

· = correspond si client correctement la chaîne est égale à Plus-value.

Valide propriétés sont:

instance
la première entrée dans WM_CLASS du client.

classe
la deuxième entrée dans WM_CLASS du client.

titre
titre de la fenêtre du client.

Pid
l'identifiant du processus du client (Attention : le pid n'est pas disponible pour chaque client. Ceci seulement
correspond si le client définit _NET_WM_PID sur le pid lui-même).

maximum
correspond si l'âge de la règle mesuré en secondes ne dépasse pas Plus-value. Ce
la condition ne peut être utilisée qu'avec l'opérateur =. Si maxage est déjà dépassé (et
ne correspondra plus jamais), alors cette règle est supprimée. (Avec cela, vous pouvez créer des règles
qui ne vivent qu'un certain temps.)

type de fenêtre
correspond à la propriété _NET_WM_WINDOW_TYPE d'une fenêtre.

fenêtre
correspond à la propriété WM_WINDOW_ROLE d'une fenêtre si elle est définie par la fenêtre.

Chaque CONSÉQUENCE est constitué d'un Nom=VALEURE paire. Valide DES NOMS sont:

Étiquette
déplace le client vers le tag VALEURE.

moniteur
déplace le client vers la balise sur le moniteur VALEURE. Si la conséquence de la balise était également
spécifié et que switchtag est défini pour le client, déplacez le client vers cette balise, puis
afficher cette balise sur le moniteur VALEURE. Si la conséquence du tag a été spécifiée, mais switchtag
n'était pas, ignorez cette conséquence.

concentration
décide si le client obtient le focus d'entrée sur sa balise. La valeur par défaut est de rabais. VALEURE
peuvent être on, de rabais or basculer.

commutateur
si le focus est activé et que le client est placé sur une balise non focalisée, alors switchtag dit
si le tag du client sera affiché ou non. Si l'étiquette est affichée sur n'importe quel moniteur mais
n'est pas focalisé, la balise du client est uniquement portée au moniteur actuel si
swap_monitors_to_get_tag est activé. VALEURE peuvent être on, de rabais or basculer.

gérer
décide si le client sera géré ou non. La valeur par défaut est on. VALEURE peuvent être
on, de rabais or basculer.

indice
déplace la fenêtre vers un index spécifié dans l'arborescence. VALEURE est une cadre indice.

pseudotuile
définit l'état de pseudotile du client. VALEURE peuvent être on, de rabais or basculer.

ewmhdemandes
définit si l'état de la fenêtre (l'état plein écran et l'indicateur d'attention des demandes)
peut être modifié par l'application via ewmh elle-même. Cela n'affecte pas le premier
état plein écran demandé par la fenêtre. VALEURE peuvent être on, de rabais or basculer, c'est par défaut
à on.

ewmhnotifier
définit si hlwm doit informer le client des changements EMWH (actuellement, seul le
état plein écran). Si cela est défini, les applications ne passent pas en mode plein écran
tout en restant en plein écran. VALEURE peuvent être on, de rabais or basculer, il est par défaut on.

plein écran
définit l'indicateur plein écran du client. VALEURE peuvent être on, de rabais or basculer.

crochet
émet la règle de hook personnalisée VALEURE IDWIN lorsque cette règle est déclenchée par une nouvelle fenêtre
avec l'identifiant IDWIN. Cette conséquence peut être utilisée plusieurs fois, ce qui entraînera une
hook à émettre pour chaque occurrence d'une conséquence de hook.

masque de clé
Définit le masque de clé pour un client. Un masque de clé est une expression régulière qui correspond
contre la représentation de chaîne (voir list_keybinds). Si cela correspond, le raccourci clavier est
actif lorsque ce client est focalisé, sinon il est désactivé. Le masque de touche par défaut est
une chaîne vide (""), qui ne désactive aucune combinaison de touches.

Le comportement d'une règle peut être configuré par certains DRAPEAUX:

· non : annule le suivant CONDITION.

· ! : idem que non.

· une fois : n'appliquez cette règle qu'une seule fois (et supprimez-la ensuite).

· printlabel : imprime l'étiquette de la règle nouvellement créée sur stdout.

· préfixer : ajouter la règle à la liste des règles au lieu de l'ajouter. Alors c'est
les conséquences peuvent être écrasées par des règles déjà existantes.

Exemples :

· règle --class=Netscape --tag=6 --focus=off

Déplace toutes les instances de Netscape vers la balise 6, mais ne leur donne pas le focus.

· règle non classe~.*[Tt]erm tag=2

Déplace tous les clients vers la balise 2, si leur classe ne se termine pas par term ou Term.

· classe de règle=index Thunderbird=/0

Insérez toutes les instances Thunderbird dans l'arborescence qui n'a pas de focus et là dans la première
enfant.

· règle --windowtype=_NET_WM_WINDOW_TYPE_DIALOG --focus=on

Définit le focus sur les nouvelles boîtes de dialogue qui définissent correctement leur _NET_WM_WINDOW_TYPE.

FENÊTRE IDS

Plusieurs commandes acceptent une fenêtre comme référence, par exemple fermer. La syntaxe est la suivante :

· une chaîne vide — ou un argument manquant — fait référence à la fenêtre actuellement focalisée.

· urgent fait référence à une fenêtre urgente.

· 0 foisHEXIDE - où HEXIDE est un nombre hexadécimal — référence la fenêtre avec
L'identifiant de la fenêtre X11 hexadécimal est HEXIDE.

· DÉCIDER - où DÉCIDER est un nombre décimal — référence la fenêtre avec le nombre décimal
Identifiant de la fenêtre X11 DÉCIDER.

OBJETS

L'arborescence des objets n'est pas encore stable, c'est-à-dire que son interface peut changer jusqu'à la prochaine stable
Libération. Vérifiez donc à nouveau cette documentation après la prochaine mise à niveau.

L'arborescence d'objets est une collection d'objets avec des attributs similaires à / sys connu de la
Noyau Linux. De nombreuses entités (comme les balises, les moniteurs, les clients, ...) ont des objets auxquels accéder
directement leurs attributs. L'arbre est imprimé par la commande object_tree et ressemble plus
ou moins comme suit :

$ arbre_objet herbstclient
??
balises
├─┐ par nom
│ ├─╼ 1
│ ...
│ └─╼ 9
└─╼ se concentrer
clients
├─╼ 0x1400022
└─╼ se concentrer
moniteurs
par nom
concentration

Pour imprimer un sous-arbre commençant à un certain objet, passez le PATH de l'objet à
arbre_objet. L'object PATH est le chemin utilisant le séparateur . (point), par exemple tags.by-name :

$ herbstclient object_tree tags.by-name.
╾─┐ tags.by-name.
1
2

9

Pour interroger tous les attributs et enfants d'un objet, transmettez son PATH attr:

$ balises d'attr herbstclient.
2 enfants:
de nom.
concentrer.

1 attributs :
.---- taper
| .-- inscriptible
VV
u - compter = 9

$ herbstclient attr tags.focus.
0 enfants.
6 attributs :
.---- taper
| .-- inscriptible
VV
nom sw = "1"
pc flottant = faux
je - frame_count = 2
je - nombre_clients = 1
je - curframe_windex = 0
je - curframe_wcount = 1

Cela donne déjà une intuition de la sortie : attr répertorie d'abord les noms de l'enfant
objets puis tous les attributs, indiquant pour chaque attribut :

· son genre

· s pour chaîne

· i pour entier

· b pour booléen

· u pour entier non signé

· s'il est accessible en écriture par l'utilisateur : w si oui, - sinon.

· le nom de l'attribut

· sa valeur actuelle (seulement entre guillemets pour les chaînes)

Pour obtenir la valeur sans guillemets d'un certain attribut, adressez-vous à l'attribut en utilisant le même
syntaxe comme pour les chemins d'objets et transmettez-la à attr ou get_attr :

$ herbstclient attr clients.focus.title
herbstluftwm.txt = (~/dev/c/herbstluftwm/doc) - VIGUEUR
$ herbstclient get_attr clients.focus.title
herbstluftwm.txt = (~/dev/c/herbstluftwm/doc) - VIGUEUR

Pour modifier une valeur d'attribut accessible en écriture, transmettez la nouvelle valeur à attr ou à set_attr :

$ herbstclient attr tags.focus.floating
non
$ herbstclient attr tags.focus.floating true
$ herbstclient attr tags.focus.floating
oui
$ herbstclient set_attr tags.focus.floating faux
$ herbstclient attr tags.focus.floating
non

Il suffit de regarder autour de vous pour avoir une idée de ce qui s'y trouve. Le contenu détaillé de l'arborescence est répertorié comme
suit:

· tags : sous-arbre pour les tags.

??
│u - compter │ nombre de balises │
??

· indice: l'objet de la balise avec index indice.

· de nom

· TAG: un objet pour chaque balise avec le nom TAG

?? ??
│sw name │ nom du tag │
?? ??
│bw flottant │ s'il est en mode flottant │
?? ??
│i - index │ index de cette balise │
?? ??
│i - frame_count │ nombre d'images │
?? ??
│i - client_count │ nombre de clients sur cette balise │
?? ??
│i - curframe_windex index du client focalisé dans │
│ │ le cadre sélectionné │
?? ??
│i - curframe_wcount │ nombre de clients dans le │
│ │ cadre sélectionné │
?? ??

· focus : l'objet de la balise focalisée

· clients

· IDWIN: un objet pour chaque client avec son IDWIN

?? ??
│s - winid │ son identifiant de fenêtre │
?? ??
│s - titre │ son titre de fenêtre │
?? ??
│s - tag │ le tag sur lequel il est actuellement │
?? ??
│i - pid │ l'identifiant du processus (-1 si │
│ │ non réglé) │
?? ??
│s - classe │ la classe de celui-ci (deuxième entrée dans │
│ WM_CLASS) │
?? ??
│s - instance │ l'instance de celui-ci (première entrée │
│ dans WM_CLASS) │
?? ??
bw plein écran │ │
?? ??
│bw pseudotile │ │
?? ??
│bw ewmhrequests │ si les requêtes ewmh sont autorisées │
│ │ pour ce client │
?? ??
│bw ewmhnotifier │ si le client est informé de son │
│ │ état via ewmh │
?? ??
│bw urgent │ son état urgent │
?? ??
bw sizehints_tiling │ si sizehints pour ce client │
doit être respecté dans le carrelage │
│ mode │
?? ??
bw sizehints_flaoting │ si sizehints pour ce client │
doit être respecté en flottant │
│ mode │
?? ??

· focus : l'objet du client focalisé, le cas échéant

· glissé : l'objet d'un client qui est glissé par la souris, le cas échéant. Voir le
documentation de la commande mousebind pour des exemples.

· moniteurs

??
│u - compter │ nombre de moniteurs │
??

· INDEX: un objet pour chaque moniteur avec son INDEX

· de nom

· Nom: un objet pour chaque moniteur nommé

??
│s - nom │ son nom │
??
│i - indice │ son indice │
??
│s - tag │ le tag actuellement affiché dessus │
??
b - lock_tag │ │
??

· focus : l'objet du moniteur focalisé

· paramètres a un attribut pour chaque paramètre. Voir REGLAGES pour une liste.

· le thème a des attributs pour configurer les décorations de fenêtre. thème et beaucoup de ses enfants
les objets ont les attributs suivants

?? ??
│iw border_width │ la largeur de base de la bordure │
?? ??
│iw padding_top │ largeur de bordure supplémentaire sur le │
│ haut │
?? ??
│iw padding_right à droite │
?? ??
│iw padding_bottom │ en bas │
?? ??
│iw padding_left et à gauche de la bordure │
?? ??
cw color │ la couleur de fond de base de │
│ │ la frontière │
?? ??
│iw inner_width │ largeur de la bordure autour du │
│ │ contenu des clients │
?? ??
│cw inner_color │ sa couleur │
?? ??
│iw external_width │ largeur d'une bordure supplémentaire │
│ près du bord │
?? ??
│cw external_color │ sa couleur │
?? ??
│cw background_color couleur derrière le contenu de la fenêtre │
│ │ visible au redimensionnement │
?? ??
│sw reset │ L'écriture de ceci réinitialise tout │
│ attribue à une valeur par défaut │
?? ??

couleur_interne/largeur_interne
couleur_extérieure/largeur_extérieure
╻
│
╮ border_width
│ │ couleur │ ┝ +
│ ┌──┷─────────────────────┐ │ ╯ padding_top
│====================....│ │
│ │== contenu de la fenêtre ==....│ │
│====================..╾──────── background_color
│ │.......................│ │
└────────────────────────┘ │ ⎱ border_width +
└──────────────────────────────┘ ⎰ padding_bottom

La définition d'un attribut de l'objet thème ne fait que propager la valeur au
attribut du pavage et de l'objet flottant.

· carrelage configure la décoration des clients carrelés, en définissant un de ses attributs
propage l'attribut respectif de l'enfant actif, normal et urgent
objets.

· active configure la décoration des clients ciblés et carrelés

· normal configure la décoration des clients flous et carrelés

· urgent configure la décoration des clients urgents et carrelés

· flottant se comporte de manière analogue au carrelage

· minimal se comporte de manière analogue au carrelage et configure ces décorations minimales
déclenché par smart_window_surroundings.

· active propage les valeurs d'attribut à tiling.active et flottant.active

· normal propage les valeurs d'attribut à tile.normal et flottant.normal

· urgent propage les valeurs d'attribut à tiling.urgent et floating.urgent

DÉMARRAGE AUTOMATIQUE DOSSIER

Il n'y a pas de fichier de configuration mais un fichier de démarrage automatique, qui est exécuté au démarrage. Il est
également exécuté sur commande Recharger. Si non spécifié par le --démarrage automatique argument, démarrage automatique
le fichier se trouve à $XDG_CONFIG_HOME/herbstluftwm/démarrage automatique ou au
~/.config/herbstluftwm/autostart. Normalement, il se compose de quelques Herbstclient appels. Si
l'exécution du fichier de démarrage automatique dans la maison d'un utilisateur échoue le fichier de démarrage automatique global (principalement
placé dans /etc/xdg/herbstluftwm/autostart) est exécuté comme solution de secours.

Pour une installation rapide, copiez le fichier de démarrage automatique par défaut dans ~/.config/herbstluftwm/.

HOOKS

Lors d'événements spéciaux, herbstluftwm émet des crochets (avec des paramètres). Vous pouvez recevoir ou
attends-les avec Herbstclient(1). Des crochets personnalisés peuvent également être émis avec le émettre_crochet
commander. Les hooks suivants sont émis par herbstluftwm lui-même :

plein écran [on|off] IDWIN ETAT
L'état plein écran de la fenêtre IDWIN a été changé en [on|off].

tag_changé TAG MONITOR
Le tag TAG a été sélectionné le MONITOR .

focus_changed IDWIN TITRE
La fenêtre IDWIN était concentré. Son titre de fenêtre est TITRE.

window_title_changed IDWIN TITRE
Le titre de la concentré la fenêtre a été changée. Son identifiant de fenêtre est IDWIN et son nouveau titre
is TITRE.

tag_flags
Les drapeaux (c'est-à-dire état urgent ou rempli) ont été modifiés.

tag_ajouté TAG
Une balise nommée TAG était ajouté.

tag_removed TAG
La balise nommée TAG a été éliminé.

urgent [marche|arrêt] IDWIN
L'état urgent du client avec donné IDWIN a été changé en [on|off].

exclure Nom IDWIN
Une fenêtre avec l'identifiant IDWIN est apparu qui a déclenché une règle avec pour conséquence
crochet =Nom.

Il existe également d'autres crochets utiles, qui ne seront jamais émis par herbstluftwm lui-même, mais
qui peut être émis avec le émettre_crochet commander:

quitter_panneau
Demande à un panneau de quitter. Le panel.sh par défaut se ferme sur ce hook. De nombreux scripts utilisent
ce crochet.

Recharger
Dit à tous les démons que le Autostart fichier est rechargé - et leur dit de quitter. Cette
crochet devrait être émis dans la première ligne de chaque Autostart fichier.

EMPILAGE

Chaque balise a sa propre pile de clients qui se trouvent sur cette balise. Similaire à l'EWMH
spécification chaque pile de balises contient plusieurs couches, de haut en bas :

· le client focalisé (si raise_on_focus_temporarily est activé)

· clients en plein écran

· clients normaux

· décorations de cadre

Tous les moniteurs sont gérés dans une grande pile qui se compose uniquement des piles du
balises visibles superposées. L'ordre d'empilement de ces moniteurs est indépendant
à partir de leurs index et peut être modifié à l'aide de la augmenter_moniteur commander. La pile actuelle
est illustré par le empiler commander.

EWMH

Dans la mesure du possible, herbstluftwm essaie d'être conforme à EWMH. Qui comprend:

· Des informations sur les noms de balises et les listes de clients sont fournies.

· Les fenêtres de bureau des environnements de bureau ne sont pas gérées et maintenues en dessous des autres
les fenêtres.

· Les demandes des clients comme se concentrer ne sont traitées que si le paramètre
focus_stealing_prevention est désactivé.

ENVIRONNEMENT VARIABLES

DISPLAY
Spécifie le DISPLAY à utiliser.

Utilisez herbstluftwm en ligne en utilisant les services onworks.net