&Anders.Lund; &Anders.Lund.mail;
Lisiane
Sztoltz

    lisiane@conectiva.com.br

Tradução

# Configurando o &kate;

## Visão geral

O &kate; oferece vários meios de configurar o aplicativo para comportar-se como desejado. Os mais importantes são:

O diálogo de configuração

  A principal ferramenta de configuração, permitindo a você configurar o aplicativo &kate;, o componente de edição e o uso de plugins.

O Menu Preferências

  Permite a você modificar preferências usadas com frequência, e lançar os diálogos de configuração.

Menu Exibir

  Permite a você dividir o quadro atual, bem como exibir ícones e números de linha para o documento atualmente editado.

O terminal integrado está usando a configuração definida nas configurações do sistema, e pode ser configurado usando o clique direito do mouse para acessar o menu de contexto.

## O Diálogo de Configuração Principal

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 selecionado à direita.

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

- Configuração do aplicativo

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

## A configuração do aplicativo &kate;

Este grupo contém páginas para se configurar o aplicativo principal do &kate;

### Geral

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

Comportamento
  Avisar sobre arquivos modificados por outros processos

    Quando esta opção estiver ativa, o &kate; irá notificá-lo dos arquivos modificados fora do aplicativo, sempre que a janela principal for colocada em primeiro plano. Você será então capaz de lidar com vários arquivos modificados de uma vez, os quais poderá recarregar, salvar ou descartar os arquivos alterados nos grupos.

    Se não estiver ativada, o &kate; irá perguntar-lhe a ação a tomar, quando um arquivo modificado externamente ficar em primeiro plano, dentro do aplicativo.

Meta informações
  Manter meta informações de sessões passadas

    Quando estiver ativa, o &kate; irá guardar alguns metadados, 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 meta-informações que não forem utilizadas após

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

### Sessões

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

Elementos das Sessões
  Incluir configurações da janela

    Se estiver ativada esta opção, o &kate; irá salvar as configurações da janela com cada sessão.

Comportamento ao Iniciar o Aplicativo

  Selecione a forma como deseja que o &kate; se comporte na inicialização. Esta opção poderá ser substituída se especificar o que fazer na linha de comando.

  Iniciar uma nova sessão

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

  Carregar a última sessão usada

    O &kate; irá usar a sessão mais recente na inicialização. Isto é bom se quiser usar a mesma sessão sempre ou raramente deseje mudar.

  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 padrão se nenhum tiver sido salva. Este é o comportamento padrão. Isso é bom se usar diversas sessões diferentes com frequência.

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

### Plugins

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

Se um plugin tiver opções de configuração, irá aparecer uma seção para acessá-las, como filha desta página.

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

### Documentos

Sombra do Fundo

  Esta página permite-lhe ativar ou desativar a visualização sombreada do fundo da sua atividade recente e escolher as cores a usar, se estiver ativada. Veja a seçã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.

Mostrar localização completa

  Quando ativado, no modo em árvore, as pastas de nível de topo serão mostradas com sua localização completa ao invés de apenas o último nome de pasta.

Modo de Exibição

  Isto fornece duas opções que afetam a apresentação da exibição dos Documentos. A Exibição em árvore irá mostrar os documentos em uma árvore por baixo das pasta onde estiverem, enquanto a opção para Exibição em lista irá mostrar uma lista simples de documentos.

Mostrar localização completa

  Quando a Exibição em árvore e esta opção estiverem ativas, os itens da pasta mostrada na exibição de Documentos irá mostrar o caminho completo do sistema de arquivos até a pasta e também o nome desta. Ele não tem efeito na Exibição em lista.

### Terminal

Esta página somente é exibida pelo plugin da ferramenta de exibição do terminal, que está ativa por padrão.

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

  Isto causará a integração do terminal ao comando `cd` dentro da pasta do documento ativo quando lançado, e quando um novo documento obter o foco. Se não estiver habilitado, você terá que fazer toda a sua navegação pelo terminal sozinho.

