# O Manual do &kxkb;

## Introdução

O &kxkb; é o utilitário do &kde; para a mudança da disposição do teclado. Baseia-se na extensão do X11, a 'xkb', e permite usar várias disposições de teclado diferentes para introduzir texto. O &kxkb; oferece um indicador da disposição do teclado.

## Usar o &kxkb;

### Começar

O &kxkb; inicia-se automaticamente e permanece na bandeja do sistema como uma bandeira com uma abreviatura de 2 ou 3 letras do nome da disposição do teclado por cima desta, se estiver mais do que uma disposição definida ou se a opção Mostrar o indicador para apenas uma disposição estiver activada.

Quando o &kxkb; está em execução, você poderá alterar as disposições ao carregar no seu ícone na bandeja com o rato ou ao executar o seu atalho de teclado. O atalho de teclado ou o pressionar do botão do rato irão mudar para a próxima disposição ou, em alternativa, você poderá carregar com o &RMB; no ícone do &kxkb; e seleccionar a disposição na lista.

Se carregar com o &RMB; no ícone do &kxkb; você poderá iniciar a sua configuração ao seleccionar a opção Configurar... ou ao abrir o Centro de Controlo e ao seleccionar a janela Localização/Disposição do Teclado. Em alternativa, você poderá iniciá-la ao escrever e executar o comando `kcmshell keyboard_layout` num terminal.

## Configurar o &kxkb;

### Informações Gerais

A Configuração do KXKB consiste em duas páginas: a Configuração da Disposição e as Opções do XKB, as quais são mutuamente independente. A primeira define as disposições que você deseja usar, bem como as suas, opções, enquanto que a segunda define os parâmetros para a extensão Xkb na qual se baseia o &kxkb;. As opções do 'xkb' são uma propriedade do X e não são geridas de forma alguma pelo &kxkb; - ele apenas as configura.

A configuração do &kxkb; não altera nada nos ficheiros de configuração do XFree86 e a configuração das disposições do XFree86 são sobrepostas pelo &kxkb; se a opção `Activar a disposição do teclado` estiver activa.

Para tornar a sua configuração do XFree86 funcional você terá de desligar tanto a opção `Activar a disposição do teclado` na página de configuração das disposições como a `Activar as opções do 'xkb'` na página de configuração das opções do Xkb (na última, o mesmo efeito poderá ser obtido se a opção `Repor as Opções Antigas` estiver desligada e nenhuma das opções do 'xkb' estiver definida).

O &kxkb; efectua a maior parte das suas acções através do comando `setxkbmap`. Você poderá ver a linha de comandos que é executada para cada disposição activa quando a selecciona e na página das opções do 'xkb', onde está disponível no conjunto de opções do 'xkb'.

### Configuração da Disposição

Na janela de configuração das disposições, a lista das disposições disponíveis está à sua esquerda. Você terá de escolher cada uma das disposições que pretende usar e adicioná-las (uma a uma) à lista de disposições activas à direita. Você também poderá alterar a ordem pela qual as disposições activas serão mudadas quando comutadas pelo atalho de teclado ou pela acção do botão do rato. A primeira disposição da lista tornar-se-á a disposição por omissão.

Algumas disposições têm diversas variantes. As variantes das disposições representam normalmente vários mapas de teclado para a mesma língua. Por exemplo, a disposição Ucraniana poderá ter quatro variantes: básica, teclas do Windows, máquina de escrever e fonética (cada letra ucraniana é colocada na sua respectiva ocidental). Se a sua disposição tem mais do que uma variante, você poderá seleccionar a variante na lista por baixo da lista de disposições activas.

A configuração do modelo do teclado é independente da sua disposição do teclado e corresponde ao modelo do "hardware", i.e., a forma como o seu teclado é fabricado. Os teclados modernos que vêm com o seu computador normalmente têm duas teclas extras e são referidos como sendo os modelos de "104 teclas", o qual será provavelmente o que você pretende se não souber qual o tipo de teclado que você tem.

Você também poderá escolher a política de mudança para a disposição do teclado. Por omissão, é a `Global`, o que significa que todas as aplicações irão partilhar a mesma disposição actual. A política por `Aplicação` significa que cada aplicação terá a sua disposição própria, e que a mudança de disposição enquanto você está a trabalhar com uma aplicação, não irá trazer impacto nenhum para as outras aplicações. A política por `Janela` fará com que cada janela tenha a sua própria disposição, mesmo que pertença ao mesmo programa.

