# Manuel de &kxkb;

## Introduction

&kxkb; est l'utilitaire &kde; permettant de changer de disposition de clavier, basé sur l'extension X11 xkb et vous permet d'utiliser différentes dispositions de clavier pour saisir du texte. &kxkb; dispose d'un indicateur de disposition de clavier.

## Utilisation de &kxkb;

### Premiers pas

&kxkb; démarre automatiquement et reste dans la boîte à miniatures en tant que drapeau. L'abréviation de la disposition sur deux ou trois lettres apparaît au-dessus de celui-ci si plus d'une disposition ont été définies ou si l'option Afficher l'indicateur lorsqu'une seule disposition est sélectionnée est activée.

Lorsque &kxkb; fonctionne, vous pouvez changer la disposition du clavier en cliquant sur son icône dans la boîte à miniatures, ou avec son raccourci clavier. Le raccourci clavier ou le clic de souris activera la disposition de clavier suivante. Vous pouvez également cliquer avec le &BDS; sur l'icône de &kxkb; et sélectionner la disposition de clavier dans la liste.

En cliquant avec le &BDS; sur l'icône de &kxkb;, vous pouvez configurer l'application en choisissant Configurer... ou en ouvrant le centre de configuration et en choisissant Régionalisation et accessibilité / Disposition du clavier. Vous pouvez également le démarrer en saisissant `tdecmshell keyboard_layout` dans un terminal.

## Configuration de &kxkb;

### Informations générales

La configuration de &kxkb; repose sur trois onglets : disposition, options de basculement et options XKb. Disposition et options XKb sont mutuellement indépendants. L'onglet disposition définit les dispositions que vous souhaitez utiliser et leurs options. L'onglet des options de basculement définit la manière de passer d'une disposition à l'autre, et l'onglet options XKb définit les paramètres pour l'extension Xkb, sur laquelle &kxkb; est basée. Les options Xkb sont spécifiques à X et ne sont pas gérées pas &kxkb; - il permet juste de les régler.

La configuration de &kxkb; ne change rien aux fichiers de configuration de XFree86 et les dispositions de clavier de la configuration de XFree86 sont remplacées par &kxkb; si l'option `Activer les dispositions de clavier` est cochée.

Pour faire fonctionner votre configuration XFree86, vous devez à la fois décocher `Activer les dispositions de clavier` dans l'onglet disposition et `Activer les options de xkb` dans l'onglet des options XKb (pour ce dernier, le même effet peut être obtenu si `Réinitialiser les anciennes options` est décochée et qu'aucune option xkb n'est réglée).

&kxkb; fait la plupart de ses actions à l'aide de la commande `setxkbmap`. Vous pouvez voir la ligne de commande exécutée pour chaque disposition active lorsque vous la sélectionnez, et dans l'onglet des options de xkb, ses options xkb disponibles.

### Configuration des dispositions

L'onglet disposition L'onglet disposition

Dans la boîte de dialogue de configuration de la disposition, la liste des dispositions disponibles se trouve sur la gauche. Choisissez les dispositions que vous voulez utiliser et ajoutez-les (une par une) dans la liste des dispositions actives à droite. Vous pouvez également modifier l'ordre dans lequel les dispositions actives défileront lorsque le raccourci clavier ou le bouton de la souris seront activés. La première disposition de la liste devient la disposition par défaut.

Certaines dispositions ont des variantes. Les variantes représentent généralement des dispositions de touches différentes pour la même langue. Par exemple, la disposition de clavier en ukrainien a quatre variantes : basic, winkeys (comme dans Windows), typewriter (comme les machines à écrire) et phonetic (chaque lettre est placée sur une lettre latine correspondante). Si votre disposition contient des variantes, vous pouvez sélectionner la variante dans la liste déroulante en dessous de la liste des dispositions actives.

La configuration du modèle de clavier est indépendante de votre disposition de clavier et se réfère au modèle « matériel », &cad; à la façon dont votre clavier est fabriqué. Les claviers modernes fournis avec votre ordinateur ont généralement deux touches supplémentaires, et on parle alors de modèles « 104 touches ». Cela correspond probablement à votre clavier si vous ne savez pas quel type de clavier vous avez.

Vous pouvez également choisir la règle de basculement entre les dispositions de clavier. Par défaut, il s'agit de `Globale`, où toutes les applications partagent la même disposition de clavier.`Application` signifie que chaque application aura sa propre disposition et si vous changez de disposition lorsque vous travaillez avec une application, les dispositions des autres applications ne seront pas modifiées. Avec l'option `Fenêtre`, toutes les fenêtres auront leur propre disposition même si elles appartiennent au même programme.

Si vous ne configurez qu'une disposition, kxkb configure le clavier au démarrage et s'arrête, ainsi son indicateur n'apparaîtra pas. Si vous souhaitez tout de même avoir l'indicateur, sélectionnez l'option `Afficher l'indicateur lorsqu'une seule disposition est sélectionnée`.

Si la liste des dispositions actives est vide, les dispositions de clavier seront désactivées.