Definir a variável de ambiente EDITOR como sendo 'kate -b'

  Isto define a variável de ambiente `EDITOR` de modo que programas executados no terminal embutido que abrem automaticamente um arquivo em um editor abrirão estes arquivos no &kate; ao invés do editor configurado em seu shell. Você não será capaz de continuar usando o terminal até que você feche o arquivo no &kate;, de modo que o programa que realizou a requisição saiba que você terminou a edição do arquivo.

&configuring-part-sections;

## Configurando com as 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 à que acontece no Emacs e no VI. Na 'katepart', as linhas têm o seguinte formato: `kate: NOMEVARIÁVEL VALOR; [ NOMEVARIÁVEL VALOR; ... ]`. As linhas poderão estar, claro, num comentário, se o arquivo estiver num formato que suporte comentários. Os nomes das variáveis são palavras únicas (sem espaços) e tudo o que estiver até o próximo ponto e vírgula é o valor. Esse ponto e vírgula é obrigatório.

Aqui está uma linha de variável de exemplo, obrigando a configuração do recuo para um arquivo em C++, Java ou JavaScript:

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

Só as primeiras e últimas 10 linhas serão pesquisadas pelas linhas de variáveis.

Além disso, as variáveis do documento podem ser colocadas em um arquivo chamado `.kateconfig` em qualquer diretório, e as opções configuradas serão aplicadas se as modelines forem inseridas em qualquer arquivo no diretório e subdiretórios, com a profundidade definida na profundidade de pesquisa. As variáveis de documento no `.kateconfig` usam a mesma sintaxe das modelines.

Existem variáveis para suportar quase todas as configurações no 'katepart', e os plugins adicionais podem usar as variáveis; nesse caso, isto deverá estar indicado na documentação do plugin.

### Como o &kappname; usa Variáveis

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

- A configuração global.

- Os dados opcionais da sessão.

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

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

- As variáveis do próprio documento.

- As configurações feitas durante a edição do menu ou da linha de comando.

Como pode ver, as variáveis do documento somente podem ser sobrepostas por alterações feitas no momento da execução. Sempre que um documento for salvo, as variáveis do documento são lidas novamente e irão sobrepor as alterações feitas, usando os itens do menu ou nas linhas de comando.

Todas as variáveis que não estejam indicadas abaixo são guardadas no documento e poderão ser pesquisadas por outros objetos, como os plugins, usando-as para os seus próprios fins. Por exemplo, o modo de recuo variável usa as variáveis do documento para a sua própria configuração.

As variáveis aqui listadas dizem respeito ao &kappname; versão 3.7. Poderão ser adicionadas mais variáveis no futuro. Existem 3 tipos de valores definidos para as variáveis, com as seguintes expressões válidas:

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

- INTEIRO - qualquer número inteiro

- TEXTO - todo o resto

