noDE -- pekwm -- doc

PeKwm est un gestionnaire de fenêtre pour X développé par Claes Nästèn. PeKwm est extrèmement configurable, basé sur aewm++, proposant la navigation par onglets dans les fenêtres, les keychains, un menu éditable, des propriétés automatiques et une foule de fichiers de configs différents… je crois même que c'est le wm qui utilise le plus de fichiers de conf !

PekWM sur kiss0s

PekWM est très modulable et vous permettra de personnaliser votre session dans les moindres détails. afin de vous aider dans la prise en main de votre environnement, kiss0s intègre une session pré-configurée de PekWM avec un menu complet, une barre de tâche gérée par lxpanel et quelques raccourcis pour aller plus vite :)

les raccourcis claviers de la session PekWM sur kiss0s

trayer : la zone de notification indépendante

PekWM n'intègre pas de barre de tâche par défaut. afin de vous livrer un environnement un poil plus ergonomique, la session kiss0s intègre trayer qui permet d'avoir une zone de notification minimale. notez que cet ajout n'est pas indispensable à PeKwm et que vous pouvez désactiver son lancement depuis le fichier 'start' de la configuration PeKwm.

conky : afficher vos informations

kiss0s intègre conky dans chaque session de travail (sauf la session "originale" dwm). le fichier de configuration du conky pekwm est accessible depuis le menu pekwm:configuration:conky:éditer ou directement depuis son emplacmeent ~/.pekwm/conkyrc_pekwm

plus de détails à propos de conky avec un man conky.

installation

PeKwm est disponible dans les dépôts de la plupart des distribution Linux. la dernière version est pekwm-0.1.16 publiée le 2012-09-21.
pour les distributions basées sur Debian:

apt-get install pekwm pekwm-themes

mais vous pouvez également télécharger les sources depuis la page de dowload du site pekwm. puis appliquer la procédure de compilation classique : (il vous faudra cependant aller chercher quelques thèmes supplémentaires)

wget http://www.pekwm.org/projects/pekwm/files/pekwm-0.1.16.tar.bz2
tar xvjf pekwm-0.1.16.tar.bz2
cd pekwm-0.1.16/
./configure
make
make install

lancement

si vous utilisez gdm, PeKwm devrait apparaitre dans votre choix de session.
si vous utilisez startx, il suffit de rajouter à la fin de votre ~/.xinitrc:

#!/bin/bash
##############################
# ~/.xinitrc by arpinux 2011 #
##############################
 
## D-Bus ##
if which dbus-launch >/dev/null && test -z "$DBUS_SESSION_BUS_ADDRESS"; then
		eval "$(dbus-launch --sh-syntax --exit-with-session)"
fi
## trackpad ## tapbutton off by default ##
synclient VertTwoFingerScroll=1
synclient HorizTwoFingerScroll=1
synclient TapButton1=0
## dualscreen ## edit if needed ##
xrandr --output LVDS --mode 1024x768 --pos 0x0 --rotate normal --output VGA-0 --mode 1024x768 --pos 1024x0 --rotate normal
## panel ##
fbpanel &
## launch terminal deamon ##
urxvtd &
## mail-checker ##
sleep 4 && claws-mail --online &
## wallpaper ##
nitrogen --restore &
## launch WM ##
exec ck-launch-session pekwm

configuration

la configuration de PeKwm passe par l'édition de fichiers situés dans votre ~/.pekwm. il faut le créer

mkdir ~/.pekwm

puis copier les fichiers de configuration par défaut.
si vous avez installé pekwm depuis les sources (version 0.1.16) :

