# Configurar o &kate;

## Introdução

O &kate; oferece várias formas de equipar a aplicação para que se comporte como desejado. As mais importantes são:

A Janela de Configuração

- A ferramenta de configuração principal, que permite ao utilizador configurar a aplicação &kate;, o componente do editor e a utilização de 'plugins'.

O Menu Configuração

- permite-lhe alterar as opções mais usadas e lançar as janelas de configuração.

O Menu Ver

- Permite-lhe repartir a janela actual, assim como mostrar a barra de ícones e de números de linha para o documento actual.

O terminal incorporado usa a configuração definida no &systemsettings;, e pode ser configurado se carregar com o botão direito do rato para mostrar um menu de contexto.

## A Janela Principal de Configuração

A janela de configuração do &kate; mostra uma árvore com os tópicos à esquerda, bem como uma página de configuração correspondente ao tópico seleccionado à direita. A árvore agrupa as páginas da janela em grupos lógicos.

A configuração está dividida em dois grupos, nomeadamente

- Configuração da aplicação

- Configuração do componente de edição

## A Configuração da Aplicação &kate;

Este grupo contém páginas para configurar a aplicação principal do &kate;

### Geral

Esta secção contém algumas opções globais para o &kate;

Comportamento

- Avisar acerca de ficheiros modificados por outros processos

- Quando esta opção estiver activa, o &kate; notificá-lo-á dos ficheiros modificados fora da aplicação, sempre que a janela principal for colocada em primeiro plano. Será então capaz de lidar com vários ficheiros modificados de uma vez, os quais poderá voltar a carregar, gravar ou esquecer os ficheiros alterados nos grupos.

  Se não estiver activada, o &kate; perguntar-lhe-á a acção a fazer, quando um ficheiro modificado externamente ficar em primeiro plano, dentro da aplicação.

Meta-Informação

- Manter a meta-informação das sessões anteriores

- Quando estiver activa, o &kate; irá guardar alguns meta-dados, como a configuração dos favoritos e da sessão, mesmo quando fechar os seus documentos. Os dados serão usados, se o documento não estiver alterado, quando for aberto de novo.

Remover a meta-informação não usada após

- Indica o número máximo de dias durante os quais mantém a meta-informação dos ficheiros por abrir. Isto mantém a base de dados de meta-informação com um tamanho razoável.

### Sessões

Esta secção contém opções relacionadas com a utilização das sessões.

Elementos das Sessões

- Incluir a configuração da janela

- Se estiver activada esta opção, o &kate; irá gravar a configuração da janela com cada sessão.

Comportamento no Arranque da Aplicação

- Seleccione a forma como deseja que o &kate; se comporte no arranque. Esta opção poderá ser substituída se definir o que fazer na linha de comandos.

  Iniciar uma sessão nova

- Com esta opção, o &kate; irá iniciar uma sessão nova sem nome, quando a iniciar.

Carregar a última sessão usada

- O &kate; irá usar a sessão mais recente no arranque. Isto é bom se quiser usar a mesma sessão sempre ou deseja mudar raramente.

Escolher manualmente uma sessão

- O &kate; irá mostrar uma pequena janela que lhe permite escolher a sua sessão preferida ou carregar a sessão predefinida, caso não tenha sido gravada nenhuma. Este é o comportamento por omissão. Isso é bom se usar bastantes sessões diferentes com frequência.

As alterações nos dados da sessão (ficheiros abertos e, se estiver activa, a configuração das janelas) serão sempre guardadas.

### 'Plugins'

Esta página oferece uma lista de 'plugins' instalados para a aplicação &kate;. Cada 'plugin' é representado pelo seu nome e uma breve descrição. Poderá assinalar a opção com um item para activar o 'plugin' que representa.

Se um 'plugin' tiver opções de configuração, irá aparecer uma secção para aceder a estas, como filha desta página.

Para mais informações sobre os 'plugins' disponíveis, consulte os plugins.