### Options de basculement

L'onglet options de basculement L'onglet options de basculement

Afficher l'indicateur lorsqu'une seule disposition est sélectionnée

- Affiche une icône dans la boîte à miniatures même s'il n'y a qu'une disposition de clavier.

Afficher le drapeau du pays

- Affiche le drapeau du pays à derrière le nom de la disposition dans la boîte à miniatures.

Règle de basculement

- Si vous choisissez les règles de basculement Application ou Fenêtre, le changement de disposition de clavier n'affectera que l'application ou la fenêtre en cours. Globale permet d'appliquer globalement les règles de basculement à toutes les applications et toutes les fenêtres.

Changement à mémoire

- Si vous avez au moins deux dispositions de clavier et cochez Activer le changement à mémoire, le basculement à l'aide du raccourci-clavier ou en cliquant sur l'indicateur de kxkb ne se fera qu'avec les dernières dispositions. Vous pouvez préciser le nombre de dispositions utilisées pour la rotation en dessous, dans la boîte Nombre de dispositions pour boucler. Vous pouvez toujours accéder aux autres dispositions en cliquant avec le bouton droit de la souris sur l'indicateur de &kxkb;.

### Configuration des options de XKB

L'onglet Xkb L'onglet Xkb

Les options de Xkb vous permettent de configurer le comportement de votre clavier. Ces options ne sont pas gérées par &kxkb;, mais peuvent vous aider à adapter votre clavier à vos besoins. Vous pouvez régler les options des extensions de Xkb au lieu de les spécifier dans le fichier de configuration de X11, ou en complément du fichier de configuration.

## Disfonctionnements

### Problèmes courants

Si vous basculez vers une disposition et si vous ne pouvez pas voir certains caractères lorsque vous utilisez cette disposition, veuillez vérifier vos paramètres locaux. Par exemple, `~/.i18n` ou `/etc/sysconfig/i18n`. Les « locales » que vous aviez avant de démarrer des applications kde doivent avoir un encodage qui contient les caractères de votre disposition de clavier. Par exemple, pour saisir des symboles ukrainiens, vous devez avoir les encodages KOI8-U, CP1251 ou UTF-8. Ce dernier est un bon choix pour la plupart des langages si vous rencontrez un tel problème.

Si kxkb ne change pas de disposition de clavier avec le raccourcis clavier mais change de disposition en utilisant la souris, alors il est possible que votre disposition de clavier ne contienne pas la touche assignée au raccourci clavier.

Dans les versions de XFree86 antérieures à la version 4.3.0, les dispositions de clavier non latin incluaient le groupe latin et c'était le groupe par défaut, ainsi en pressant &Ctrl;&Alt;k, la bonne combinaison est produite. À partir de la version 4.3.0, les dispositions ne contiennent par défaut qu'un groupe. Ainsi les dispositions non latin ne fonctionneront pas ici.

Les solutions possibles sont :

1. ajouter votre disposition aux listes $nonlatin ou $oldlayouts dans `/etc/X11/xkb/rules/xfree86` ou à l'endroit où se trouvent les règles de xkb dans votre ordinateur.

2. Modifier les raccourcis en choisissant quelque chose de neutre, par exemple &Ctrl;Menu

3. Activer l'option pour inclure le groupe fr dans votre disposition (en fait la même chose que la première solution).

## Descriptions des fichiers et des dispositions

### Fichiers xkb et dispositions

Toutes les dispositions de claviers sont décrites dans `/etc/X11/xkb/rules/xfree86.lst` (et dans `/etc/X11/xkb/rules/xfree86.xml` depuis XFree86 4.3.0), les dispositions elles-mêmes peuvent être trouvées dans `/etc/X11/xkb/symbols/pc` (ou `/etc/X11/xkb/symbols` pour XFree86 4.2.x et versions antérieures). Notez que l'endroit où se trouvent ces fichiers peut varier en fonction de votre système d'exploitation et de votre distribution.

&kxkb; utilise maintenant les extensions xkb au lieu de xmodmap. Ainsi, pour définir votre propre disposition de clavier, vous devez en prendre dans `/etc/X11/xkb/symbols` la disposition qui se rapproche le plus de ce que vous voulez (ou dans `/etc/X11/xkb/symbold/pc` pour XFree86 4.3.0), renommez-la et modifiez-la. Ajoutez simplement son nom dans `/etc/X11/xkb/rules/xfree86.lst` (et pour XFree86 4.3.0 et supérieur, ajoutez aussi le nom dans `/etc/X11/xkb/ruls/xfree86.xml` - certains paquetages l'utilisent aussi, pas &kxkb; cependant), kxkb ira le chercher au démarrage. Notez que vous devez être root pour modifier ces fichiers.

## Remerciements et licence

&kxkb; est actuellement développé et maintenu par Andriy Rysin rysin@kde.org. Plusieurs autres personnes ont travaillé sur kxkb :

- Shaheed Haque srhaque@iee.org

- Ilya Konstantinov kde-devel@future.galanet.net

&underFDL; &underGPL;