cp /usr/local/etc/pekwm/* ~/.pekwm/

si vous avez installé le paquet debian squeeze (version 0.1.12) :

cp /etc/pekwm/* ~/.pekwm/

lors de la première installation/lancement, vous n'aurez ni barre de tache, ni panel, ni icones sur le bureau… seulement un menu au clic droit sur le bureau. pour agrémenter un peu votre PeK, passons aux fichiers de configuration :

~/.pekwm/start

ce fichier joue le rôle du fichier autostart dans openbox: un script de lancement pour vos applications/préférences au démarrage de votre session. notez cependant que ce fichier sera relu à chaque rechargement de pekwm. il est donc conseillé de lancer vos applications depuis votre ~/.xinitrc.
vous pouvez néanmoins utiliser ce fichier pour lancer un script de fond d'écran aléatoire par exemple:

#!/bin/sh
# PekWM start file
# This file is a simple shell script; It gets run on pekwm startup, after 
# the theme and all config has loaded if it is set executable
# (chmod +x start).
#
# This is different from ~/.xinitrc because a normal configuration of 
# .xinitrc you'll run all commands, then launch the window manager last.
#
# It also gets re-run every time pekwm is restarted.
# 
# As for it's usefulness, well, it's up to you. I actually set my background
# from my start file; since it runs after the theme gets loaded, this 
# effectively overrides whatever's in the theme.
# 
# There's probably a few other good uses for it, too. I mainly pushed for it
# because when I was doing fluxbox's docs, people used to complain that there
# wasn't one, and I wanted to avoid that for pekwm. ;) --eyez
 
# change aléatoirement le fond d'écran depuis un dossier #
# nécessite feh '# apt-get install feh' #
find [adresse_du_dossier] -type f -name '*.jpg' -o -name '*.png' | shuf -n 1 | xargs feh --no-xinerama --bg-scale &

~/.pekwm/config

ce fichier correspond au config.xml chez openbox, ou le wmfsrc sur wmfs, mais en plus simplifié, étant donné que certaines variables seront configurés dans des fichiers annexes. c'est dans ce fichier que vous allez indiquer le nombre de bureau, ainsi que leurs noms, les adresses de fichiers de configuration, les propriétés des fenêtres… en voici un exemplaire commenté:

## emplacement des fichiers annexes à utiliser##
Files {
	Keys = "~/.pekwm/keys"
	Mouse = "~/.pekwm/mouse"
	Menu = "~/.pekwm/menu"
	Start = "~/.pekwm/start"
	AutoProps = "~/.pekwm/autoproperties"
	Theme = "/usr/share/pekwm/themes/default"
	Icons = "~/.pekwm/icons/"
}

## comportement des fenêtres lors du déplacement/redimensionnement ##
MoveResize {
	EdgeAttract = "10"        ## distance d'adhérance au bords en pixel
	EdgeResist = "10"         ## resistance des bords d'écran
	WindowAttract = "5"       ## distance d'adhérance entre fenêtres en pixel
	WindowResist = "5"        ## resistance des fenêtres
	OpaqueMove = "True"       ## dessiner les fenêtres lors du déplacement, mettre "False" pour augmenter la réactivité
	OpaqueResize = "False"    ## dessiner les fenêtres lors du redimensionnement
}
## propriétés des bureaux
Screen {
	Workspaces = "9"                          ## nombre de bureaux
	WorkspacesPerRow = "3"                    ## nombre de bureaux par colonne: "0" pour mettre en ligne.
	WorkspaceNames = "Main;Web;E-mail;Music;Work 05;Work 06;Work 07;Work 08;Work 09"  ## nom des bureaux
	ShowFrameList = "True"                    ## afficher la liste des fenêtres
	ShowStatusWindow = "True"                 ## afficher les informations sur la fenêtre
	ShowStatusWindowCenteredOnRoot = "False"  ## afficher les informations sur la fenêtre au centre de lécran
	ShowClientID = "False"                    ## affiche l'ID de la fenêtre
	ShowWorkspaceIndicator = "500"            ## temps déaffichage de la fenêtre d'information au changement de bureau
	PlaceNew = "True"       ## on tente de placer le nouveau client, si False, il apparait au coin supérieur gauche
	FocusNew = "True"       ## le nouveau client passe au premier plan

	TrimTitle = "..."               ## ce qui remplace le titre de la fenêtre quand la place manque
	FullscreenAbove = "True"        ## le client en plein écran est au premier plan
	FullscreenDetect = "True"       ## détecter les écrans lors d'un appel au fullscreen
	HonourRandr = "True"            ## lire les informations de Xrandr
	HonourAspectRatio = "True"      ## préserver le ration d'affichage des fenêtres
	EdgeSize = "1 1 1 1"            ## distance des bords de l'écran (haut bas gauche droite)
	EdgeIndent = "False"            ## les bords d'écran doivent-ils être réservés
	PixmapCacheSize = "20"          ## nombre d'image inutilisée à garder dans le cache
	DoubleClickTime = "250"         ## temps entre deux clics pour devenir un double-clic en ms

	## placement des fenêtres
	## options du Model:
	## Smart: tente de placer la fenêtre dans un espace inoccupé
	## MouseCentered: place le centre de la fenêtre sous le pointeur 
	## MouseTopLeft: place le coin supérieur gauche de la fenêtre sous le pointeur
	## MouseNotUnder: place la fenêtre au coin supérieur gauche de l'écran
	## CenteredOnParent: place la fenêtre au centre de leur fenêtre parent
	Placement {
		Model = "CenteredOnParent Smart MouseNotUnder"
		Smart {
			Row = "True"          ## utilise les lignes, si False, utilise les colonnes
			TopToBottom = "True"  ## placement du haut vers le bas
			LeftToRight = "True"  ## placement de la gauche vers la droite
			OffsetX = "0"         ## décallage horizontal du placement
			OffsetY = "0"         ## décallage vertical du placement
		}
	}

	## definir si une fenêtre doit avoir un nom unique dans la liste des fenêtres
	## si oui, le nom sera suivi d'un numéro
	UniqueNames  {
		SetUnique = "False" ## utiliser l'option nom unique
		Pre = " #"          ## texte à placer devant le numéro de fenêtre
		Post = ""           ## texte à placer après le numéro de la fenêtre
	}
}

## configuration du menu
Menu {
	DisplayIcons = "True"  ## afficher les icones de menu

	Icons = "DEFAULT" {    ## taille des icones en pixel du menu "DEFAULT"
		Minimum = "16x16"
		Maximum = "16x16"
	}

	# pour avoir des icones de tailles différentes dans d'autres menus,
	# par exemple le menu wallpaper, utiliser cette syntaxe pour chaque
	# que vous voulez "libérer".

	# Icons = "Wallpaper" {
	#     Minimum = "64x64"
	#     Maximum = "64x64"
	# }

	# Definition du comportement de la souris sur les items de menu:
	# valeurs possibles: "ButtonPress ButtonRelease DoubleClick Motion"
	# pour avoir les sous-menus qui s'ouvrent au passage du pointeur,
	# commenter la ligne 'Enter', décommenter la ligne du dessous puis
	# relancer pekwm.
	
	Select = "Motion MotionPressed"       ## selection au survol
	Enter = "MotionPressed ButtonPress"   ## entrer au clic
	# Enter = "Motion"                    ## entrer au survol
	Exec = "ButtonRelease"                ## executer lors du relachement
}

## configuration du lanceur intégré
CmdDialog {
	HistoryUnique = "True"            ## eviter les répétitions dans l'historique des commandes
	HistorySize = "1024"              ## taille de l'historique
	HistoryFile = "~/.pekwm/history"  ## fichier de stockage de l'historique
	HistorySaveInterval = "16"        ## intervalle de sauvegarde dans le fichier history
}

## configuration du harbour pouvant inclure des dockapps
Harbour {
	OnTop = "True"              ## placer au-dessus
	MaximizeOver = "False"      ## masquer derrière les fenêtres maximisées 
	Placement = "Right"         ## position
	Orientation = "TopToBottom" ## orientation
	Head = "0"                  ## écran
	## configuration des dockapps
	DockApp {
		SideMin = "64"  ## taille minimale
		SideMax = "0"   ## taille maximale 0=illimitée
	}
}

~/.pekwm/keys

la configuration des raccourcis clavier et des chaines de raccourcis. en effet, pekwm gère les key-chains, une sorte de sous-menu de raccourcis clavier qui vous permettent d'augmenter considérablement le nombre de raccourcis possibles.
si vous modifiez ce fichier, assurez-vous de ne pas obtenir de doublons, pour cela, je vous conseille de commenter/désactiver tous les raccourcis inutiles avant de modifier ce fichier.

INCLUDE = "vars"

Global {
# - - ----------------------------------------------- - -
# configuration des raccourcis clavier.
# MOD1 pour Alt , Mod4 pour Super (touche logo)
# pour ajouter les votres, aller dans la section 
# 'Chaines'-'commandes externes' puis éditer les raccourcis.
	# se deplacer parmis les fenêtres
	KeyPress = "Mod1 Tab" { Actions = "NextFrame EndRaise" }               ## aller à la fenêtre suivante
	KeyPress = "Mod1 Shift Tab" { Actions = "PrevFrame EndRaise" }         ## aller à la fenêtre précédente
	KeyPress = "Mod1 Ctrl Tab" { Actions = "NextFrameMRU EndRaise" }       ## aller à la fenêtre suivante et lui laisser le focus
	KeyPress = "Mod1 Ctrl Shift Tab" { Actions = "PrevFrameMRU EndRaise" } ## aller à la fenêtre précédente et lui laisser le focus
	KeyPress = "Mod4 Tab" { Actions = "ActivateClientRel 1" }              ## aller à la fenêtres suivante dans un groupe de fenêtres
	KeyPress = "Mod4 Shift Tab" { Actions = "ActivateClientRel -1" }       ## aller à la fenêtres précédente dans un groupe de fenêtres
	KeyPress = "Mod4 Ctrl Right" { Actions = "MoveClientRel 1" }           ## deplacer la fenêtre vers la droite dans un groupe de fenêtres
	KeyPress = "Mod4 Ctrl Left" { Actions = "MoveClientRel -1" }           ## deplacer la fenêtre vers la gauche dans un groupe de fenêtres
	KeyPress = "Mod4 Left" { Actions = "FocusDirectional Left" }           ## déplace le focus vers la gauche
	KeyPress = "Mod4 Right" { Actions = "FocusDirectional Right" }         ## déplace le focus vers la droite
	KeyPress = "Mod4 Up" { Actions = "FocusDirectional Up" }               ## déplace le focus vers le haut
	KeyPress = "Mod4 Down" { Actions = "FocusDirectional Down" }           ## déplace le focus vers le bas
	# se déplacer dans les bureaux
	KeyPress = "Ctrl Mod1 Left" { Actions = "GotoWorkspace Left" }         ## aller au bureau de gauche
	KeyPress = "Ctrl Mod1 Right" { Actions = "GotoWorkspace Right" }       ## aller au bureau de droite
	KeyPress = "Ctrl Mod1 Up" { Actions = "GotoWorkspace Up" }             ## aller au bureau du haut
	KeyPress = "Ctrl Mod1 Down" { Actions = "GotoWorkspace Down" }         ## aller au bureau du bas
	KeyPress = "Mod4 1" { Actions = "GotoWorkspace 1" }                    ## aller au bureau numéro 1
	KeyPress = "Mod4 2" { Actions = "GotoWorkspace 2" }                    ## ... 2 ...
	KeyPress = "Mod4 3" { Actions = "GotoWorkspace 3" }
	KeyPress = "Mod4 4" { Actions = "GotoWorkspace 4" }
	KeyPress = "Mod4 5" { Actions = "GotoWorkspace 5" }
	KeyPress = "Mod4 6" { Actions = "GotoWorkspace 6" }
	KeyPress = "Mod4 7" { Actions = "GotoWorkspace 7" }
	KeyPress = "Mod4 8" { Actions = "GotoWorkspace 8" }
	KeyPress = "Mod4 9" { Actions = "GotoWorkspace 9" }
	KeyPress = "Ctrl Mod1 Shift Left" { Actions = "SendToWorkspace Next; GoToWorkspace Next" }   ## envoyer et suivre la fenêtre sur le bureau de gauche
	KeyPress = "Ctrl Mod1 Shift Right" { Actions = "SendToWorkspace Prev; GoToWorkspace Prev" }  ## envoyer et suivre la fenêtre sur le bureau de droite
	KeyPress = "Ctrl Mod1 Shift Up" { Actions = "SendToWorkspace NextV; GoToWorkspace NextV" }   ## envoyer et suivre la fenêtre sur le bureau du haut
	KeyPress = "Ctrl Mod1 Shift Down" { Actions = "SendToWorkspace PrevV; GoToWorkspace PrevV" } ## envoyer et suivre la fenêtre sur le bureau du bas
	KeyPress = "Mod4 F1" { Actions = "SendToWorkspace 1" }                 ## envoyer la fenêtre sur le bureau numero 1
	KeyPress = "Mod4 F2" { Actions = "SendToWorkspace 2" }                 ## ... 2 ...
	KeyPress = "Mod4 F3" { Actions = "SendToWorkspace 3" }
	KeyPress = "Mod4 F4" { Actions = "SendToWorkspace 4" }
	KeyPress = "Mod4 F5" { Actions = "SendToWorkspace 5" }
	KeyPress = "Mod4 F6" { Actions = "SendToWorkspace 6" }
	KeyPress = "Mod4 F7" { Actions = "SendToWorkspace 7" }
	KeyPress = "Mod4 F8" { Actions = "SendToWorkspace 8" }
	KeyPress = "Mod4 F9" { Actions = "SendToWorkspace 9" }
	# action de base sur les fenêtres
	KeyPress = "Mod4 M" { Actions = "Toggle Maximized True True" }  ## maximise/restaure la fenêtre
	KeyPress = "Mod4 G" { Actions = "Maxfill True True" }           ## active/desactive remplir l'espace disponible
	KeyPress = "Mod4 F" { Actions = "Toggle FullScreen" }           ## active/desactive le plein écran
	KeyPress = "Mod4 Return" { Actions = "MoveResize" }             ## active la foncion deplacer/redimensionner par le clavier
	KeyPress = "Mod4 Q" { Actions = "Close" }                       ## ferme la fenêtre
	KeyPress = "Mod4 S" { Actions = "Toggle Shaded" }               ## enroule/deroule la fenêtre
	KeyPress = "Mod4 I" { Actions = "Toggle Iconified" }            ## minimise/restaure la fenêtre
	# Marquage
	KeyPress = "Mod4 Z" { Actions = "Toggle Marked" }               ## marque/demarque la fenêtre
	KeyPress = "Mod4 A" { Actions = "AttachMarked" }                ## groupe toutes les fenêtres marquée à la fenêtre courante
	# Tagging
	KeyPress = "Mod4 T" { Actions = "Toggle Tagged False" }         ## ??
	# Menus
	KeyPress = "Mod4 R" { Actions = "ShowMenu Root" }               ## menu principal
	KeyPress = "Mod4 W" { Actions = "ShowMenu Window" }             ## menu client
	KeyPress = "Mod4 L" { Actions = "ShowMenu Goto" }               ## menu goto
	KeyPress = "Mod4 C" { Actions = "ShowMenu GotoClient" }         ## menu goto client
	KeyPress = "Mod4 Shift I" { Actions = "ShowMenu Icon" }         ## ??
	KeyPress = "Mod4 X" { Actions = "HideAllMenus" }                ## cache tous les menus
	# commandes externes
	KeyPress = "Mod4 E" { Actions = "Exec $TERM" }                  ## lance le terminal défini dans ~/.pekwm/vars
	# controle de PeKwm
	KeyPress = "Ctrl Mod1 Delete" { Actions = "Reload" }            ## relancer PeKwm
	KeyPress = "Mod4 D" { Actions = "ShowCmdDialog" }               ## lancer la commande rapide
	KeyPress = "Mod4 V" { Actions = "ShowSearchDialog" }            ## lancer la recherche rapide
	KeyPress = "Mod4 H" { Actions = "Toggle HarbourHidden" }        ## affiche/masque le harbour

# - - ----------------------------------------------- - -
# Chaines: elles vous donnent accès à absolument tout.
# certaines entrées sont doublées afin de pouvoir être accessibles des deux mains
	# deplacement sur les coins/bords de l'écran.
	Chain = "Ctrl Mod1 C" {                                            ## la chaine commence par Ctrl+Alt+c
		KeyPress = "Q" { Actions = "MoveToEdge TopLeft" }          ## vers le coin haut/gauche
		KeyPress = "Y" { Actions = "MoveToEdge TopCenterEdge" }    ## vers le haut/centre
		KeyPress = "W" { Actions = "MoveToEdge TopCenterEdge" }    ## ..
		KeyPress = "Shift Y" { Actions = "MoveToEdge TopEdge" }    ## vers le haut
		KeyPress = "Shift W" { Actions = "MoveToEdge TopEdge" }    ## ..
		KeyPress = "P" { Actions = "MoveToEdge TopRight" }         ## vers le coin haut/droite
		KeyPress = "E" { Actions = "MoveToEdge TopRight" }         ## ..
		KeyPress = "A" { Actions = "MoveToEdge LeftCenterEdge" }   ## vers la gauche/centre
		KeyPress = "Shift A" { Actions = "MoveToEdge LeftEdge" }   ## vers la gauche
		KeyPress = "L" { Actions = "MoveToEdge RightCenterEdge" }  ## vers la droite/centre
		KeyPress = "D" { Actions = "MoveToEdge RightCenterEdge" }  ## ..
		KeyPress = "Shift L" { Actions = "MoveToEdge RightEdge" }  ## vers la droite
		KeyPress = "Shift D" { Actions = "MoveToEdge RightEdge" }  ## ..
		KeyPress = "Z" { Actions = "MoveToEdge BottomLeft" }       ## vers le coin bas/gauche
		KeyPress = "B" { Actions = "MoveToEdge BottomCenterEdge" } ## vers le bas/centre
		KeyPress = "X" { Actions = "MoveToEdge BottomCenterEdge" } ## ..
		KeyPress = "Shift B" { Actions = "MoveToEdge BottomEdge" } ## vers le haut
		KeyPress = "Shift X" { Actions = "MoveToEdge BottomEdge" } ## ..
		KeyPress = "M" { Actions = "MoveToEdge BottomRight" }      ## vers le coin bas/droite
		KeyPress = "C" { Actions = "MoveToEdge BottomRight" }      ## ..
		KeyPress = "H" { Actions = "MoveToEdge Center" }           ## au centre
		KeyPress = "S" { Actions = "MoveToEdge Center" }           ## ..
	}
	# Menus
	Chain = "Ctrl Mod1 M" {                                             ## la chaine commence par Ctrl+Alt+m
		KeyPress = "R" { Actions = "ShowMenu Root" }                ## affiche le menu principal
		KeyPress = "W" { Actions = "ShowMenu Window" }              ## affiche le menu client
		KeyPress = "I" { Actions = "ShowMenu Icon" }                ## ??
		KeyPress = "G" { Actions = "ShowMenu Goto" }                ## affiche le menu goto
		KeyPress = "C" { Actions = "ShowMenu GotoClient" }          ## affiche le menu goto client
		KeyPress = "D" { Actions = "ShowMenu Decor" }               ## affiche le menu décoration
		KeyPress = "A" { Actions = "ShowMenu AttachClientInFrame" } ## affiche le menu grouper le client avec la fenêtre
		KeyPress = "F" { Actions = "ShowMenu AttachFrameInFrame" }  ## affiche le menu grouper le groupe
		Keypress = "Shift A" { Actions = "ShowMenu AttachClient" }  ## affiche le menu grouper le client
		Keypress = "Shift F" { Actions = "ShowMenu AttachFrame" }   ## affiche le menu grouper
		KeyPress = "X" { Actions = "HideAllMenus" }                 ## cache tous les menus
	}
	# grouper les clients
	Chain = "Ctrl Mod1 T" {                                            ## cette chaine commence par Ctrl+Alt+t
		KeyPress = "T" { Actions = "Toggle Tagged False" }         ## 
		KeyPress = "B" { Actions = "Toggle Tagged True" }          ##
		KeyPress = "C" { Actions = "Unset Tagged" }                ##
		KeyPress = "G" { Actions = "Toggle GlobalGrouping" }       ##
		KeyPress = "M" { Actions = "Toggle Marked" }               ## marque/demarque
		KeyPress = "A" { Actions = "AttachMarked" }                ## groupe les clients marqués
		KeyPress = "D" { Actions = "Detach" }                      ## détache
		Keypress = "P" { Actions = "AttachClientInNextFrame" }     ## attache le client dans le groupe suivant
		KeyPress = "O" { Actions = "AttachClientInPrevFrame" }     ## attache le client dans le groupe précédent
		Keypress = "I" { Actions = "AttachFrameInNextFrame" }      ## attache le groupe au groupe suivant
		KeyPress = "U" { Actions = "AttachFrameInPrevFrame" }      ## attache le groupe au groupe précédent
	}
	# aficher les décorations de fenêtres
	Chain = "Ctrl Mod1 D" {
		KeyPress = "B" { Actions = "Toggle DecorBorder" }                       ## affiche/masque les bordures
		KeyPress = "T" { Actions = "Toggle DecorTitlebar" }                     ## affiche/masque la barre de titre
		KeyPress = "D" { Actions = "Toggle DecorBorder; Toggle DecorTitlebar" } ## affiche/masque les décorations
	}
	# actions avancées sur les fenêtres
	Chain = "Ctrl Mod1 A" {
		Chain = "G" {
			KeyPress = "G" { Actions = "MaxFill True True" }           ## remplir l'espace horiz/vert libre
			KeyPress = "V" { Actions = "MaxFill False True" }          ## remplir l'espace vertical libre 
			KeyPress = "H" { Actions = "MaxFill True False" }          ## remplir l'espace horizontal libre
		}
		Chain = "M" {
			KeyPress = "M" { Actions = "Toggle Maximized True True" }  ## maximiser la fenêtre
			KeyPress = "V" { Actions = "Toggle Maximized False True" } ## maximiser verticalement
			KeyPress = "H" { Actions = "Toggle Maximized True False" } ## maximiser horizontalement
		}
		Chain = "Q" {
			KeyPress = "Q" { Actions = "Close" }           ## ferme le client
			KeyPress = "F" { Actions = "CloseFrame" }      ## ferme la fenêtre (client ou groupe de client)
			KeyPress = "K" { Actions = "Kill" }            ## tue (kill) le client
		}
		KeyPress = "S" { Actions = "Toggle Shaded" }           ## enroule/deroule la fenêtre
		KeyPress = "A" { Actions = "Toggle Sticky" }           ## active/desactive afficher sur tous les bureaux
		KeyPress = "O" { Actions = "Toggle AlwaysOnTop" }      ## active/desactive toujours au-dessus
		KeyPress = "B" { Actions = "Toggle AlwaysBelow" }      ## active/desactive toujours en-dessous
		KeyPress = "I" { Actions = "Set Iconified" }           ## minimise
		KeyPress = "R" { Actions = "Raise" }                   ## donne le focus
		KeyPress = "Shift R" { Actions = "Raise True" }        ## donne le focus et met au premier plan
		KeyPress = "L" { Actions = "Lower" }                   ## enlève le focus
		KeyPress = "Shift L" { Actions = "Lower True" }        ## enlève le focus et place au dernier plan
		KeyPress = "X" { Actions = "ActivateOrRaise" }         ## donne le focus ou met au premier plan
		KeyPress = "Return" { Actions = "MoveResize" }         ## deplace/redimensionne
		KeyPress = "F" { Actions = "Toggle Fullscreen" }       ## active/desactive le plein écran
		KeyPress = "Left" { Actions = "GrowDirection Left" }   ## agrandir la fenêtre vers la gauche
		KeyPress = "Right" { Actions = "GrowDirection Right" } ## agrandir la fenêtre vers la droite
		KeyPress = "Up" { Actions = "GrowDirection Up" }       ## agrandir la fenêtre vers le haut
		KeyPress = "Down" { Actions = "GrowDirection Down" }   ## agrandir la fenêtre vers le bas
	}
	# se déplacer dans un groupe de clients
	Chain = "Ctrl Mod1 F" {
		KeyPress = "P" { Actions = "NextFrame AlwaysRaise" }       ## aller au groupe de fenêtres suivant et le mettre au premier plan
		KeyPress = "O" { Actions = "PrevFrame AlwaysRaise" }       ## aller au groupe de fenêtres précédent et le mettre au premier plan

		KeyPress = "Shift P" { Actions = "NextFrameMRU EndRaise" } ## aller au groupe de fenêtres suivant et mettre le client au premier plan

		KeyPress = "Shift O" { Actions = "PrevFrameMRU EndRaise" } ## aller au groupe de fenêtres précédent et mettre le client au premier plan
		KeyPress = "I" { Actions = "ActivateClientRel 1" }         ## activer le client à droite
		KeyPress = "U" { Actions = "ActivateClientRel -1" }        ## activer le client à gauche
		KeyPress = "Shift I" { Actions = "MoveClientRel 1" }       ## déplacer le client vers la droite
		KeyPress = "Shift U" { Actions = "MoveClientRel -1" }      ## déplacer le client vers la gauche
		KeyPress = "Up" { Actions = "FocusDirectional Up" }        ## déplacer le focus vers le haut
		KeyPress = "Down" { Actions = "FocusDirectional Down" }    ## déplacer le focus vers le bas
		KeyPress = "Left" { Actions = "FocusDirectional Left" }    ## déplacer le focus vers la gauche
		Keypress = "Right" { Actions = "FocusDirectional Right" }  ## déplacer le focus vers la droite
		KeyPress = "1" { Actions = "ActivateClientNum 1" }         ## activer le client numéro 1
		KeyPress = "2" { Actions = "ActivateClientNum 2" }         ## ... 2 ...
		KeyPress = "3" { Actions = "ActivateClientNum 3" }         ##
		KeyPress = "4" { Actions = "ActivateClientNum 4" }         ##
		KeyPress = "5" { Actions = "ActivateClientNum 5" }         ##
		KeyPress = "6" { Actions = "ActivateClientNum 6" }         ##
		KeyPress = "7" { Actions = "ActivateClientNum 7" }         ##
		KeyPress = "8" { Actions = "ActivateClientNum 8" }         ##
		KeyPress = "9" { Actions = "ActivateClientNum 9" }         ##
		KeyPress = "0" { Actions = "ActivateClientNum 10" }        ##
		KeyPress = "C" { Actions = "ShowCmdDialog GotoClientID " } ## ??
	}
	# bureaux
	Chain = "Ctrl Mod1 W" {
		KeyPress = "Right" { Actions = "GoToWorkspace Right" }  ## aller au bureau de droite
		KeyPress = "Left" { Actions = "GoToWorkspace Left" }    ## aller au bureau de gauche
		KeyPress = "N" { Actions = "GoToWorkspace Next" }       ## aller au bureau suivant
		KeyPress = "P" { Actions = "GoToWorkspace Prev" }       ## aller au bureau précédent
		KeyPress = "1" { Actions = "GoToWorkspace 1" }          ## aller au bureau numéro 1
		KeyPress = "2" { Actions = "GoToWorkspace 2" }          ## ... 2 ...
		KeyPress = "3" { Actions = "GoToWorkspace 3" }
		KeyPress = "4" { Actions = "GoToWorkspace 4" }
		KeyPress = "5" { Actions = "GoToWorkspace 5" }
		KeyPress = "6" { Actions = "GoToWorkspace 6" }
		KeyPress = "7" { Actions = "GoToWorkspace 7" }
		KeyPress = "8" { Actions = "GoToWorkspace 8" }
		KeyPress = "9" { Actions = "GoToWorkspace 9" }
		KeyPress = "Up" { Actions = "SendToWorkspace Next; GoToWorkspace Next" }   ## envoyer et suivre la fenêtre au bureau suivant
		KeyPress = "Down" { Actions = "SendToWorkspace Prev; GoToWorkspace Prev" } ## envoyer et suivre la fenêtre au bureau précédent
		KeyPress = "F1" { Actions = "SendToWorkspace 1" }       ## envoyer au bureau numéro 1
		KeyPress = "F2" { Actions = "SendToWorkspace 2" }       ## ... 2 ...
		KeyPress = "F3" { Actions = "SendToWorkspace 3" }
		KeyPress = "F4" { Actions = "SendToWorkspace 4" }
		KeyPress = "F5" { Actions = "SendToWorkspace 5" }
		KeyPress = "F6" { Actions = "SendToWorkspace 6" }
		KeyPress = "F7" { Actions = "SendToWorkspace 7" }
		KeyPress = "F8" { Actions = "SendToWorkspace 8" }
		KeyPress = "F9" { Actions = "SendToWorkspace 9" }
	}
	# commandes externes
	Chain = "Ctrl Mod1 E" {
		KeyPress = "E" { Actions = "Exec $TERM" }               ## lance le terminal défini dans ~/.pekwm/vars
		KeyPress = "L" { Actions = "Exec xlock -mode blank &" } ## vérouille l'écran en noir
		KeyPress = "S" { Actions = "Exec scrot &" }             ## capture d'écran
		KeyPress = "C" { Actions = "ShowCmdDialog" }            ## lance la commande rapide
	}
	# actions sur le gestionnaire de fenêtres
	Chain = "Ctrl Mod1 P" {
		KeyPress = "Delete" { Actions = "Reload" }              ## recharger PeKwm
		KeyPress = "Next" { Actions = "Restart" }               ## redémarrer PeKwm
		KeyPress = "End" { Actions = "Exit" }                   ## quitter PeKwm
		KeyPress = "Prior" { Actions = "RestartOther twm" }     ## quitter PeKwm et basculer sur un autre WM
		KeyPress = "D" { Actions = "ShowCmdDialog" }            ## lancer la commande rapide
		KeyPress = "H" { Actions = "Toggle HarbourHidden" }     ## afficher/masquer le harbour
	}
	# Skipping
	Chain = "Ctrl Mod1 S" {
		Keypress = "M" { Actions = "Toggle Skip Menus" }        ##
		Keypress = "F" { Actions = "Toggle Skip FocusToggle" }  ##
		Keypress = "S" { Actions = "Toggle Skip Snap" }         ## active/desactive l'adherance
	}
}

# raccourcis actif lors de l'utilisation de 'MoveResize'
MoveResize {
	KeyPress = "Left" { Actions = "MoveHorizontal -10" }             ## deplace le client de 10px vers la gauche
	KeyPress = "Right" { Actions = "MoveHorizontal 10" }             ## deplace le client de 10px vers la droite
	KeyPress = "Up" { Actions = "MoveVertical -10" }                 ## deplace le client de 10px vers le haut
	KeyPress = "Down" { Actions = "MoveVertical 10" }                ## deplace le client de 10px vers le bas
	Keypress = "Shift Left" { Actions = "MoveHorizontal -1" }        ## deplace le client de 1px vers la gauche
	Keypress = "Shift Right" { Actions = "MoveHorizontal 1" }        ## deplace le client de 1px vers la droite
	Keypress = "Shift Up" { Actions = "MoveVertical -1" }            ## deplace le client de 1px vers le bas
	Keypress = "Shift Down" { Actions = "MoveVertical 1" }           ## deplace le client de 1px vers le haut
	Keypress = "Mod4 Left" { Actions = "ResizeHorizontal -10" }      ## redimensionne le client de 10px vers la gauche
	Keypress = "Mod4 Right" { Actions = "ResizeHorizontal 10" }      ## redimensionne le client de 10px vers la droite
	Keypress = "Mod4 Up" { Actions = "ResizeVertical -10" }          ## redimensionne le client de 10px vers le haut
	Keypress = "Mod4 Down" { Actions = "ResizeVertical 10" }         ## redimensionne le client de 10px vers le bas
	Keypress = "Mod1 Left" { Actions = "ResizeHorizontal -10" }      ## redimensionne le client de 10px vers la gauche
	Keypress = "Mod1 Right" { Actions = "ResizeHorizontal 10" }      ## redimensionne le client de 10px vers la droite
	Keypress = "Mod1 Up" { Actions = "ResizeVertical -10" }          ## redimensionne le client de 10px vers le haut
	Keypress = "Mod1 Down" { Actions = "ResizeVertical 10" }         ## redimensionne le client de 10px vers le bas
	Keypress = "Shift Mod4 Left" { Actions = "ResizeHorizontal -1" } ## redimensionne le client de 1px vers la gauche
	Keypress = "Shift Mod4 Right" { Actions = "ResizeHorizontal 1" } ## redimensionne le client de 1px vers la droite
	Keypress = "Shift Mod4 Up" { Actions = "ResizeVertical -1" }     ## redimensionne le client de 1px vers le haut
	Keypress = "Shift Mod4 Down" { Actions = "ResizeVertical 1" }    ## redimensionne le client de 1px vers le bas
	Keypress = "Shift Mod1 Left" { Actions = "ResizeHorizontal -1" } ## redimensionne le client de 1px vers la gauche
	Keypress = "Shift Mod1 Right" { Actions = "ResizeHorizontal 1" } ## redimensionne le client de 1px vers la droite
	Keypress = "Shift Mod1 Up" { Actions = "ResizeVertical -1" }     ## redimensionne le client de 1px vers le haut
	Keypress = "Shift Mod1 Down" { Actions = "ResizeVertical 1" }    ## redimensionne le client de 1px vers le bas
	Keypress = "s" { Actions = "MoveSnap" }                          ## deplace le client vers le bord le plus proche
	Keypress = "Escape" { Actions = "Cancel" }                       ## annule la chaine
	Keypress = "q" { Actions = "Cancel" }                            ## ..
	Keypress = "Return" { Actions = "End" }                          ## fin de la chaine
}

# raccourcis de la commande rapide
InputDialog {
	KeyPress = "Left" { Actions = "CursPrev" }                 ## deplacer le pointeur vers la gauche
	KeyPress = "Right" { Actions = "CursNext" }                ## deplacer le pointeur vers la droite
	KeyPress = "Ctrl A" { Actions = "CursBegin" }              ## deplacer le pointeur au debut
	KeyPress = "Ctrl E" { Actions = "CursEnd" }                ## deplacer le pointeur à la fin
	KeyPress = "BackSpace" { Actions = "Erase;CompleteAbort" } ## effacer, abandonner la commande
	KeyPress = "Ctrl K" { Actions = "ClearFromCursor" }        ## effacer depuis le pointeur
	KeyPress = "Ctrl C" { Actions = "Clear" }                  ## effacer la commande
	KeyPress = "Return" { Actions = "Exec" }                   ## executer la commande
	KeyPress = "Escape" { Actions = "Close" }                  ## fermer la commande rapide
	KeyPress = "Up" { Actions = "HistPrev" }                   ## montrer la commande précédente
	KeyPress = "Down" { Actions = "HistNext" }                 ## montrer la commande suivante
	KeyPress = "Ctrl P" { Actions = "HistPrev" }               ## montrer la commande précédente
	KeyPress = "Ctrl N" { Actions = "HistNext" }               ## montrer la commande suivante
		KeyPress = "Ctrl B" { Actions = "CursPrev" }               ## deplacer le pointeur vers la gauche
		KeyPress = "Ctrl F" { Actions = "CursNext" }               ## deplacer le pointeur vers la droite
		KeyPress = "Tab" { Actions = "Complete" }                  ## activer la completion automatique
	KeyPress = "Any Any" { Actions = "Insert" }                ## insérer
}

# touches pour les menus
Menu {
	KeyPress = "Down" { Actions = "NextItem" }       ## item suivant
	KeyPress = "Up" { Actions = "PrevItem" }         ## item précédent
	KeyPress = "Ctrl N" { Actions = "NextItem" }     ## item suivant
	KeyPress = "Ctrl P" { Actions = "PrevItem" }     ## item précédent
	KeyPress = "Left" { Actions = "LeaveSubmenu" }   ## sorir du le sous-menu
	KeyPress = "Right" { Actions = "EnterSubmenu" }  ## entrer dans le sous-menu
	KeyPress = "Return" { Actions = "Select" }       ## selectionner
	KeyPress = "space" { Actions = "Select" }        ## selectionner
	KeyPress = "Escape" { Actions = "Close" }        ## fermer
	KeyPress = "Q" { Actions = "Close" }             ## fermer
}

comme vous pouvez le constater, la syntaxe est plutôt simple à comprendre. il vous permet de contrôler l'intégralité de PeKwm depuis votre clavier.
:!: pensez à bien vérifier votre fichier pour éviter la présence de doublons lors de la modification.
ce fichier est complété par le fichier "mouse".

~/.pekwm/mouse

configuration des actions de la souris sur les fenêtres, le bureau, les menus...

## valeurs ##
## ButonPress:    un simple clic
## ButtonRelease: la commande est activée au relachement de clic
## DoubleClick:   double-clic
## Motion:        maintient du clic + déplacement
## Enter:         definir le comportement lors d'une entrée dans une zone d'action (bouton, zone de texte)
## Leave:         definir le comportement lors d'une sortie d'une zone d'action
## EnterMoving:   definir le comprtement lorsqu'une fenêtre est amenée au bord de l'écran
##
## boutons ##
## 1: clic gauche
## 2: clic central
## 3: clic droit
## 4: scroll vers le haut
## 5: scroll vers le bas
##
## actions de base ##
## Focus: donne le focus
## Raise: met au premier plan
## ActivateClient: active le client dans un groupe
## Move: deplace
## Resize: redimensionne
## Close: ferme
## 
############################
## debut de la configuration
############################
## actions sur la barre de titre des fenêtres classiques
FrameTitle {
	ButtonRelease = "1" { Actions = "Raise; Focus; ActivateClient" }  ## met au premier plan, donne le focus, active
	ButtonRelease = "Mod1 1" { Actions = "Focus; Raise" }             ## donne le focus, met au premier plan
	ButtonRelease = "Mod4 1" { Actions = "Focus; Raise" }             ## donne le focus, met au premier plan
	ButtonRelease = "2" { Actions = "ActivateClient" }                ## active le client
	ButtonRelease = "Mod4 3" { Actions = "Close" }                    ## fermer
	ButtonRelease = "3" { Actions = "ShowMenu Window" }               ## afficher le menu client
	ButtonRelease = "4" { Actions = "ActivateClientRel 1" }           ## active le client de droite dans un groupe
	ButtonRelease = "5" { Actions = "ActivateClientRel -1" }          ## active le client de gauche dans un groupe
	ButtonRelease = "Mod1 4" { Actions = "SendToWorkspace Next; GotoWorkspace Next" }         ## deplace et suit le client vers le bureau suivant
	ButtonRelease = "Mod1 5" { Actions = "SendToWorkspace Prev; GotoWorkspace Prev" }         ## deplace et suit le client vers le bureau suivant
	ButtonRelease = "Mod1 Shift 4" { Actions = "SendToWorkspace PrevV; GotoWorkspace PrevV" } ## deplace et suit le client vers le bureau vertical précédent
	ButtonRelease = "Mod1 Shift 5" { Actions = "SendToWorkspace NextV; GotoWorkspace NextV" } ## deplace et suit le client vers le bureau vertical suivant
	ButtonRelease = "Ctrl 4" { Actions = "MoveClientRel 1" }          ## deplace le client vers la droite dans un groupe
	ButtonRelease = "Ctrl 5" { Actions = "MoveClientRel -1" }         ## deplace le client vers la gauche dans un groupe
	ButtonRelease = "Ctrl Mod1 1" { Actions = "Focus; Raise True" }   ## donne le focus, garde au premier plan
	DoubleClick = "2" { Actions = "Toggle Shaded" }                   ## enroule/deroule
	DoubleClick = "Mod1 2" { Actions = "Toggle Shaded" }              ## enroule/deroule
	DoubleClick = "1" { Actions = "MaxFill True True" }               ## maximise
	DoubleClick = "Mod1 1" { Actions = "Toggle Maximized True True" } ## maximise/restaure
	Motion = "1" { Threshold = "4"; Actions = "Raise; Move" }         ## met au premier plan, deplace
	Motion = "Mod1 1" { Threshold = "4"; Actions = "Raise; Move" }    ## ..
	Motion = "Mod4 1" { Threshold = "4"; Actions = "Raise; Move" }    ## ..
	Motion = "2" { Threshold = "4"; Actions = "GroupingDrag True" }   ## grouper
	Motion = "Mod1 3" { Actions = "Resize" }                          ## redimensionne
	# commenter ou effacer la ligne suivante si vous désirez utiliser clic-to-focus
	Enter = "Any Any" { Actions = "Focus" }                           ## donne le focus au survol du pointeur
}

## actions sur la barre de titre d'autres fenêtres ( commande rapide, menu ..)
OtherTitle {
	ButtonRelease = "1" { Actions = "Raise; Focus" }                  ## donne le focus, met au premier plan
	ButtonRelease = "2" { Actions = "Focus" }                         ## donne le focus
	ButtonRelease = "3" { Actions = "Close" }                         ## ferme
	ButtonRelease = "Mod4 3" { Actions = "ShowMenu Window" }          ## affiche le menu client
	ButtonRelease = "Mod1 4" { Actions = "SendToWorkspace Next; GotoWorkspace Next" }         ## deplace et suit le client vers le bureau suivant
	ButtonRelease = "Mod1 5" { Actions = "SendToWorkspace Prev; GotoWorkspace Prev" }         ## deplace et suit le client vers le bureau précédent
	ButtonRelease = "Mod1 Shift 4" { Actions = "SendToWorkspace PrevV; GotoWorkspace PrevV" } ## deplace et suit le client vers le bureau vertical précédent
	ButtonRelease = "Mod1 Shift 5" { Actions = "SendToWorkspace NextV; GotoWorkspace NextV" } ## deplace et suit le client vers le bureau vertical suivant
	Motion = "1" { Threshold = "4"; Actions = "Raise; Move" }         ## met au premier plan, déplace
	Motion = "Mod1 1" { Threshold = "4"; Actions = "Raise; Move" }    ## ..
	Motion = "Mod4 1" { Threshold = "4"; Actions = "Raise; Move" }    ## ..
	# commenter ou effacer la ligne suivante si vous désirez utiliser clic-to-focus
	Enter = "Any Any" { Actions = "Focus" }                           ## donne le focus au survol du pointeur
}

## actions sur les bordures
Border {
	TopLeft {
		# Remove the following line if you want to use click to focus.
				## commenter ou effacer la ligne suivante si vous désirez utiliser clic-to-focus
		Enter = "Any Any" { Actions = "Focus" }
		ButtonPress = "1" { Actions = "Focus; Resize TopLeft" } }
	Top {
		# Remove the following line if you want to use click to focus.
		Enter = "Any Any" { Actions = "Focus" }
		ButtonPress = "1" { Actions = "Focus; Resize Top" } }
	TopRight {
		# Remove the following line if you want to use click to focus.
		Enter = "Any Any" { Actions = "Focus" }
		ButtonPress = "1" { Actions = "Focus; Resize TopRight" } }
	Left {
		# Remove the following line if you want to use click to focus.
		Enter = "Any Any" { Actions = "Focus" }
		ButtonPress = "1" { Actions = "Focus; Resize Left" } }
	Right {
		# Remove the following line if you want to use click to focus.
		Enter = "Any Any" { Actions = "Focus" }
		ButtonPress = "1" { Actions = "Focus; Resize Right" } }
	BottomLeft {
		# Remove the following line if you want to use click to focus.
		Enter = "Any Any" { Actions = "Focus" }
		ButtonPress = "1" { Actions = "Focus; Resize BottomLeft" } }
	Bottom {
		# Remove the following line if you want to use click to focus.
		Enter = "Any Any" { Actions = "Focus" }
		ButtonPress = "1" { Actions = "Focus; Resize Bottom" } }
	BottomRight {
		# Remove the following line if you want to use click to focus.
		Enter = "Any Any" { Actions = "Focus" }
		ButtonPress = "1" { Actions = "Focus; Resize BottomRight" } }
}

## actions sur les bords d'écran
ScreenEdge {
		## bord inférieur de l'écran
	Down {
		Enter = "Mod1 Any" { Actions = "GoToWorkspace Down" }        ## va au bureau du bas
		ButtonRelease = "3" { Actions = "ShowMenu Root" }            ## affiche le menu principal
		ButtonRelease = "2" { Actions = "ShowMenu Goto" }            ## affiche le menu goto
		ButtonRelease = "1" { Actions = "GoToWorkspace Down" }       ## va au bureau du bas
		ButtonRelease = "Mod4 2" { Actions = "ShowMenu GotoClient" } ## affiche le menu goto client
		ButtonRelease = "4" { Actions = "GoToWorkspace Up" }         ## va au bureau du haut
		ButtonRelease = "5" { Actions = "GoToWorkspace Down" }       ## va au bureau du bas
		ButtonRelease = "Mod1 4" { Actions = "GoToWorkspace PrevV" } ## va au bureau vertical précédent
		ButtonRelease = "Mod1 5" { Actions = "GoToWorkspace NextV" } ## va au bureau vertical suivant
		EnterMoving = "Any Any" { Actions = "WarpToWorkspace Down" } ## deplace et suit le client vers le bas
	}
		## bord supérieur de l'écran
	Up {
		Enter = "Mod1 Any" { Actions = "GoToWorkspace Up" }
		ButtonRelease = "3" { Actions = "ShowMenu Root" }
		ButtonRelease = "2" { Actions = "ShowMenu Goto" }
		ButtonRelease = "1" { Actions = "GoToWorkspace Up" }
		ButtonRelease = "Mod4 2" { Actions = "ShowMenu GotoClient" }
		ButtonRelease = "4" { Actions = "GoToWorkspace Up" }
		ButtonRelease = "5" { Actions = "GoToWorkspace Down" }
		ButtonRelease = "Mod1 4" { Actions = "GoToWorkspace PrevV" }
		ButtonRelease = "Mod1 5" { Actions = "GoToWorkspace NextV" }
		EnterMoving = "Any Any" { Actions = "WarpToWorkspace Up" }
	}
		## bord gauche de l'écran
	Left {
		Enter = "Mod1 Any" { Actions = "GoToWorkspace Left" }
		ButtonRelease = "3" { Actions = "ShowMenu Root" }
		ButtonRelease = "1" { Actions = "GoToWorkspace Left" }
		DoubleClick = "1" { Actions = "GoToWorkspace Left" }
		ButtonRelease = "2" { Actions = "ShowMenu Goto" }
		ButtonRelease = "Mod4 2" { Actions = "ShowMenu GotoClient" }
		ButtonRelease = "4" { Actions = "GoToWorkspace Right" }
		ButtonRelease = "5" { Actions = "GoToWorkspace Left" }
		ButtonRelease = "Mod1 4" { Actions = "GoToWorkspace Next" }
		ButtonRelease = "Mod1 5" { Actions = "GoToWorkspace Prev" }
		EnterMoving = "Any Any" { Actions = "WarpToWorkspace Left" }
	}
		## bord droit de l'écran
	Right {
		Enter = "Mod1 Any" { Actions = "GoToWorkspace Right" }
		ButtonRelease = "3" { Actions = "ShowMenu Root" }
		ButtonRelease = "1" { Actions = "GoToWorkspace Right" }
		DoubleClick = "1" { Actions = "GoToWorkspace Right" }
		ButtonRelease = "2" { Actions = "ShowMenu Goto" }
		ButtonRelease = "Mod4 2" { Actions = "ShowMenu GotoClient" }
		ButtonRelease = "4" { Actions = "GoToWorkspace Right" }
		ButtonRelease = "5" { Actions = "GoToWorkspace Left" }
		ButtonRelease = "Mod1 4" { Actions = "GoToWorkspace Next" }
		ButtonRelease = "Mod1 5" { Actions = "GoToWorkspace Prev" }
		EnterMoving = "Any Any" { Actions = "WarpToWorkspace Right" }
	}
}

## actions sur les clients (excepté la barre de titre)
Client {
	# commenter ou effacer la ligne suivante si vous désirez utiliser clic-to-focus
	ButtonPress = "1" { Actions = "Focus" }
	# décommenter la ligne suivante si vous désirez utiliser clic-to-focus
	# ButtonPress = "1" { Actions = "Focus; Raise" }

	ButtonRelease = "Mod1 1" { Actions = "Focus; Raise" }
	ButtonRelease = "Mod4 1" { Actions = "Lower" }
	ButtonRelease = "Mod1 4" { Actions = "SendToWorkspace Next; GotoWorkspace Next" }
	ButtonRelease = "Mod1 5" { Actions = "SendToWorkspace Prev; GotoWorkspace Prev" }
	ButtonRelease = "Mod1 Shift 4" { Actions = "SendToWorkspace PrevV; GotoWorkspace PrevV" }
	ButtonRelease = "Mod1 Shift 5" { Actions = "SendToWorkspace NextV; GotoWorkspace NextV" }
	ButtonRelease = "Ctrl Mod1 1" { Actions = "Focus; Raise True" }
	Motion = "Mod1 1" { Threshold = "4"; Actions = "Focus; Raise; Move" }
	Motion = "Mod4 1" { Threshold = "4"; Actions = "Focus; Raise; Move" }
	Motion = "Mod1 2" { Threshold = "4"; Actions = "GroupingDrag True" }
	Motion = "Mod1 3" { Actions = "Resize" }
	# commenter ou effacer la ligne suivante si vous désirez utiliser clic-to-focus.
	Enter = "Any Any" { Actions = "Focus" }
}

## actions sur le bureau
Root {
	ButtonRelease = "3" { Actions = "ShowMenu Root" }          ## menu principal lors du clic-droit sur le bureau
	ButtonRelease = "2" { Actions = "ShowMenu Goto" }
	ButtonRelease = "Mod4 2" { Actions = "ShowMenu GotoClient" }
	# Horizontal movement
	ButtonRelease = "4" { Actions = "GoToWorkspace Right" }
	ButtonRelease = "5" { Actions = "GoToWorkspace Left" }
	ButtonRelease = "Mod1 4" { Actions = "GoToWorkspace Next" }
	ButtonRelease = "Mod1 5" { Actions = "GoToWorkspace Prev" }
	# Vertical movement
	ButtonRelease = "Shift 4" { Actions = "GoToWorkspace Up" }
	ButtonRelease = "Shift 5" { Actions = "GoToWorkspace Down" }
	ButtonRelease = "Mod1 Shift 4" { Actions = "GoToWorkspace NextV" }
	ButtonRelease = "Mod1 Shift 5" { Actions = "GoToWorkspace PrevV" }
	ButtonRelease = "1" { Actions = "HideAllMenus" }
}

## actions sur les menus (excepté la barre de titre)
Menu {
	Enter = "Any Any" { Actions = "Focus" }
	Motion = "Mod1 1" { Threshold = "4"; Actions = "Focus; Raise; Move" }
}

## autres
Other {
	Enter = "Any Any" { Actions = "Focus" }
	ButtonRelease = "3" { Actions = "Close" }
	Motion = "1" { Actions = "Focus; Raise; Move" }
	Motion = "Mod1 1" { Threshold = "4"; Actions = "Focus; Raise; Move" }
}

comme les actions se répètent, je vous laisse la traduction partielle ;)

~/.pekwm/vars

vous avez sans doute noté au début de certains fichier :

INCLUDE = "vars"

c'est ici que ça se joue. le fichier vars contient vos commandes favorites. il se présente sous une forme minimale mais je vous propose un fichier un peu plus étoffé. à vous de l'adapter à vos besoins. vars gère les commandes argumentées :

$TERM="urxvtc"
$FILER="urxvtc -name filer -e ranger"
$GFILER="rox-filer"
$WEB="uzbl http://start.arpinux.org"
$GWEB="firefox"
$EDIT="urxvtc -name editor -e vim"
$GEDIT="geany"
$ZIK="urxvtc -name player -e mocp -T transparent-background"
$VOL="urxvtc -e alsamixer"
$JAB="urxvtc -e mcabber"

~/.pekwm/menu

le menu de base de PeKwm supporte le menu Debian, les sous-menus et les entrées dynamiques à la manière d'Openbox.
les menus dynamiques lisent le résultat d'une commande ou d'un script passé en argument.

# Menu config for pekwm

  # Variables
  INCLUDE = "vars"

  RootMenu = "Pekwm" {
  	Entry = "terminal" { Actions = "Exec $TERM &" }
  	Entry = "execute.." { Actions = "ShowCmdDialog" }

  	Separator {}

  	Submenu = "aller à..." {
  		SubMenu = "bureau" {
  			# création du menu goto une fois par rechargement de PeK
  			# c'est la façon la plus rapide . par défaut
  			COMMAND = "/usr/share/pekwm/scripts/pekwm_ws_menu.sh send"
  			# création du menu goto à chaque ouverture du menu, c'est la façon lente.
  			# vous aurez besoin de cette option si vous modifiez souvent en cours
						# de session le nombre de bureaux.
  			# ~/.pekwm/config. You will know if you want this.
  			# Entry = "" { Actions = "Dynamic /usr/share/pekwm/scripts/pekwm_ws_menu.sh send dynamic" }
  		}
  		Entry = "client.." { Actions = "ShowMenu GotoClient True" }
  	}
  	Submenu = "Pekwm" {
  		Submenu = "themes" {
  			Entry { Actions = "Dynamic /usr/share/pekwm/scripts/pekwm_themeset.sh /usr/share/pekwm/themes" }
  			Entry { Actions = "Dynamic /usr/share/pekwm/scripts/pekwm_themeset.sh ~/.pekwm/themes" }
  		}
  		Entry = "relancer" { Actions = "Reload" }
  		Entry = "redemarrer" { Actions = "Restart" }
  		Entry = "quitter" { Actions = "Exit" }
  	}
  	
	Separator {}

	INCLUDE = "debian-menu"
}

WindowMenu = "menu client" {
  	Entry = "visible sur tous les bureaux o/n" { Actions = "Toggle Sticky" }
  	Entry = "enroule/deroule" { Actions = "Toggle Shaded" }
  	Entry = "minimise " { Actions = "Set Iconified" }
  	Entry = "commande.." { Actions = "ShowCmdDialog" }

  	Submenu = "maximisation" {
  		Entry = "complète" { Actions = "Toggle Maximized True True" }
  		Entry = "horizontale" { Actions = "Toggle Maximized True False" }
  		Entry = "verticale" { Actions = "Toggle Maximized False True" }
  	}
  	Submenu = "remplir l'espace libre" {
  		Entry = "complet" { Actions = "MaxFill True True" }
  		Entry = "horizontal" { Actions = "MaxFill True False" }
  		Entry = "vertical" { Actions = "MaxFill False True" }
  	}
  	Submenu = "placement" {
  		Entry = "met au premier plan " { Actions = "Raise" }
  		Entry = "enlève du premier plan" { Actions = "Lower" }
  		Entry = "toujours au-dessus" { Actions = "Toggle AlwaysOnTop" }
  		Entry = "toujours en-dessous" { Actions = "Toggle AlwaysBelow" }
  	}
  	Submenu = "décorations" {
  		Entry = "active/desactive les décorations" { Actions = "Toggle DecorBorder; Toggle DecorTitlebar" }
  		Entry = "active/desactive les bordures" { Actions = "Toggle DecorBorder" }
  		Entry = "active/desactive la barre de titre" { Actions = "Toggle DecorTitlebar" }

  	}
  	Submenu = "Skip" {
  		Entry = "Menus" { Actions = "Toggle Skip Menus" }
  		Entry = "Focus Toggle" { Actions = "Toggle Skip FocusToggle" }
  		Entry = "Snap" { Actions = "Toggle Skip Snap" }
  	}
  	SubMenu = "envoyer vers..." {
  		# création du menu sendto une fois par rechargement de PeK
  		# c'est la façon la plus rapide . par défaut.
  		COMMAND = "/usr/share/pekwm/scripts/pekwm_ws_menu.sh send"
  		# création du menu sendto à chaque ouverture du menu, c'est la façon lente.
  		# vous aurez besoin de cette option si vous modifiez souvent en cours
				# de session le nombre de bureaux.
  		# Entry = "" { Actions = "Dynamic /usr/share/pekwm/scripts/pekwm_ws_menu.sh send dynamic" }
  	}
  	Separator {}
  	Entry = "fermer" { Actions = "Close" }
  	Submenu = "tuer le client" { Entry = "Kill application" { Actions = "Kill" } }
  }

~/.pekwm/autoproperties

le fichier qui personnalise l'affichage de vos applications: ouverture en mode maximisé automatique, ouverture sur tous les bureaux… tout est possible grâce à ce fichier.

/*
 Autoproperties.
 ce fichier rassemble des exemples explicites afin de créer votre propre fichier
 de règles. il contient également les propriétés par défaut de PeKwm.
 il devrait être une bonne base pour éditer vos propres règles.

 Pour connaitre les propriétes d'un fenêtre, vous aurez besoin du programme xprop.
 vous pourrez ainsi définir les informations appropriées à entrer dans les champs.

 une autre astuce est de vérifier l'emploi de l'entrée ApplyOn.
 les propriétés ne pourront pas s'appliquer sans cette entrée.

 vous pouvez donner plusieurs propriétés à une fenêtre, la plus pertinente sera 
 prise en compte, les autres ignorées. (voir l'exemple gimp).

 Notez que les entrées par défaut sont commentées, ne pas commenter vos
  autoproperties propres. :)
*/
// Autoproperties. ----------------------------------------
Require {
	Templates = "True"
}