### Documentos

Sombra do Fundo

- Esta página permite-lhe activar ou desactivar a visualização sombreada do fundo da sua actividade recente e escolher as cores a usar, se estiver activada. Veja a secção sobre a Lista de Documentos para mais dados sobre esta funcionalidade.

Ordenar Por

- Indique como deseja ordenar a lista de documentos. Isto também poderá ser feito, com o menu do &RMB;, na lista de documentos.

Modo de Visualização

- Isto oferece duas opções que afectam a apresentação da área de Documentos. A opção da Árvore irá mostrar os documentos como uma árvore por baixo das pastas em que se encontram, enquanto a Lista irá mostrar uma lista plana com todos os documentos.

Mostrar a Localização Completa

- Quando o modo em Árvore e esta opção estiver activos, os itens da pasta que aparecem na área de Documentos irão mostrar a localização completa da pasta no sistema de ficheiros, para além do seu nome. Não tem qualquer efeito na Lista.

### Terminal

Esta página só aparece na ferramenta do Terminal, que se encontra activa por omissão.

Sincronizar automaticamente o terminal com o documento actual se possível

- Isto fará com que o terminal incorporado faça `cd` para a pasta do documento activo quando for lançado e de cada vez que um novo documento passar para primeiro plano. Se não estiver activo, tem de efectuar a sua navegação no &konsole; por si próprio.

Mudar a variável de ambiente EDITOR para 'kate -b'

- Isto muda a variável de ambiente `EDITOR`, para que os programas que se executem no terminal incorporado abram automaticamente um ficheiro no &kate; em vez de usar o editor predefinido da sua consola. Não poderá continuar a usar o terminal até que tenha fechado o ficheiro no &kate;, para que o programa invocado saiba que acabou de editar o ficheiro.

&configuring-part-sections;

## Configurar com Variáveis do Documento

As variáveis do &kappname; são a implementação do 'katepart' para as variáveis do documento, de forma semelhante ao que acontece com as linhas de modo do ' emacs' e 'vi'. No 'katepart', as linhas têm o seguinte formato: `kate: NOME-VARIÁVEL VALOR; [ NOME-VARIÁVEL VALOR; ... ]` As linhas poderão estar obviamente num comentário, caso o ficheiro esteja num formato com comentários. Os nomes das variáveis são palavras únicas (sem espaços em branco) e tudo o que exista até ao ponto-e-vírgula seguinte é o valor. O ponto-e-vírgula é obrigatório.

Aqui está uma linha de variáveis de exemplo, forçando a configuração da indentação para um ficheiro em C++, Java ou JavaScript:

    // kate: replace-tabs on; indent-width 4; indent-mode cstyle;

Só são pesquisadas por linhas de variáveis as 10 primeiras e últimas linhas de cada ficheiro.

Adicionalmente, as variáveis do documento são colocadas num ficheiro chamado `.kateconfig` em qualquer pasta, sendo aplicada a configuração definida como se as linhas de modo fossem introduzidas em todos os ficheiros da pasta e das suas sub-pastas, até ao limite da profundidade de pesquisa configurada. As variáveis do documento no `.kateconfig` usam a mesma sintaxe das linhas de modo.

Existem variáveis para suportar quase todas as configurações da 'katepart' e também os 'plugins' poderão usar as variáveis; nesse caso, isso deverá estar referido na documentação do 'plugin'.

### Como é que o &kappname; usa as Variáveis

Ao ler a configuração, o 'katepart' procura nos seguintes locais (por essa ordem):

- A configuração global.

- Os dados opcionais da sessão.

- A configuração do "Tipo de Ficheiro".

- As variáveis do documento no `.kateconfig`.

- As variáveis do documento no próprio documento.

- A configuração efectuada pelo menu ou pela linha de comandos

. Como pode ver, as variáveis do documento só são substituídas pelas alterações feitas durante a execução. Sempre que é gravado um documento, as variáveis do mesmo são lidas de novo e irão substituir as alterações feitas com os itens do menu ou a linha de comandos.

