[wiki] représentation des touches du clavier

paskal · 10-07-2015 12:09:56

Bonjour,

Suite aux travaux intensifs de milou sur le wiki DF

, il apparait que, sur les nombreux tutos nécessitant l'utilisation de touches particulières du clavier, leur représentation pose problème.

La première amélioration à apporter serait d'homogénéiser cette représentation et en faire état dans l'aide à la rédaction.
Ce qui entraine la question suivante : quelle représentation adopter ?

Les représentations actuellement rencontrées dans le wiki-DF sont les suivantes :

du texte simple, exemple : Ctrl Alt Suppr
en bloc de code, exemple sur https://debian-facile.org/doc:media:gim … elle-image :
[Ctrl n]
entre double quotes, en caractères gras ou non, exemple sur https://debian-facile.org/doc:media:gimp:tracage : Ctrl o sur fond coloré

Je trouve qu'aucune d'entre elles n'est réellement satisfaisante :
- le texte simple car il ne permet pas assez la mise en évidence ;
- le bloc code car il prend beaucoup d'espace et il rompt dans certains cas la phrase ; et, d'autre part, il ne peut pas être incorporé dans les tableaux ;
- les double quotes rendent un aspect "étriqué", en particulier si on utilise des caractères gras ; par ailleurs, elles ont d'autres usages dans les tutos.

En surfant un peu, on trouve ces représentations :

sur WikiBook, en encadré sur fond gris (sobre et clair) : https://fr.wikibooks.org/wiki/Windows/R … er#Control ;
sur WikiPedia, en encadré arrondi avec ombre portée (merci milou ) : https://fr.wikipedia.org/wiki/Tableau_d … _du_Bureau ;
le moteur de WikiPedia étant MediaWiki, on retrouve la même chose sur celui-ci : https://www.mediawiki.org/wiki/Help:Vis … r_guide/fr (en bas de page) ;
enfin, on trouve quelque chose de semblable dans l'aide de Gnome : https://help.gnome.org/users/gnome-help … ts.html.fr.

Personnellement, je trouve la représentation de Wikipedia/Mediawiki très claire, en plus d'être agréable.

Du coup, j'ai fouillé un peu et il semble que ce ne soit pas impossible à mettre en place.
L'utilisateur emploie le mot-clé Touches entre double accolades :

{{Touches|Ctrl}}

Le code html généré pour la touche Ctrl est le suivant :

<kbd style="font-size: 0.85em; border:1px solid; border-bottom-width: 2p…f9; padding: 1px 3px; white-space:nowrap; border-radius:3px;">

    Ctrl

</kbd>

C'est un peu différent sur la page Mediawiki :

<kbd class="keyboard-key nowrap" style="border:1px solid #aaa;-moz-border-radius: 2px; -webkit-borde…;;font-family:inherit;line-height:normal;white-space:nowrap;">

    <span style="-moz-border-radius: 1px; -webkit-border-radius: 1px; border-…gradient(to bottom, #eee,#fff,#f9f9f9);padding:0;color:#000;">

         Ctrl

    </span>

</kbd>

Par ailleurs, pour DokuWiki (le moteur du wiki DF), il existe le plugin keyboard, en action ici mais je le trouve un poil moins "aéré".
Voilà où j'en suis de mes investigations.

Pensez-vous que le jeu en vaille la chandelle ? Je dis ça parce que j'entends déjà le marin au long cours : "Quoi ?! Encore un patch ?!"

milou · 10-07-2015 12:21:52

"Quoi ?! Encore un patch ?!

Oui mais ça serait plus lisible et plus zoli....

captnfab · 10-07-2015 12:42:51

Plop,

Pour l'aération, c'est du vent, ça se change dans le CSS.

Ce n'est pas un patch mais un plugin (la différence étant qu'un plugin ne modifie pas le code existant, mais rajoute simplement des fichiers.)
Ce doit être faisable de rajouter ça, je regarderai si le plugin se greffe bien à notre wiki. Un jour.

milou · 10-07-2015 12:48:28

ça serait cool

paskal · 10-07-2015 13:10:50

captnfab a écrit :

Ce n'est pas un patch mais un plugin

Oui et non : si tu modifies le css, tu patches bien le plugin ...

... sauf à surcharger, polymorphisme, quand tu nous tiens ...

captnfab · 10-07-2015 15:58:43

Voilà, non, le CSS modifié ne fait pas partie du site ni du plugin, nous le surchargeons depuis le CSS maison

paskal · 10-07-2015 16:04:57

Alors, on y va , on y vas ?

paskal · 12-07-2015 09:50:30

J'essaie de redéployer un site neuf en local et je rencontre quelques difficultés.

Déjà, il a fallu que je réinitialise le mdp root Pas moquer, hein !

milou · 12-07-2015 09:53:57

Trou de mémoire ?

paskal · 12-07-2015 09:55:41

