&Anders.Lund; &Anders.Lund.mail;
José
Pires

    zepires@gmail.com

Tradução

# 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 .

### 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 .

    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;.

    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.