/*
 Grouper les terminaux
 */
# Property = "(term|rxvt),(erm|xvt)" {
# 	ApplyOn = "New"
# 	Group = "term" {
# 		Size = "5"
# 		FocusedFirst = "True"
# 		Raise = "True"
# 	}
# }

/*
 retirer les décorations de la barre personnalisée de firefox.
 */
Property = "^(gecko|Gecko|firefox-bin),^Firefox-bin,,^Customize Toolbar\$" {
	ApplyOn = "Start New TransientOnly"
	Border = "False"
	Titlebar = "False"
}

/*
 groupe "moz-dl" automatiquement créé au dela de 10 clients de mozilla-download,
 en utilisant la WM_CLASS et titrant la fenêtre du nom du groupe.
 deplace cette fenêtre au coin supérieur gauche de l'écran et la fait passer
 derrière les autres fenêtres.
*/
# Property = "^mozilla-bin,^Mozilla-bin,,^Saving" {
# 	ApplyOn = "New Transient"
# 	Group = "moz-dl" { Size = "10" }
# 	FrameGeometry = "+0+0"
# 	Layer = "Below"
# }


/*
 groupe automatiquement au-dela de deux fenêtres de même WM_CLASS répondants aux propriétés.
 les ouvrir sur le bureau 2.
*/
# Property = "^Mozilla,^navigator:browser" {
# 	ApplyOn = "Start New Workspace"
# 	Workspace = "2"
# }


