# 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 usa as opções definidas nas &systemsettings; 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.

Metainformações

- Manter metainformaçõ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 metainformações que não forem utilizadas após

- Indica o número máximo de dias durante os quais serão mantidas as metainformações dos arquivos previamente abertos. Isto mantém o banco de dados de 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 o aplicativo.

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.

Quaisquer 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 plugins.

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

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.

&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 kate-part-autoindent para mais detalhes.

    indent-pasted-textBOOLEANO

- Ativa/desativa o ajuste de recuo do texto colado da área de transferência.

  Desde: &kate; 3.11 (&kde; 4.11)

    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: Obsoleto desde o &kate; 3 no &kde;4. 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: Obsoleto desde o &kate; 3 no &kde;4. 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-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: Obsoleto desde o &kate; 3 no &kde;4. 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.