Table des matières
keyboard : Marque le texte de Dokuwiki comme des touches du clavier
Pré-requis
Installation
Configuration
Les options de configuration suivantes existent :
- disable_translation
- si cette option est activée, toutes les traductions et raccourcis sont désactivés. Les clés données seront affichées «telles quelles».
; css_class
- la classe CSS à utiliser si aucune classe n'est indiquée dans la balise de syntaxe. Il existe deux classes intégrées :
- Pour l'aspect standard, entrez :
__keyboard
- Pour un aspect similaire aux touches de MediaWiki, entrez :
__keyboard_keypress
===== Utilisation =====
Utilisez la balise <key> pour marquer du texte comme touches du clavier. Par exemple :
This display the keys <key>ALT</key> + <key>H</key>.
crée la sortie suivante :
Forme courte
La forme la plus courte pour écrire la combinaison de touches ALT + H est :
This displays the keys <kbd>ALT+H</kbd>.
Les signes de séparation pour la forme courte peuvent être + ou -. Dans les deux cas, le signe rendu entre les touches sera un +. Donc, en général, cela ne fait aucune différence si + ou - est utilisé.
Mais cela fait une différence si vous souhaitez inclure un + ou - comme clé et non comme séparateur.
Pour rendre la combinaison de touches ALT++, écrivez :
<kbd>ALT-+</kbd>
Pour rendre la combinaison de touches ALT+-, écrivez :
<kbd>ALT+-</kbd>
Mécanisme d'échappement
En entourant les touches avec '…', toutes les touches entre guillemets simples '…' seront affichées telles quelles sans interpréter + ou - comme séparateurs.
Voici un exemple:
<kbd>'ALT+H'</kbd>
Cet exemple afficherait ALT+H comme une seule clé au lieu de deux clés: ALT+H.
Spécifier la classe CSS
Pour varier l'apparence avec chaque séquence de touches donnée, vous pouvez également spécifier une classe CSS comme ceci :
<key class="myclass">ALT+H</key>
Raccourcis
Certaines touches comme la lettre C sont des raccourcis qui seront étendus.
Par exemple, ALT+Ctrl affichera le même résultat que si vous avez entré ALT+Ctrl.
Pour supprimer ce comportement, insérez la lettre entre deux '.
Par exemple. si vous voulez vraiment afficher la lettre C au lieu de Ctrl, alors écrivez ALT+C.