Nan, utilisation d'un mdp inhabituel doublée de perte de petit papier ...

J'avais dit "pas moquer" mais, comme d'hab, tu n'en fait qu'à ta tête ...

milou · 12-07-2015 09:58:17

C'est justement ce qu'il ne fallait pas me dire ....

paskal · 16-07-2015 12:04:52

Bonjour,

J'ai finalement installé en local le plugin keyboard sur lequel j'ai plaqué le style de WikiPedia (https://fr.wikipedia.org/wiki/Tableau_d … _du_Bureau).
Pour l'instant, je n'ai constaté aucune instabilité.

Voilà le rendu obtenu :

C'est déjà pas mal, je trouve, même si on peut sans doute encore l'améliorer.

Qu'en pensez-vous ?

captnfab · 16-07-2015 12:08:28

C'est joli.

milou · 16-07-2015 12:08:28

Perso, je trouve super...
Je préfère le premier plus sobre, quoique j'hésite avec les caractères gras, c'est à voir le rendu sur la page

paskal · 16-07-2015 12:11:15

Il n'y a qu'un seul style, le gras et l'italique ont été obtenus en encadrant classiquement par ** et //

milou · 16-07-2015 12:12:05

Ce que je veux te dire, c'est que je n'aime pas en italique.....

paskal · 16-07-2015 12:13:27

milou a écrit :

Ce que je veux te dire, c'est que je n'aime pas en italique.....

Bizarrement, c'est ce que je préfère ...

milou · 16-07-2015 12:15:13

Le contraire m'aurait étonné.... c'est juste histoire de me contredire ...

Sur un clavier, les touches ne sont pas en italique, ce n'est pas réaliste.....

captnfab · 16-07-2015 12:21:36

Perso, je n'aime pas en gras. Pour les touches, je trouve que l'italique va bien s'il n'y a pas le cadre, ou alors simplement pour les modificateurs. Mais bon, on ne va pas rajouter des règles de typo juste pour le fun. La version « touches » sans italique me semble la plus classique.

milou · 16-07-2015 12:22:16

Yessssssssss

paskal · 16-07-2015 12:56:29

milou a écrit :

Sur un clavier, les touches ne sont pas en italique, ce n'est pas réaliste.....

Je vois que tu es experte en claviers ... http://www.cimis.fr/downloads/plaquette … 202015.pdf

milou · 16-07-2015 12:59:08

J'en ai un devant les yeux, ça me suffit.....

paskal · 16-07-2015 13:01:20

C'est bien de se contenter de ce qu'on a ... parfois.

milou · 16-07-2015 15:53:20

... Ou pas ...

paskal · 16-07-2015 17:54:32

Debian-facile

#1 10-07-2015 12:09:56

[wiki] représentation des touches du clavier

#2 10-07-2015 12:21:52

Re : [wiki] représentation des touches du clavier

#3 10-07-2015 12:42:51

Re : [wiki] représentation des touches du clavier

#4 10-07-2015 12:48:28

Re : [wiki] représentation des touches du clavier

#5 10-07-2015 13:10:50

Re : [wiki] représentation des touches du clavier

#6 10-07-2015 15:58:43

Re : [wiki] représentation des touches du clavier

#7 10-07-2015 16:04:57

Re : [wiki] représentation des touches du clavier

#8 12-07-2015 09:50:30

Re : [wiki] représentation des touches du clavier

#9 12-07-2015 09:53:57

Re : [wiki] représentation des touches du clavier

#10 12-07-2015 09:55:41

Re : [wiki] représentation des touches du clavier

#11 12-07-2015 09:58:17

Re : [wiki] représentation des touches du clavier

#12 16-07-2015 12:04:52

Re : [wiki] représentation des touches du clavier

#13 16-07-2015 12:08:28

Re : [wiki] représentation des touches du clavier

#14 16-07-2015 12:08:28

Re : [wiki] représentation des touches du clavier

#15 16-07-2015 12:11:15

Re : [wiki] représentation des touches du clavier

#16 16-07-2015 12:12:05

Re : [wiki] représentation des touches du clavier

#17 16-07-2015 12:13:27

Re : [wiki] représentation des touches du clavier

#18 16-07-2015 12:15:13

Re : [wiki] représentation des touches du clavier

#19 16-07-2015 12:21:36

Re : [wiki] représentation des touches du clavier

#20 16-07-2015 12:22:16

Re : [wiki] représentation des touches du clavier

#21 16-07-2015 12:56:29

Re : [wiki] représentation des touches du clavier

#22 16-07-2015 12:59:08

Re : [wiki] représentation des touches du clavier

#23 16-07-2015 13:01:20

Re : [wiki] représentation des touches du clavier

#24 16-07-2015 15:53:20

Re : [wiki] représentation des touches du clavier

#25 16-07-2015 17:54:32

Re : [wiki] représentation des touches du clavier

Pied de page des forums