Qualquer variável que não conste em baixo é guardada no documento e poderá ser consultada por outros objectos, como os 'plugins', que as poderão usar para os seus fins. Por exemplo, o modo de indentação variável usa as variáveis do documento para esse fim.

As variáveis aqui apresentadas referem-se ao &kappname; na versão 3.7. Poder-se-ão adicionar mais variáveis no futuro. Existem 3 tipos de valores possíveis para as variáveis, com as seguintes expressões válidas:

- BOOLEANO - on|off|true|false|1|0

- INTEIRO - qualquer número inteiro

- TEXTO - tudo o resto

### Variáveis Disponíveis

    auto-center-linesINTEIRO

- Define o número de linhas de alinhamento automático ao centro.

    auto-insert-doxygenBOOLEANO

- Activa ou desactiva a introdução do asterisco inicial nos comentários do 'doxygen'. Isto não fará efeito a menos que use a indentação automática do C.

    background-colorTEXTO

- Define a cor de fundo do documento. O valor deverá ser algo que possa ser avaliado como uma cor válida, como por exemplo `#ff0000`.

    backspace-indentsBOOLEANO

- Activa ou desactiva a remoção da indentação quando carregar no &Backspace;.

    block-selectionBOOLEANO

- Activa ou desactiva a selecção em bloco.

    bom | byte-order-markerBOOLEANO

- Activa/desactiva o marcador da ordem de 'bytes' ao gravar os ficheiros no formato Unicode (utf8, utf16, utf32).

  Desde: Kate 3.4 (KDE 4.4)

    encodingTEXTO

- Define a codificação usada para carregar ou gravar o ficheiro. Dado que as variáveis no documento serão lidas após o carregamento, isto só terá impacto na gravação. Se o colocar num ficheiro `.kateconfig`, terá o efeito no carregamento também.

  Desde: Kate 3.10 (KDE 4.10)

    bracket-highlight-colorTEXTO

- Define a cor do realce de parêntesis. O valor deverá ser algo que possa ser avaliado como uma cor válida, como por exemplo `#ff0000`.

    current-line-colorTEXTO

- Define a cor da linha actual. O valor deverá ser algo que possa ser avaliado como uma cor válida, como por exemplo `#ff0000`.

    default-dictionaryTEXTO

- Define o dicionário predefinido que é usado na verificação ortográfica.

  Desde: Kate 3.4 (KDE 4.4)

    dynamic-word-wrapBOOLEANO

- Activa ou desactiva a mudança de linha dinâmica.

    eol | end-of-lineTEXTO

- Define o modo do fim-de-linha. Os valores válidos são o `unix`, o `mac` e o `dos`

    folding-markersBOOLEANO

- Activa ou desactiva a visibilidade dos marcadores de dobragem.

    font-sizeINTEIRO

- Define o tamanho de letra do documento em pontos.

    fontTEXTO

- Define o tipo de letra do documento. O valor deverá ser o nome de um tipo de letra válido, por exemplo `courier`.

    hl | syntaxTEXTO

- Define o realce de sintaxe. Os valores válidos são todos os nomes disponíveis nos menus. Por exemplo, para o C++, basta escrever `C++`.

    icon-bar-colorTEXTO

- Define a cor da barra de ícones. O valor deverá ser algo que possa ser avaliado como uma cor válida, como por exemplo `#ff0000`.

    icon-borderBOOLEANO

- Activa ou desactiva a visualização do contorno de ícones.

    indent-modeTEXTO

- Define o modo de indentação automática. As opções `none`, `normal`, `cstyle`, `haskell`, `lilypond`, `lisp`, `python`, `ruby` e `xml` são reconhecidos. Veja mais detalhes em kate-part-autoindent.

    indent-pasted-textBOOLEANO