/*
 grouper toutes les fenêtres répondants aux propriétés. lorsqu'une nouvelle
 fenêtre est ouverte, qu'elle le soit en background. ne jamais rendre la fenêtre
 active du groupe. cette propriété s'applique à chaque demarrage de pek ou
 lorsqu'une nouvelle fenêtre est ouverte.
*/
# Property = "^dillo,^Dillo" {
# 	ApplyOn = "Start New"
# 	Group = "dillo" { Size = "0"; Behind = "True" }
# }


/*
 mettre les fenêtres répondants aux propriétés derrière les autres fenêtres.
 les afficher sur tous les bureaux, ne pas les afficher dans les menus de fenêtres goto.
 appliquer cette propriété lors du lancement de pekwm et à chaque ouverture
 de fenêtre, y compris les fenêtres secondaires (dans l'exemple, xmms et sa playlist).
*/
# Property = ".*,^xmms" {
# 	ApplyOn = "Start New Transient"
# 	Layer = "Desktop"
# 	Sticky = "True"
# 	Skip = "Menus FocusToggle Snap"
# }


/*
 retirer les fenêtres secondaires de gimp du menu, n'afficher que la 
 fenêtre principale. utiliser le WM_WINDOW_ROLE pour faire la distinction.
 
 en premier, nous séparons les fenêtres pour ne pas les mélanger. cette propriété
 dit à pek d'ignorer la 'toolbox' dans les propriétés suivantes. sinon, la 'toolbox'
 sera traité comme les autres fenêtres, ce que nous voulons éviter.
*/
# Property = "^gimp,^Gimp,gimp-toolbox" {
#  ApplyOn = "Start New"
# }
/*
 la boite de dialogue de découpage reste au-dessus des autres, dans le 
 coin supérieur gauche mais n'est pas visible dans le menu goto.
*/
# Property = "^gimp,^Gimp,gimp-crop-tool" {
# 	ApplyOn = "Start New"
# 	Layer = "OnTop"
# 	FrameGeometry = "+0+0"
# 	Skip = "Menus"
# }
/*
 le reste des fenêtres ne doit pas être affiché dans les menus non plus.
*/
# Property = ".gimp,^Gimp" {
# 	ApplyOn = "Start New"
# 	Skip = "Menus";
# }