### Variáveis Disponíveis

    auto-center-linesINT

  Define o número de linhas centradas automaticamente.

    auto-insert-doxygenBOOL

  Ativa ou desativa a inserção do asterisco inicial nos comentários do 'doxygen'. Isto não tem efeito, a menos que você use o sistema de recuo no estilo 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

  Ativa ou desativa a remoção do recuo quando o &Backspace; é pressionado.

    block-selectionBOOL

  Ativa ou desativa a seleção em bloco.

    bom | byte-order-markerBOOLEANO

  Ativar/desativar o marcador da ordem dos 'bytes' ao salvar os arquivos no formato Unicode (utf8, utf16, utf32).

  Desde: Kate 3.4 (KDE 4.4)

    encodingTEXTO

  Define a codificação usada para carregar ou salvar o arquivo. Como as variáveis do documento serão lidas após o carregamento, isto só terá impacto na gravação. Se o colocar em um arquivo `.kateconfig`, também afetará o carregamento.

  Desde: Kate 3.10 (KDE 4.10)

    bracket-highlight-colorTEXTO

  Define a cor de realce dos parênteses. 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 atual. O valor deverá ser algo que possa ser avaliado como uma cor válida, como por exemplo `#ff0000`.

    default-dictionaryTEXTO

  Configurar o dicionário padrão usado na verificação ortográfica.

  Desde: Kate 3.4 (KDE 4.4)

    dynamic-word-wrapBOOL

  Ativa ou desativa a quebra de linha dinâmica.

    eol | end-of-lineTEXTO

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

    folding-markersBOOL

  Ativa ou desativa a visualização dos marcadores de expansão/contração do código.

    font-sizeINT

  Define o tamanho da fonte do documento.

    fontTEXTO

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

    hl | syntaxTEXTO

  Define o realce de sintaxe. Os textos usados são todos os nomes disponíveis nos menus. Por exemplo, para o C++, basta digitar `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-borderBOOL

  Ativa ou desativa a visibilidade da borda dos ícones.

    indent-modeTEXTO

  Define o modo de recuo automático. As opções `none`, `normal`, `cstyle`, `haskell`, `lilypond`, `lisp`, `python`, `ruby` e `xml` são reconhecidas. Veja a seção para mais detalhes.

    indent-widthINTEIRO

  Define a largura do recuo.

    keep-extra-spacesBOOL

  Define se deseja manter os espaços extras ao calcular a largura do recuo.

    line-numbersBOOL

  Ativa ou desativa a visibilidade dos números de linha.

    mixed-indentBOOLEANO

  Ativa ou desativa o recuo misto no estilo Emacs.

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

    newline-at-eofBOOLEANO

  Adiciona uma linha vazia no final do arquivo (EOF) ao salvar o documento.

  Desde: &kate; 3.9 (KDE 4.9)

    overwrite-modeBOOL

  Ativa ou desativa o modo de sobreposição.

    persistent-selectionBOOL

  Ativa ou desativa as seleções persistentes.

    remove-trailing-spaceBOOL

  Ativa ou desativa a limpeza dinâmica dos fins-de-linha.

  Nota: Obsoleto desde a versão KDE 4.10. Em vez disso, use a opção remove-trailing-spaces com a escolha desejada.

    remove-trailing-spacesTEXTO

  Remove os espaços finais ao salvar 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. Estas linhas são marcadas pelo sistema de modificação de 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-saveBOOL

  Ativa ou desativa a conversão de tabulações para espaços no salvamento.

    replace-tabsBOOL

  Ativa ou desativa a conversão dinâmica de tabulações para espaços no salvamento.

    replace-trailing-space-saveBOOL

  Ativa ou desativa a limpeza dos fins-de-linha no salvamento.

  Nota: Obsoleto desde a versão KDE 4.10. Em vez disso, use a opção remove-trailing-spaces com a escolha desejada.

    schemeTEXTO

  Define o esquema de cores. O texto deverá ser o nome de um esquema de cores que exista na sua configuração, para que faça qualquer efeito.

    selection-colorTEXTO

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

    show-tabsBOOL

  Ativa ou desativa o caractere de tabulação visível.

    smart-homeBOOL

  Ativa ou desativa a navegação inteligente do Home.

    space-indentBOOLEANO

  Ativa ou desativa o recuo com espaços.

  Nota: Desatualizado desde o Kate 3 no KDE4. O recuo misto é o comportamento padrão. Use o `replace-tabs on;` para obter um recuo apenas com espaços.

    tab-indentsBOOLEANO

  Ativa ou desativa o recuo com &Tab;.

    tab-widthINT

  Define a largura de exibição do caractere de tabulação.

    undo-stepsINT

  Define o número de passos a recordar no Desfazer/Refazer.

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

    word-wrap-columnINT

  Define a largura da quebra de linha estática.

    word-wrap-marker-colorTEXTO

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

    word-wrapBOOL

  Ativa ou desativa a quebra de linha estática.