- Activa/desactiva o ajuste da indentação do texto colado a partir da área de transferência.

  Desde: Kate 3.11 (KDE 4.11)

    indent-widthINTEIRO

- Define a largura da indentação.

    keep-extra-spacesBOOLEANO

- Indica se deve manter os espaços extra ao calcular a largura de indentação.

    line-numbersBOOLEANO

- Activa ou desactiva a visualização dos números de linha.

    mixed-indentBOOLEANO

- Activa ou desactiva a indentação mista, como no Emacs.

  Nota: Descontinuado desde o Kate 3 no KDE4. Esta variável é ignorada; configure sim o `replace-tabs on;` como alternativa de futuro.

    newline-at-eofBOOLEANO

- Adiciona uma linha vazia ao fim do ficheiro (EOF) ao gravar o documento.

  Desde: &kate; 3.9 (KDE 4.9)

    overwrite-modeBOOLEANO

- Activa ou desactiva o modo de sobreposição.

    persistent-selectionBOOLEANO

- Activa ou desactiva a selecção persistente.

    remove-trailing-spaceBOOLEANO

- Activa ou desactiva a limpeza dinâmica dos fins-de-linha.

  Nota: Desactualizado desde a versão KDE 4.10. Por favor, use a opção remove-trailing-spaces com a escolha desejada em alternativa.

    remove-trailing-spacesTEXTO

- Remove os espaços finais ao gravar o documento. As opções válidas são:

  - `none`, `-` ou `0`: nunca remove os espaços finais.

  - `modified`, `mod`, `+` ou `1`: remove os espaços finais apenas nas linhas modificadas. As mesmas são marcadas pelo sistema de modificação das linhas.

  - `all`, `*` ou `2`: remove os espaços finais no documento inteiro.

  Desde: KDE 4.10. Esta opção substitui as opções `remove-trailing-space` e `replace-trailing-space-save`.

    replace-tabs-saveBOOLEANO

- Activa ou desactiva a conversão de tabulações para espaços ao gravar.

    replace-tabsBOOLEANO

- Activa ou desactiva a conversão dinâmica de tabulações para espaços ao gravar.

    replace-trailing-space-saveBOOLEANO

- Activa ou desactiva a limpeza dos fins-de-linha ao gravar.

  Nota: Desactualizado desde a versão KDE 4.10. Por favor, use a opção remove-trailing-spaces com a escolha desejada em alternativa.

    schemeTEXTO

- Define o esquema de cores. O texto deverá ser o nome de um esquema de cores que existe na sua configuração para fazer qualquer efeito.

    selection-colorTEXTO

- Define a cor da selecção. O valor deverá ser algo que possa ser avaliado como uma cor válida, como por exemplo `#ff0000`.

    show-tabsBOOLEANO

- Activa ou desactiva o carácter visual de tabulação.

    smart-homeBOOLEANO

- Activa ou desactiva a navegação do início inteligente.

    space-indentBOOLEANO

- Activa ou desactiva a indentação com espaços.

  Nota: Descontinuado desde o Kate 3 no KDE4. A indentação mista é o comportamento por omissão. Configure o `replace-tabs on;` para obter a indentação apenas com espaços.

    tab-indentsBOOLEANO

- Activa ou desactiva a indentação com a tecla .

    tab-widthINTEIRO

- Define a largura visível dos caracteres de espaços.

    undo-stepsINTEIRO

- Define o número de passos anulados que deverão ser recordados.

  Nota: Descontinuado desde o Kate 3 no KDE4. Esta variável é ignorada. O número máximo de passos de anulação é ilimitado.

    word-wrap-columnINTEIRO

- Define a largura da mudança de linha estática.

    word-wrap-marker-colorTEXTO

- Define a cor do marcador da mudança de linha. O valor deverá ser algo que possa ser avaliado como uma cor válida, como por exemplo `#ff0000`.

    word-wrapBOOLEANO

- Activa ou desactiva a mudança de linha estática.