/*
 tout ceci devrait commencer à avoir du sens pour vous :).
*/
# Property = "^gkrellm,^Gkrellm" {
# 	ApplyOn = "Start New"
# 	Sticky = "True"
# 	Skip = "Menus FocusToggle"
# 	Layer = "Desktop"
# }


/*
 quelques applications standard, xclock xload et xbiff. en plus de ce
 que vous avez déjà vu, les fenêtres apparaissent sans décorations.
 on utilise aussi l'argument de 'geometry' au complet, definissant la
 taille de la fenêtre ainsi que sa position sur l'écran.
*/
# Property = "^xclock,^XClock" {
# 	ApplyOn = "Start New"
# 	ClientGeometry = "120x137+0-137"
# 	Border = "False"; Titlebar = "False"
# 	Sticky = "True"
# 	Layer = "Desktop"
# 	Skip = "Menus FocusToggle Snap"
# }
# 
# Property = "^xload,^XLoad" {
# 	ApplyOn = "Start New"
# 	ClientGeometry = "560x137+120-137"
# 	Border = "False"; Titlebar = "False"
# 	Sticky = "True"
# 	Layer = "Desktop"
# 	Skip = "Menus FocusToggle Snap"
# }
# 
# Property = "^xbiff,^XBiff" {
# 	ApplyOn = "Start New"
# 	ClientGeometry = "120x137-120-137"
# 	Border = "False"; Titlebar = "False"
# 	Sticky = "True"
# 	Layer = "Desktop"
# 	Skip = "Menus FocusToggle Snap"
# }


