✎ tutoriel:creer_et_utiliser_un_agencement_de_clavier_personnalise [Wiki ubuntu-fr]

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

{{tag>Xenial tutoriel clavier}}
----

====== Créer et utiliser un agencement de clavier personnalisé ======

Cette page décrit la méthode à appliquer pour ajouter un agencement de clavier personnalisé à ceux déjà fournis par défaut, et le faire prendre en compte par le système pour qu'il puisse être utilisé de la même manière que les autres, y compris par les outils graphiques.

Elle ne présente néanmoins que les grandes lignes de la méthode et la page << [[tutoriel:exemple_de_creation_d_un_agencement_clavier_personnalise|Exemple de création d'un agencement de clavier personnalisé]] >> illustre plus profondément et concrètement les détails de la démarche à suivre.

<note help>La lecture de cette page ainsi que celle de l'exemple nécessite la compréhension d'un certain nombre de concepts qui sont présentés sur la page << **[[tutoriel:comprendre_la_configuration_du_clavier|Comprendre la configuration du clavier]]** >>.</note>

===== A qui s'adresse cette page ? =====
Cette page s'adresse prioritairement aux personnes qui doivent **revoir en profondeur** l'affectation des touches de leur clavier. Ce peut être le cas des linguistes, qui doivent rédiger des textes multilingues ou des textes dans des langues anciennes ou exotiques, mais aussi le cas de scientifiques qui doivent faire appel à des symboles spécialisés qui reviennent souvent.\\
Cette façon de procéder est de nature à leur éviter le recours à des combinaisons de touches compliquées et qu'il leur faut mémoriser.

Néanmoins, ceci peut aussi intéresser des utilisateurs ayant des besoins plus limités comme la simple affectation ou réaffectation de quelques touches (claviers multimédia spéciaux par exemple). Dans ce dernier cas, avant d'aller plus loin, ces utilisateurs devraient s'assurer qu'un moyen plus simple n'existe pas, comme les options de l'interface graphique par exemple. 
Cela peut aussi s’avérer parfait pour des développeurs.
===== Existe-t-il des méthodes alternatives ? =====
Oui, il existe une autre méthode qui ressort plus de la programmation et qui consiste à ajouter des scripts de démarrage qui compilent une table de configuration que l'on a pris soin de mettre à un emplacement ad hoc.\\
Une information très détaillée sur la façon de mettre en oeuvre cette méthode est fournie sur cette[[http://wiki.mandriva.com/fr/Personnaliser_le_clavier#R.C3.A9affecter_les_touches_avec_xmodmap|page de la communauté Mandriva]]. Cette méthode requiert néanmoins d'être adaptée à la distribution Ubuntu et présente l'inconvénient d'introduire un certain décalage entre la configuration qui est perçu par les outils graphiques et la réalité.

=====Pré-requis====

* [[tutoriel:comprendre_la_configuration_du_clavier|Comprendre la configuration du clavier]].
  * Disposer des [[:sudo|droits d'administration]].
 
===== Créer un agencement ordinaire sur quatre niveaux =====
La méthode pour personnaliser un agencement de clavier se décompose en deux étapes:
  - Écrire un fichier de description de l'agencement du clavier,
  - Faire prendre en compte votre nouvel agencement par le système afin qu'il soit sélectionnable dans la boite de dialogue des paramètres du clavier.

==== Décrire l'agencement du clavier ====
L'agencement de clavier que vous souhaitez mettre en place sera à placer avec les [[:sudo|droits d'administration]] dans le dossier **/usr/share/X11/xkb/symbols**.

<note important>Si vous décidez d'intervenir directement sur les fichiers standards qui sont fournis avec la distribution,** avant ** toute manipulation, [[:tutoriel:comment_sauver_et_restaurer_un_fichier|sauvegardez]] les fichiers que vous serez amené à modifier.</note>

==== Prise en compte par le système du nouvel agencement ====

[[:tutoriel:comment_modifier_un_fichier|Ouvrez avec les droits d'administration]] le fichier ** /usr/share/X11/xkb/rules/evdev.xml** et juste avant la ligne </layoutList> ajoutez le bloc suivant:

<file xml /usr/share/X11/xkb/rules/evdev.xml><layout>
 <configItem>
           <name>NAME</name>
          <shortDescription>DC</shortDescription>  
	    <description>DESCRIPTION</description>
           <languageList><iso639Id>LANG</iso639Id></languageList>
</configItem>
<variantList/>
</layout>
</file>

dans lequel,
  *  **NAME** est à remplacer par le nom du fichier par exemple **my_kb**
  * **DC** est à remplacer par une courte description textuelle par exemple **Bil** (pour bilingue). C'est cette courte description qui apparaît à droite de l'indicateur de clavier dans l'applet de notification.
  * **DESCRIPTION** est à remplacer par une description plus explicite comme **Bilingue français suédois**. Ce texte apparaît dans les listes de variantes dans le dialogue de sélection des agencements et lorsque l'on clique sur l'indicateur de clavier de l'applet de notification.
  * **LANG** est à remplacer par le code de la lange dans le format de la [[http://www.loc.gov/standards/iso639-2/php/English_list.php|norme ISO639.2]].

Pour finir, [[:tutoriel:comment_modifier_un_fichier|sauvegardez le fichier]] avant de quitter votre session et de vous y reconnecter pour que les changements soient pris en compte.

Il est nécessaire ensuite d'effacer l'ensemble des fichiers *.xkm du répertoire ///var/lib/xkb// puis de redémarrer le système pour que les modifications qui précèdent soient prises en compte.

<note important>Si vous vous êtes contenté de modifier un fichier de base fourni par la distribution, vous n'avez bien-sûr pas à  faire ce qui précède.</note>

==== Utilisez votre nouvel agencement ====
Pour utiliser votre nouvel agencement de clavier, rendez-vous dans le dialogue des [[:tutoriel:configurer_le_clavier|préférences de clavier]].
Choisissez **Ajouter**, puis l'onglet de sélection par **langue**. Rechercher la langue sous laquelle vous avez déclaré le fichier et éventuellement la variante si la langue comprend plusieurs fichiers.\\
Vous devriez maintenant apercevoir votre agencement dans la liste accessible par l'indicateur de clavier dans l'applet de notification général du tableau de bord.

<note tip>Si votre fichier est multilingue, vous pouvez le placer sous l'une des langues ou choisir pour le paramètre **LANG** un code neutre tel que **und** pour Indéterminé</note>

Vous devriez maintenant apercevoir votre agencement dans la liste accessible par l'indicateur de clavier dans l'applet de notification général du tableau de bord.

===== Créer un agencement enrichi jusqu'à huit niveaux =====
==== Introduire des touches à plus de quatre niveaux ====
Il existe dans le répertoire **/usr/share/X11/xkb/types**, un fichier //level5// qui prédéfinit des types de touches à huit niveaux. Vous pourriez, bien-sûr redéfinir vos propres types de touche, mais ceux qui sont présentés là devraient suffire dans la majorité des cas.

Si par exemple, vous vouliez créer une touche E avec les niveaux suivants :
|e|E|ê|Ê|€|€|ë|Ë|
Il suffira d'écrire dans votre agencement personnalisé :
<file>key <AD03> {
        type="EIGHT_LEVEL_ALPHABETIC",
        symbols[Group1]= [e, E, ê, Ê, €, €, ë, Ë ]
    };</file>

Dans le cas d'une série de touches du même type, la syntaxe est la suivante :
<file>
key.type[Group1]="EIGHT_LEVEL_ALPHABETIC" ;
     key <AD03> { [e, E, ê, Ê, €, €, ë, Ë ] }; 
     key <AD04> {[r, R, paragraph, registered, , ₹, ₹ ]}; 
     key …
     </file>
 <note> Le dernier symbole utilisé avec la touche R représente la roupie indienne :₹. Son emploi dans cet exemple, vise à présenter un moyen mnémotechnique qui consiste à utiliser la lettre initiale de la monnaie pour se souvenir de son emplacement. Un spécialiste de finances pourrait de la même manière se créer un accès facile aux différentes monnaies qu'il utilise souvent.</note>
<note>On notera également qu'il n'est pas nécessaire de renseigner les huit niveaux. Il est néanmoins recommandé de le faire, quitte à avoir des redondances ou à utiliser le symbole //nosymbol//, pour éviter toute surprise quant à l'interprétation qui en sera faite par le système</note>

==== Utiliser les options graphiques pour accéder aux niveaux supérieurs ====
<note importante>Ce qui suit n'est plus valable pour Gnome 3, Unity est donc concerné. Par contre vous trouverez ces options sous [[:kubuntu]] et [[:Mate]].</note>
Le  menu //Système -> Préférences -> Clavier// vous permet , en cliquant sur le bouton **//Options//**, d'accéder à l'option **//Touche(s) pour choisir le cinquième niveau//** ((En anglais : "key to chose the 5th level" si votre interface n'assure pas la traduction.)). Vous pouvez par exemple choisir la touche logo de gauche et l'utiliser alors de la même manière que la touche //Alt gr// mais cette fois pour accéder au niveau 5 et non plus 3.

==== Créer un accès personnalisé aux niveaux hauts ====
Pour des raisons liées à vos critères personnels d'ergonomie ou à des singularités de votre clavier, vous pouvez vouloir utiliser une touche autre que celles proposées dans les options. Il peut vous sembler logique d'utiliser la touche //Alt// de gauche, car cette dernière est en position symétrique de son équivalent de droite. Cependant celle-ci ne peut être réaffectée facilement à cause du rôle qu'elle joue dans le système. Une solution serait d'utiliser l'option graphique qui consiste à la permuter avec la touche //logo// de gauche, puis d'affecter le changement de niveau à la touche //logo// (nouvelle). Malheureusement, les combinaisons d'options ne donnent pas toujours le résultat escompté, aussi serez vous amené à créer vous même cette «substitution-affectation».

L'exemple qui suit permet d' illustrer cette méthode de la «substitution-affectation» évoquée ci-dessus. Pour des explications plus détaillées, en particulier sur la démarche à suivre pour le cas général, vous devez vous reporter à cette [[tutoriel:comprendre_la_configuration_du_clavier|page explicative]].

=== Créer l'option de réaffectation des touches ===
[[:tutoriel:comment_modifier_un_fichier|Ouvrez avec les droits d'administration]] le fichier **/usr/share/X11/xkb/symbols/altwin** et ajoutez à la fin le bloc suivant:
<file>
partial modifier_keys 
xkb_symbols "my_swap_lalt_lwin" {
    key <LALT> { type[Group1] = "ONE_LEVEL",
    
                 symbols[Group1] = [ ISO_Level5_Shift ] };
    key <LWIN> {	[	Alt_L,	Meta_L		]	};
    modifier_map Mod3 {ISO_Level5_Shift  };
};
 </file>

=== Utiliser l'option ===
Maintenant, en fin de votre agencement personnalisé, derrière la ligne :
 <file>include "level3(ralt_switch)"
 </file>
placez la ligne suivante
 <file>include "altwin(my_swap_lalt_lwin)"
 </file>
puis déconnectez vous pour vous re-connecter aussitôt.

<note>L'option créée précédemment peut bien-sûr être placée dans un fichier séparé plutôt que dans le fichier  **/usr/share/X11/xkb/symbols/altwin**. Dans les deux cas, pensez à les  [[:tutoriel:comment_sauver_et_restaurer_un_fichier|sauvegarder]] car, en cas de réinstallation, ils seraient irrémédiablement écrasés.</note>

===== Exemples de modification d'une configuration de clavier =====
==== Un clavier « à la windows » ====
(Janvier 2014) Voir « Comment obtenir un clavier "à la windows", de manière à ce que la touche "CAPS-LOCK" permette d'accéder directement aux chiffres » sur ce [[http://forum.ubuntu-fr.org/viewtopic.php?pid=15694341#p15694341|fil de discussion]].

==== Un script si vous avez à répéter l'opération ====
Si vous avez à répéter l'opération, le script ci-dessous permet de créer une variante de clavier français selon un agencement très particulier (au cas d'espèce, décalage des touches de la rangée du bas su clavier pour récupérer < et > qui avaient migré sur un tout petit clavier).
<code>
#!/bin/bash

# Copie de sauvegarde & initialisation (avec un test pour être certain de en pas perdre le tout premier fichier issu de l'installation)
   FichierClavierAModifier="/usr/share/X11/xkb/symbols/fr"
   FichierListeDesClaviersAModifier="/usr/share/X11/xkb/rules/evdev.xml"
   ext=".anc"

i=0; while [[ -f "$FichierClavierAModifier""$ext""$i" ]]; do let "i++"; done
	if [[ -f "$FichierClavierAModifier""$ext" ]]; then
		sudo cp "$FichierClavierAModifier" "$FichierClavierAModifier""$ext""$i"
	else
		sudo cp "$FichierClavierAModifier" "$FichierClavierAModifier""$ext"
	fi

i=0; while [[ -f "$FichierListeDesClaviersAModifier""$ext""$i" ]]; do let "i++"; done
	if [[ -f "$FichierListeDesClaviersAModifier""$ext" ]]; then
		sudo cp "$FichierListeDesClaviersAModifier" "$FichierListeDesClaviersAModifier""$ext""$i"
	else
		sudo cp "$FichierListeDesClaviersAModifier" "$FichierListeDesClaviersAModifier""$ext"
	fi

# ------------------------------------------------------

usage () {	#	Information sur le script, utilisation et résultats attendus
	local status=${1}
	echo ""
	echo "	$(basename $0)"
	echo ""
	echo "	Modifie les paramètres des fichiers $FichierClavierAModifier et $FichierListeDesClaviersAModifier pour ajouter une variante de clavier adaptée à l'appareil."
	echo ""
	echo "	Version 0.0 - 02/11/2019"
	echo ""
	echo "	"
	echo ""
	echo " Exemple :"
	echo " ----------"
	echo "  $(basename $0) "

exit "${1}"
}

# ------------------------------------------------------

if [[ "${1}" == "-h" ]] || [[ "${1}" == "-help" ]] || [[ "${1}" == "--help" ]] || [[ "${1}" == "--aide" ]] || [[ "${1}" == "-a" ]]; then 
		usage
	fi

# Insertion de la nouvelle variante en fin de fichier clavier FichierClavierAModifier
# -----------------------------------------------------------------------------------

NvFichierClavier=$(mktemp)
	cp "$FichierClavierAModifier" "$NvFichierClavier"

sudo echo "
partial alphanumeric_keys
xkb_symbols \"Clavier_personnalise\" {
    include \"fr(basic)\"

name[Group1]=\"French\";

key <AB01> { [         less, greater, guillemotleft, guillemotright	] };
        key <AB02> { [         w, W, lstroke,   Lstroke	                    ] };
        key <AB03> { [         x, X, dead_acute, dead_doubleacute	        ] };
        key <AB04> { [         c, C,  copyright,         cent	            ] };
        key <AB05> { [         v, V,    diamond,  leftradical	            ] };
        key <AB06> { [         b, B,     ssharp,   horizconnector	        ] };
        key <AB07> { [         n, N,  dead_tilde,  asciitilde	            ] };
        key <AB08> { [     comma,  question, exclamdown,  questiondown	    ] };
        key <AB09> { [ semicolon,  period, VoidSymbol,  periodcentered	    ] };
        key <AB10> { [     colon,  slash,    exclam,    section	            ] };
};" >> "$NvFichierClavier"

# Remplacement de l'ancien fichier
	sudo mv "$NvFichierClavier" "$FichierClavierAModifier"
	sudo chmod ga+r "$FichierClavierAModifier"
	sudo chmod u+rw "$FichierClavierAModifier"
	sudo chown root:root "$FichierClavierAModifier"

# Modification de la liste des variantes dans FichierListeDesClaviersAModifier
# ----------------------------------------------------------------------------

# Trouve le numéro de ligne de la 1ere occurence de <name>fr</name>
   NumLigneBlocFr=$(grep -ne "<name>fr</name>" -m 1 "$FichierListeDesClaviersAModifier" | cut -d: -f1)

# Compte le nb de lignes
   NbLignesFichier=$(wc -l "$FichierListeDesClaviersAModifier" | cut -d' ' -f1)
   let "NbLignesApresDebutBlocFr=$NbLignesFichier-$NumLigneBlocFr"

# Repère la fin de la liste des variantes
   NumLigneFinVariantes=$(tail -n "$NbLignesApresDebutBlocFr" "$FichierListeDesClaviersAModifier" | grep -ne "</variantList>" -m 1 | cut -d: -f1)
   let "NumLigneFinVariantes=$NumLigneBlocFr+$NumLigneFinVariantes+1"

# Création du nouveau fichier par insertion de la nouvelle variante
   let "NbLignesQuiPrecedent=$NumLigneFinVariantes-1"
   let "NbLignesQuiSuivent=$NbLignesFichier-$NbLignesQuiPrecedent+1"

fichierTEMP=$(mktemp)

head -n "$NbLignesQuiPrecedent" "$FichierListeDesClaviersAModifier" > "$fichierTEMP"   #  début inchangé
   echo "        <variant>
          <configItem>
            <name>Clavier_personnalise</name>
            <description>Français disposition spécifique personnalisée</description>
            <languageList>
               <iso639Id>fra</iso639Id>
            </languageList>
          </configItem>
        </variant>" >> "$fichierTEMP"              #  nouvelle variante
   tail -n "$NbLignesQuiSuivent" "$FichierListeDesClaviersAModifier" >> "$fichierTEMP"    #  fin inchangée

# Remplacement de l'ancien par le nouveau
   sudo mv "$fichierTEMP" "$FichierListeDesClaviersAModifier"
	sudo chmod ga+r "$FichierListeDesClaviersAModifier"
	sudo chmod u+rw "$FichierListeDesClaviersAModifier"
	sudo chown root:root "$FichierListeDesClaviersAModifier"

# réinitialisation claviers -> j'ai laissé la ligne (cf discussion) mais l'opération ne semble plus nécessaire
# -------------------------
#	sudo rm /var/lib/xkb/*.xkm

# Information
# -----------

zenity --info --text="Nouveau clavier intégré dans la liste des variantes.\nVeuillez redémarrer le système puis vous reconnecter pour que le nouveau clavier soit pris en compte.\nLe changement de clavier se fait ensuite dans le dialogue des préférences de clavier.\nEn cas de problème, essayer de désactiver le pavé numérique (Fn+Insert)"
	echo -e "Nouveau clavier intégré dans la liste des variantes.\nVeuillez redémarrer le système puis vous reconnecter pour que le nouveau clavier soit pris en compte.\nLe changement de clavier se fait ensuite dans le dialogue des préférences de clavier.\nEn cas de problème, essayer de désactiver le pavé numérique (Fn+Insert)"

exit 0;
</code>

Ce script a été testé avec succès en 2019 sur une installation Xenius 16.04.

<note>
  * Le nom de la variante (dans l'exemple « Clavier_personnalise ») doit être identique dans les 2 fichiers et dépourvu d'espaces et d'accents.
  * Dans la liste des claviers, c'est la description (<description>Français disposition spécifique personnalisée</description>) du fichier evdev.xml qui sera mentionnée et triée par ordre alphabétique, d'où l'importance de commencer celle-ci par le mot « Français ». Dans le fichier les autres variantes sont identifiées « French » puis traduites automatiquement mais cela n'est pas le cas des variantes personnalisées, sauf probablement à intervenir dans les locales ce qui est probablement très « pur » mais pas très utile (sauf peut-être pour un constructeur de clavier).
  * Il est très utile de mentionner le groupe pour le classement dans la liste des nombreux claviers.
  * La ligne « include \"fr(basic)\" » en début de fichier des claviers est absolument nécessaire, au risque de se retrouver avec un clavier dont seules les touches modifiées sont affectées.
  * la mise à jour des droits des fichiers est elle aussi essentielle, au risque que le nouvel agencement ne fonctionne pas dans la fenêtre de connexion.
 </note>
=== ===
----
//Contributeurs: [[:utilisateurs:jaaf64]], [[:utilisateurs:fabux]], [[:utilisateurs:zococo]]//

Merci de recopier le code ci-contre pour prouver que vous êtes humain : J G Q T B Merci de laisser ce champ vide :

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Paternité-Partage des Conditions Initiales à l'Identique 3.0 Unported