Voir la source de Plank

== Présentation ==
Plank est un dock à la manière de la pomme. La possibilité de le configurer en ligne de commande facilite son utilisation en environnement réseau.

== Description et structure de la configuration ==
==== Arborescence dans ''gsettings'' ====
Pour visualiser les clés de la bibliothèque ''gsettings'', installer '''''dconf-editor''''', ou en ligne de commande :<br>
''(Adapter '''dock1''' en fonction des besoins)''<br>
'''Lister''' les clés : 
 $ sudo gsettings list-keys net.launchpad.plank.dock.settings:/
'''Afficher''' la valeur d'une clé :
 $ sudo gsettings get net.launchpad.plank.dock.settings:/net/launchpad/plank/docks/dock1/ CLE
'''Définir''' la valeur d'une clé :
 $ sudo gsettings set net.launchpad.plank.dock.settings:/net/launchpad/plank/docks/dock1/ CLE VALEUR
'''Lister''' les valeurs possibles d'une clé :
 $ sudo gsettings describe net.launchpad.plank.dock.settings:/net/launchpad/plank/docks/dock1/ CLE

{| class="wikitable"
|+ Paramétrage
|-
! Clé !! Valeur !! Explication
|-
| alignment || fill \\ start \\ end \\ center ||
|-
| auto-pinning || true \\ false || "pin applications when usefull"
|-
| current-workspace-only || true \\ false ||
|-
| dock-items || Liste gérée par plank - ne pas modifier ||
|-
| hide-delay || Durée || Délai avant effacement, en millisecondes
|-
| hide-mode || none \\ intelligent \\ auto \\ dodge-maximized \\ window-dodge \\ dodge-active ||
|-
| icon-size || Taille || Taille des items en pixels
|-
| items-alignment || fill \\ start \\ end \\ center ||
|-
| lock-items || true \\ false || Empêche la suppression des items
|-
| monitor || plugname || Nom du moniteur d'affichage du dock \\ Laisser vide pour affichage par défaut.
|-
| offset || pourcentage || Position du dock par rapport au centre en %
|-
| pinned-only || true \\ false || Si vrai, ne montre que les applis épinglées \\ Utile en cas de docks multiples
|-
| position || top \\ right \\ bottom \\ left || Position du dock
|-
| pressure-reveal || false \\ true ||
|-
| show-dock-item || true \\ false || Montrer/cacher l'icone Plank
|-
| theme || Default \\ Matte \\ Transparent \\ Gtk+ || Ou autre thème installé
|-
| tooltips-enabled || false \\ true || Montre les tooltips au survol du curseur
|-
| unhide-delay || Valeur || Délai d'apparition du dock en millisecondes
|-
| zoom-enabled || false \\ true || Zoom des icônes au survol
|-
| zoom-percent || Valeur || Pourcentage d'agrandissement au survol
|}

==== Dossiers et fichiers ====
Les docks se trouvent dans ''~/.config/plank''

Chaque dock contient les lanceurs ''(fichiers *.dockitem)''.

Exemples :

* Pour un lien vers un lanceur
 [PlankDockItemPreferences]
 Launcher=file:///home/linux/.config/Raccourcis_wine/imagemo.desktop
Soit :
 Launcher=file://chemin_vers_le_lanceur
* Pour un lien vers un dossier
 [PlankDockItemPreferences]
 Launcher=file:///home/linux/.config/Raccourcis_wine/Math
Soit :
 Launcher=file://chemin_vers_le_dossier
* Pour un lien vers un docklet
 [PlankDockItemPreferences]
 Launcher=docklet://cpumonitor
Soit :
 Launcher=docklet://nom_du_docklet
Les docklets sont dans le dossier :
 /usr/lib/x86_64-linux-gnu/plank/docklets/
 avec un nom du type : ''libdocklet-....so''

== Procédure pour l'utilisation en environnement scribe ==
''- à tester -''

'''Objectif :''' Permettre aux enseignants de gérer le contenu du dock de leurs élèves.

Pistes à creuser :
# L'enseignant dépose les documents (raccourci, dossier, document) dans le dossier partagé ''classe/données/''
# Un script à l'ouverture de session récupère la classe de l'utilisateur, construit les lanceurs et les copie dans ''~/.config/plank''
Autre solution :
# idem
# Il ajoute les éléments à son propre dock
# Il lance un script de copie des fichiers ''.dockitem''
# A l'ouverture de session, un script copie les fichiers dans ''~/.config/plank''
Autre solution : écrire une application :
# L'enseignant choisit les éléments par sélection
# Le programme copie les fichiers dans ''classe/données/'' puis crée les fichiers ''.dockitem'' et les place dans un dossier partagé sur le serveur
# Un script recopie ces fichiers dans ''~/.config/plank'' à l'ouverture de session

'''A minima :'''

Préparer un dock par niveau d'élèves sur le serveur. Copier les fichiers ''.dockitem'' dans le ''~/.config/plank'' de l'utilisateur à l'ouverture de session. Pas de modif possible par l'enseignant.