# Manuale di &kxkb;

## Introduzione

&kxkb; è il programma accessorio per cambiare la mappatura della tastiera di &kde;. È basato sull'estensione xkb di X11, e permette di usare diverse mappature di tastiera per inserire testo. &kxkb; comprende un indicatore della mappatura della tastiera.

## Uso di &kxkb;

### Per cominciare

&kxkb; viene avviato automaticamente e rimane nel vassoio di sistema come una bandiera, con un'abbreviazione di 2 o 3 lettere del nome della mappatura sopra di essa, se è definito più di uno schema, o l'opzione Mostra indicatore per mappatura singola è attivata.

Quando &kxkb; è in esecuzione, puoi cambiare le mappature facendo clic con il mouse sulla sua icona del vassoio, o premendo la sua scorciatoia da tastiera. Una scorciatoia da tastiera o un clic del mouse commuteranno alla prossima mappatura, o alternativamente puoi fare clic destro sull'icona di &kxkb;, e selezionare una mappatura dall'elenco.

Facendo clic destro sull'icona di &kxkb;, puoi avviare la sua configurazione selezionando Configura..., o puoi aprire il Centro di Controllo e selezionare Regionali e Accesso facilitato/Mappatura della tastiera. Alternativamente, puoi avviarlo scrivendo `kcmshell keyboard_layout` in un terminale.

## Configurare &kxkb;

### Informazioni generali

La configurazione di &kxkb; consiste di due schede: Configurazione della mappatura e Opzioni Xkb, che sono tra loro indipendenti. La prima definisce le mappature che vuoi usare e le loro opzioni, e la seconda definisce i parametri per l'estensione Xkb sulla quale si basa &kxkb;. Le opzioni Xkb sono una proprietà di X e non sono gestite in alcun modo da &kxkb; - le configura e basta.

La configurazione di &kxkb; non cambia nulla nei file di configurazione di XFree86, e le impostazioni di mappatura della configurazione di XFree86 sono sostituite da &kxkb; se l'opzione `Abilita le mappature della tastiera` è attivata.

