# Trabalhar nos Bastidores do &kde;

Nicolas Goutte goutte@kde.org

## Editar à Mão os Ficheiros de Configuração

### Introdução

No &kde;, os ficheiros de configuração são fáceis de alterar com um editor de texto simples como o &kate;, dado que os ficheiros de configuração são ficheiros de texto.

Um exemplo de um ficheiro de texto:

    [Geral]
    AutoGravar=1
    UltimoFicheiro=/var/tmp/teste.txt

Os ficheiros de configuração de um utilizador estão em `.kde/share/config` (substitua o `.kde` pela sua variável de ambiente $`KDEHOME`) e os globais estão na subpasta `share/config` do local onde o KDE foi instalado. (Poderá encontrar esta localização se executar o comando `kde-config --prefix`.) Os seus nomes terminam normalmente em 'rc' (sem um ponto inicial), como por exemplo `kopeterc`.

Contudo, os ficheiros de configuração editados manualmente, podem comprometer a estabilidade do seu &kde;. A maioria das aplicações não verificam o que lêem dos seus ficheiros de configuração e poderão ser prejudicadas pelo que obtêm da sua configuração, fazendo com que a aplicação inclusive estoire.

### Cópias de Segurança

Por isso, a primeira regra é fazer uma cópia de segurança do seu ficheiro antes de o modificar. A cópia de segurança deverá ser guardada fora de qualquer subpasta da `.kde` (ou da pasta correspondente a $`KDEHOME`). As cópias de segurança são sempre uma boa ideia no caso de uma falha geral do &kde; que destrua os ficheiros de configuração importantes (como por exemplo as suas opções do &kmail;, que se encontram no ficheiro `kmailrc`). (Uma falha grande dessas não deveria acontecer, mas pode à mesma ocorrer.)

### Edição

Assim, para quê mexer nos ficheiros de configuração? Bem, primeiro, é necessário se quiser obrigar o uso do modo KIOSK. Talvez um programador lhe tenha pedido para adicionar um item que o ajude a depurar um erro. Talvez queira recuperar de um problema sem ter de remover toda a pasta `.kde`. Talvez queira aprender mais sobre os detalhes do &kde;.

De qualquer forma, seja qual for a razão, poderá desejar modificar à mão um ficheiro de configuração.

Ao planear editar um ficheiro desses, certifique-se que a aplicação que o usa não está a correr. Se for um dos ficheiros de configuração, pense em editar o ficheiro enquanto o &kde; não está a correr de todo.

Está pronto? Faça então uma cópia de segurança (já foi dito alguma vez?), inicie o seu editor favorito (assumindo neste caso o &kate;), abra o ficheiro (tenha o cuidado de o carregar como UTF-8, dado que o &kate; o mostra utf8).

Agora terá um ficheiro do tipo:

    [Grupo]
    Chave1=Valor1
    Chave2=Valor2
    Chave3=Valor3

Poderá agora modificá-lo (com cuidado!) e depois gravá-lo (garantido outra vez que é UTF-8).

Agora, poderá testar a aplicação e, se esta não executar mais correctamente, feche-a e reponha a cópia de segurança.

### Informação Relacionada

- kde-for-administrators tem mais informações sobre a estrutura de pastas do &kde;, de modo a ajudá-lo a encontrar o ficheiro que precisa de editar.

## Programar o Ambiente de Trabalho

Uma breve introdução à programação em DCOP. O 'kdcop'.

## Adicionar Atalhos de Teclado Extra para o &kde;

Muitos teclados modernos contêm teclas extra que não estão atribuídas por omissão a nenhuma acção.

As teclas Multimédia geram normalmente um sinal e podem simplesmente ser escolhidas como uma combinação de teclas dentro de uma aplicação, como quem escolhe uma tecla qualquer. Algumas das teclas, todavia, não são detectadas e, se carregar nelas no Configurar os Atalhos, não fará efeito.

Alguns portáteis da IBM, por exemplo, têm teclas extra em torno dos cursores esquerdo e direito, e que parecem um Page Left e um Page Right.

1. Use o `xev` para descobrir o código das teclas. Neste caso, este é o 233 e o 234, respectivamente

2. Escolha os símbolos das teclas. Existe alguns intervalos que não são usados por omissão, por isso muitos estão livres. Poderá encontrar a lista em `/usr/X11R6/include/X11/keysymdef.h` (ou o equivalente no seu sistema).

3. Crie um ficheiro na sua pasta pessoal chamado `.Xmodmap` e adicione o seguinte a ele:

       keycode 233 = Next_Virtual_Screen
       keycode 234 = Prev_Virtual_Screen

4. Execute o comando ``xmodmap` `~/.Xmodmap``

Nesta altura, deverá ser capaz de executar o `xev` de novo e ver que as teclas geram agora o símbolo da tecla que atribuiu. Poderá aora atribuir esses símbolos a qualquer acção, como de costume.

## Informação Relacionada

- A página de manual do `xev`. Poderá ver isso se executar `man:/xev` numa janela do &konqueror; ou se executar ``man` xev` num terminal.