// fin des autoproperties. -------------------------

TypeRules {
	/*
		 les propriétés appliquées à des types de fenêtres.
	 la fenêtre de bureau dans nautilus doit recouvrir la "root window"
		 mais se placer derrière toutes les autres, ne pas s'afficher dans
		 le menu pek, et ne pas adhérer.
	 */
 	Property = "DESKTOP" {
		FrameGeometry = "0x0+0+0"
		Titlebar = "False"
		Border = "False"
		Sticky = "True"
		Skip = "FocusToggle Menus Snap"
		Layer = "Desktop"
		Focusable = "False"
	}
	Property = "DOCK" {
		Titlebar = "False"
		Border = "False"
		Sticky = "True"
		Layer = "Dock"
		Skip = "FocusToggle Menus"
		Focusable = "False"
	}
	Property = "TOOLBAR"  {
		Skip = "FocusToggle Menus Snap"
	}
	Property = "MENU"  {
		Titlebar = "False"
		Border = "False"
		Skip = "FocusToggle Menus Snap"
	}
	Property = "UTILITY"  {
	}
	Property = "SPLASH"  {
		Titlebar = "False"
		Border = "False"
		Layer = "OnTop"
	}
	Property = "DIALOG"  {
		Layer = "OnTop"
	}
	Property = "NORMAL"  {
	}
}