Per far funzionare la tua configurazione di XFree86 devi disattivare sia `Abilita le mappature della tastiera` nella scheda di configurazione delle mappature, sia `Abilita le opzioni di xkb` nella scheda di configurazione delle opzioni di Xkb (per l'ultimo si può ottenere lo stesso effetto se `Reimposta vecchie opzioni` è disattivato e nessuna delle opzioni xkb è impostata).

&kxkb; fa la maggior parte delle sue azioni attraverso il comando `setxkbmap`. Puoi vedere la riga di comando da eseguire per ogni mappatura attiva quando la selezioni, e, sulla scheda delle opzioni di xkb, il suo insieme di opzioni Xkb impostate.

### Configurazione della mappatura

Nel dialogo di configurazione della mappatura l'elenco delle mappature disponibili è alla tua sinistra. Devi scegliere ogni mappatura che vuoi usare e aggiungerla (una alla volta) all'elenco di mappature attive sulla destra. Puoi anche cambiare l'ordine in cui le mappature attive saranno cambiate su commutazione di una scorciatoia da tastiera o pulsante del mouse. La prima mappatura dell'elenco diventa la mappatura predefinita.

Alcune mappature hanno più varianti. Le varianti della mappature di solito rappresentano diverse mappe per la stessa lingua. Per esempio, la mappatura ucraina può avere quattro varianti: base, winkeys (come in Windows), typewriter (come sulle macchine da scrivere) e phonetic (ogni lettera ucraina è posizionata su una lettera latina traslitterata). Se la tua mappatura è multivariante, puoi scegliere la variante nella casella combinata sotto l'elenco delle mappature attive.

L'impostazione del modello della tastiera è indipendente dalla tua mappatura della tastiera, e si riferisce al modello "hardware", cioè come è stata prodotta la tua tastiera. Le tastiere moderne che vengono allegate ai computer hanno di solito due tasti aggiuntivi, e sono indicate come modelli a "104 tasti", che è probabilmente quello che dovresti scegliere se non sai che tipo di tastiera hai.

Puoi anche scegliere la politica di commutazione per la mappatura della tastiera. Come valore predefinito, `Globale` farà in modo che tutte le applicazioni condividano la stessa mappatura attuale. `Applicazione` significa che ogni applicazione avrà la sua mappatura, e cambiare la mappatura mentre lavori con un'applicazione non avrà influenza sulle mappature delle altre. `Finestra` farà avere a tutte le finestre la loro mappatura, anche se appartengono allo stesso programma.

Se imposti solo una mappatura attiva, all'avvio &kxkb; configurerà la tastiera e uscirà, quindi il suo indicatore non apparirà. Se vuoi comunque l'indicatore di &kxkb;, seleziona l'opzione `Mostra l'indicatore per una mappatura singola`.

Se lasci vuoto l'elenco di mappature attive, le mappature di tastiera saranno disabilitate.

### Configurazione delle opzioni XKB

Le opzioni Xkb ti permettono di selezionare il comportamento della tua tastiera. Queste opzioni non sono gestite da &kxkb;, ma possono aiutarti ad adattare la tua tastiera alle tue esigenze.

## Risoluzione dei problemi

### Problemi comuni

Se cambi a qualche mappatura e non puoi vederne alcuni caratteri mentre scrivi, per piacere controlla le tue impostazioni di localizzazione, per esempio `~/.i18n` o `/etc/sysconfig/i18n`. La localizzazione che hai prima di avviare le applicazioni di KDE deve avere una codifica che contenga i caratteri della tua mappatura. Per esempio, per inserire simboli ucraini devi avere una codifica KOI-8U, CP1251 o UTF-8. Quest'ultima è una buona scelta per la maggior parte delle lingue se hai un problema di questo genere.

Se &kxkb; non cambia con una scorciatoia da tastiera quando lo commuti a qualche mappatura, ma cambiare con il mouse funziona bene, può voler dire che la tua mappatura non contiene il tasto assegnato alla scorciatoia.

In XFree86, prima della versione 4.3.0, le mappature non latine includevano mutuamente il gruppo latino, e questo gruppo era predefinito; quindi premere &Ctrl;&Alt;k rendeva sempre la combinazione corretta. Dalle versione 4.3.0, come impostazione predefinita, tutte le mappature contengono solo un gruppo, quindi le mappature non latine potrebbero non funzionare.

Le soluzioni possibili sono:

1. aggiungi la tua mappatura agli elenchi $nonlatin o $oldlayouts in `X11/xkb/rules/xfree86`, o nella posizione delle regole xkb sul tuo computer.

2. Cambia la scorciatoia a qualcosa di neutro rispetto alle lingue, per esempio &Ctrl;Menu.

3. Attiva l'opzione di includere il gruppo us nella tua mappatura (all'atto pratico è lo stesso che la soluzione 1).

## Descrizioni di file e mappature

### File e mappature xkb

Tutte le mappature di tastiera disponibili sono descritte in `/etc/X11/xkb/rules/xfree86.lst` (e `/etc/X11/xkb/rules/xfree86.xml` da XFree 4.3.0), le mappature stesse possono essere trovate in `/etc/X11/xkb/symbols/pc` (o `/etc/X11/xkb/symbols` per XFree 4.2.x e precedenti). Nota come la posizione di questi file possa essere diversa a seconda del tuo sistema operativo e della tua distribuzione.

&kxkb; ora usa l'estensione xkb invece di xmodmap, per cui per definire la tua mappatura personale devi prenderne una da `/etc/X11/xkb/symbols` che sia più vicina possibile quella che desideri ottenere (o `/etc/X11/xkb/symbold/pc` per XFree 4.3.0), rinominarla a qualcosa che ti piace e modificarla. Quindi aggiungi il nome a `/etc/X11/xkb/rules/xfree86.lst` (e per XFree86 4.3.0 o successivo è una buona idea aggiungere il nome anche a `/etc/X11/xkb/ruls/xfree86.xml` - alcuni pacchetti lo usano già, però non ancora &kxkb;). &kxkb; la userà al riavvio. Nota: devi essere root per modificare questi file.

## Riconoscimenti e licenza

&kxkb; è attualmente sviluppato e mantenuto da Andriy Rysin rysin@kde.org. Diverse altre persone hanno lavorato su kxkb:

- Shaheed Haque srhaque@iee.org

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

&underFDL; &underGPL;