Se você tiver definido apenas uma disposição activa, no arranque o &kxkb; configura o teclado e sairá, como tal o seu indicador não irá aparecer. Se você quiser à mesma o indicado do &kxkb; seleccione a opção `Mostrar o indicador para apenas uma disposição`.

Se você deixar a lista de disposições activas vazia, as disposições do teclado serão desactivadas

### Configuração das Opções do XKB

As opções do Xkb permitem-le seleccionar o comportamento do seu teclado. Estas opções não são geridas pelo &kxkb; mas poderão ajudar a ajustar o seu teclado às suas necessidades.

## Resolução de Problemas

### Problemas Comuns

Se você mudar para alguma disposição e não conseguir ver alguns caracteres da sua disposição à medida que escreve, verifique por favor as suas configurações locais, ⪚, no `~/.i18n` ou no `/etc/sysconfig/i18n`; a localização que você tem antes de iniciar as aplicações do &kde; precisa de uma codificação que contenha os caracteres da sua disposição. Por exemplo, para introduzir caracteres ucranianos você precisar ter definida a codificação KOI8-U, a CP1251 ou a UTF-8. A última é uma boa opção a tentar para a maioria das línguas, se você tiver algum problema destes.

Se o &kxkb; não mudar com o atalho do teclado quando você o tenta fazer com o teclado, mas consegue fazê-lo com o rato, significa que a sua disposição não contém a tecla que está atribuída no atalho.

No XFree86 anterior à versão 4.3.0 as disposições não-ocidentais incluiam mutuamente o grupo ocidental e este grupo era o que ficava por omissão, como tal ao carregar em &Ctrl;&Alt;k ficava-se sempre com a combinação correcta. A partir da versão 4.3.0, por omissão todas as disposições contêm apenas um grupo, como tal as disposições não-ocidentais poderão não funcionar aí.

As soluções possíveis são:

1. adicionar a sua disposição às listas $nonlatin ou $oldlayouts no ficheiro `/etc/X11/xkb/rules/xfree86` ou na localização das regras do 'xkb' do seu computador.

2. Altere o atalho para algo que seja independente da língua, ⪚ &Ctrl;Menu

3. Active a opção para incluir o grupo us na sua disposição (de facto, é o mesmo que a solução 1).

## Descrições dos Ficheiros e das Disposições

### Ficheiros e Disposições do xkb

Todas as disposições do teclado disponíveis estão descritas no ficheiro `/etc/X11/xkb/rules/xfree86.lst` (e no `/etc/X11/xkb/rules/xfree86.xml`, desde o XFree86 4.3.0); as disposições em si poderão ser encontradas no `/etc/X11/xkb/symbols/pc` (ou no `/etc/X11/xkb/symbols` para o XFree86 4.2.x e anteriores). Tenha em atenção que a localização destes ficheiros poderá variar, dependendo do seu sistema operativo e da sua distribuição.

O &kxkb; usa agora a extensão do 'xkb' em vez do 'xmodmap', como tal, para definir a sua própria disposição terá de obter uma do `/etc/X11/xkb/symbols` a qual se aproxima mais do que você pretende obter (ou o `/etc/X11/xkb/symbold/pc` para o XFree86 4.3.0); mude o seu nome para algo ao seu critério e edite o ficheiro. De seguida, basta adicionar o nome ao ficheiro `/etc/X11/xkb/rules/xfree86.lst` (e, para o XFree86 4.3.0 ou posterior, é uma boa ideia também adicionar o nome ao ficheiro `/etc/X11/xkb/ruls/xfree86.xml` - alguns pacotes já o usam, ainda que o &kxkb; não o use ainda), para que o &kxkb; o utilize ao reiniciar. Nota: você terá de ser o 'root' para alterar esses ficheiros.

## Créditos e Licenças

O &kxkb; é desenvolvido e mantido de momento pelo Andriy Rysin rysin@kde.org. Várias pessoas também trabalharam no kxkb:

- Shaheed Haque srhaque@iee.org

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

&underFDL; &underGPL;