## Adicionar Combinações de Teclas às Acções Novas

A maioria das acções do ecrã ou das aplicações estão logo disponíveis para poder associar uma combinação de teclas. Se a acção a que deseja atribuir um atalho foi algo criado por si ou que ainda não esteja disponível, você poderá à mesma atribuir um atalho.

Para reunir as duas secções anteriores, talvez queira atribuir uma tecla não usada do seu teclado a um programa ou comando de DCOP. O exemplo aqui será então atribuir as duas teclas que foram adicionadas em adding-extra-keys para ir para o ecrã virtual anterior ou o seguinte, ou seja, duas funções para as quais irá necessitar do DCOP (tal como foi descrito em scripting-the-desktop.

Isto pode ser conseguido facilmente com o seguinte método:

1. Abra o &kcontrol; na secção Regional & Acessibilidade, mais concretamente no KHotKeys

2. Escolha a Nova Acção

3. Dê um nome à acção nova, ⪚ `Próximo Ecrã Virtual`

4. Seleccione o Atalho de teclado -> Comando/URL (simples) para o Tipo de acção:

5. Na página do Atalho do Teclado, carregue no botão que deseja usar para despoletar o comando. Para este exemplo, iria carregar na tecla com a imagem do Próxima Página nele. O Next_Virtual_Screen irá aparecer na imagem da tecla.

6. Na página do Configuração do Comando/URL, indique o comando a executar no campo: ``dcop kwin default nextDesktop``

Repita os passos anteriores com a tecla Prev_Virtual_Screen key e a acção ``dcop kwin default previousDesktop``.

Agora, se carregar nas teclas Prev_Virtual_Screen ou Next_Virtual_Screen, irá mudar para o ecrã virtual anterior ou o próximo, respectivamente.

Obviamente, poderá atribuir qualquer tecla livre a qualquer acção.

## Informação Relacionada

- Veja a documentação do KHotKeys no &khelpcenter;, ou escreva `help:/khotkeys` numa janela do &konqueror;.

- adding-extra-keys

- scripting-the-desktop

## &kdebugdialog; - Controlar o Resultado da Depuração do &kde;

### Utilização Básica

O &kdebugdialog; não está no &kmenu; por omissão. Terá de o executar na linha de comandos ou na mini-janela de execução de comandos com ``kdebugdialog``. O &kdebugdialog; mostra uma janela com uma lista grande de áreas de depuração. Cada área tem uma opção que poderá ligar ou desligar para activar ou desactivar o resultado de depuração dessa parte do &kde;.

A lista de áreas de depuração vem ordenada numericamente, não alfabeticamente, como tal o kio (127) vem antes do artskde (400). Os números vão até perto de 200 000, mas normalmente só existem 400 áreas. Não terá de percorrer a lista completa para encontrar a área que precisa. Existe um campo de texto no topo da janela, onde poderá indicar uma parte do nome da área que deseja. A lista de itens que é apresentada é filtrada de modo a incluir apenas as áreas de depuração que contêm o texto que introduziu, ⪚ se introduzir `k` não irá filtrar muito mas, se indicar `kont`, deverá aparecer apenas as áreas de depuração do &kontact;. Como uma forma mais rápida de activar ou desactivar o resultado de depuração, existe também os botões para seleccionar tudo e deseleccionar tudo, que fará com que o &kde; produza bastantes dados de depuração, ou quase nenhuns.

### O KDebugDialog no modo completo

No modo completo, que é o que você irá obter ao executar o KDebugDialog como ``kdebugdialog` `--fullmode``, fica disponível a mesma lista de áreas de depuração, podendo seleccionar apenas uma de cada vez numa lista. Poderá então definir o resultado para os vários tipos de mensagens: Informação, Aviso, Erro e Erro Fatal. Para cada um destes tipos, poderá escolher para onde são enviadas as mensagens. As opções são:

Ficheiro, onde terá de indicar o nome de um ficheiro. Este será escrita na sua pasta $`HOME`.

Janela de Mensagem. Cada mensagem de depuração é mostrada numa janela de informação, pelo que terá de carregar em OK para continuar com a a aplicação.

Linha de Comandos, o item por omissão. As mensagens são impressas no 'stderr' e irão aparecer tanto na janela da linha de comados em que a aplicação foi iniciada, como no `.xsession-errors`.

Syslog. Este envia cada mensagem de depuração para a funcionalidade de registo do systema ('syslog'), o qual poderá efectuar um processamento prévio da mensagem.

Nenhum. Isto elimina o resultado deste tipo de mensagem.

Para as mensagens geradas pelos erros fatais, é normalmente uma má ideia escolher o Nenhum ou o Syslog, dado que em ambos os casos poderá não ver a mensagem e a aplicação que obtenha o erro fatal irá desaparecer ser deixar uma razão do seu desaparecimento. Se a aplicação desaparecerá ou não no caso de um erro fatal, poderá ser definido na opção Abortar nos erros fatais, que está assinalada por omissão — mas poderá contar à mesma que uma aplicação estoire (de forma confusa) se for encontrado um erro à mesma.

### Informação Relacionada