/*
 les propriétés des titres dans les barres de titres:
 raccourcir les titres des navigateurs web.
*/
# TitleRules {
# 	Property = "^dillo,^Dillo" {
# 		Rule = "/Dillo: (.*)/\\1 - dillo/"
# 	}
# 	Property = "^firefox-bin,^Firefox-bin" {
# 		Rule = "/(.*) - Mozilla Firefox/MF: \\1/"
# 	}
# }


// End of titlerules. -----------------------------


/*
 la configuration des applications du harbour.
 obpager se positionne en dernier, la charge cpu en premier et wmnd au centre.
*/
# Harbour {
# 	Property = "^obpager,^obpager" {
# 		Position = "-1"
# 	}
# 	Property = ".*,.*cpuload" {
# 		Position = "1"
# 	}
# 	Property = ".*,^wmnd" {
# 		Position = "0"
# 	}
# }


// End of harbour order rules. --------------------


/*
 et maintenant, pour finir, si vous avez un thème qui le supporte,
 la section "DecorRules {}".

 ici nous indiquons au terminal d'utiliser la décoration TERM de votre theme
 votre theme doit supporter cette option.
*/
# DecorRules {
# 	Property = "^term,^xterm" {
# 		Decor = "TERM"
# 	}
# }

~/.pekwm/themes ,/scripts, /icons

vous trouverez des exemplaires de ces dossiers dans /usr/share/pekwm.

utilisation

voici quelques exemples expliqués d'utilisation de PeKwm.

grouper les fenêtres

PeKwm supporte les groupes de clients dans un même fenêtre. les clients sont organisé en onglets.
pour grouper les clients :

les raccourcis clavier sont visibles dans le fichier [keys] section des chaines

	# grouper les clients
	Chain = "Ctrl Mod1 T" {
		KeyPress = "T" { Actions = "Toggle Tagged False" } 
		KeyPress = "B" { Actions = "Toggle Tagged True" }
		KeyPress = "C" { Actions = "Unset Tagged" }
		KeyPress = "G" { Actions = "Toggle GlobalGrouping" }
		KeyPress = "M" { Actions = "Toggle Marked" }
		KeyPress = "A" { Actions = "AttachMarked" }
		KeyPress = "D" { Actions = "Detach" }
		Keypress = "P" { Actions = "AttachClientInNextFrame" }
		KeyPress = "O" { Actions = "AttachClientInPrevFrame" }
		Keypress = "I" { Actions = "AttachFrameInNextFrame" }
		KeyPress = "U" { Actions = "AttachFrameInPrevFrame" }

pour naviguer dans un groupe de clients :

les menus dynamiques

c'est l'équivalent des pipes-menus d'openbox: ça lit un script (sh, perl,curl,py..) et donne le résultat dans une entrée ou un sous-menu. un exemple simple: date et heure dans le menu:
le script :

#!/bin/bash
echo "Dynamic {"
echo "Submenu = \"`date +'%I:%M'`\" {"
echo "  Entry = \"`date +'%a %d'`\" { Actions = \"Exec roxterm --geometry 65x37+565+0 -e cal -y \" } "
echo "}"

ce script indique l'heure dans le menu et la date dans un sous-menu. si on clic, un terminal s'ouvre avec le calendrier. ce type de script est inclut dans le menu ou un sous-menu de PeKwm avec ce code :

Entry = "" { Actions = "Dynamic  ~/.pekwm/scripts/pekwm_time.sh" }

personnalisation

l'apparance de PeKwm est géré par GTK et PeK lui-même.
pour les thèmes gtk
il suffit de les placer dans votre ~/.themes. puis de choisir une appli genre gtkchooser ou lxappearance pour définir votre thème gtk. si vous désirez passez directement par PeKwm pour gérer l'apparance gtk, il vous faudra installer le paquet pekwm_menu_tools (par compilation: dépend de libboost1.35-dev, libboost-filesystem1.35-dev, libgtk2.0-dev) puis utiliser le script pekwm_gtk_menu afin de pouvoir la lancer avec la section :

Submenu = "gtk themes" {
	Entry { Actions = "Dynamic ~/.pekwm/scripts/pekwm_gtk_menu -l" }
}

pour les thèmes pekwm,
il faut les placer dans /usr/share/pekwm/themes ou ~/.pekwm/themes où ils pourront être détectés par le script pekwm_themeset.sh. ce script est inclus dans pekwm et est lancé par la commande de menu

Submenu = "pek themes" {
	Entry { Actions = "Dynamic /usr/share/pekwm/scripts/pekwm_themeset.sh /usr/share/pekwm/themes" }
	Entry { Actions = "Dynamic /usr/share/pekwm/scripts/pekwm_themeset.sh ~/.pekwm/themes" }

pour les icones, la police ...
c'est là qu'une application comme lxapearance est utile .. à moins que vous ne désiriez gérer votre machine qu'en cli .. dans ce cas, ce wiki ne vous apprendra rien ;).

conclusion

je dirais que pekwm est le wm le plus complexe que j'ai eu à configurer si on veut explorer toutes ses options. cependant, pour obtenir un système fonctionnel et preformant, il n'est pas nécessaire de tout éditer.
le système de gestion des clients en groupe est des plus pratique et on arrive assez vite à autant d'ergonomie que dans un tiling wm. bien sûr, les raccourcis clavier et le principe des chaines de raccourcis, lorsqu'on l'a pris en main, devient très vite indispensable.. et le retour est dur sur gnome ou xfce ;).