Lisiane
Sztoltz

    lisiane@conectiva.com.br

Tradução

# Configurando o &kate;

## Visão geral

O &kate; oferece vários meios de configurar a aplicação 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 a aplicação &kate;, o componente de edição e o uso de plugins.

O Menu Preferências

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

O Menu Visão

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

O &konsole; integrado está usando a configuração definida no &kcontrolcenter;, e pode ser configurado com o clique direito do mouse , e a escolha do sub-menu Preferências.

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

O diálogo de configuração do &kate; exibe uma árvore de tópicos à esquerda, e uma página de configuração correspondente, para o tópico selecionado à direita. A árvore agrupa as páginas do diálogo dentro de grupos lógicos.

### O grupo do &kate;

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

#### A Página Geral

Opções globais para o &kate;

Modo de Aplicação

  Este grupo deixa você escolher entre o modo MDI e o SDI para o &kate;, selecionando o botão apropriado.

  O MDI (Interface Múltipla de Documentos), que é o modo padrão, usa o &kate; em uma única janela para todos os arquivos abertos. Você pode escolher o documento a ser editado da Lista de Arquivos (acoplado à janela do &kate; na parte esquerda, por padrão) ou selecionando o documento do menu Documento.

  O SDI (Interface Única do Documento) fará com que o &kate; abra cada documento em sua própria janela, e a Lista de Arquivos/Seletor de Arquivos terá uma janela separada.

  Se você mudar esta configuração, será necessário reiniciar o &kate; para que faça efeito.

Na Inicialização

  Estas opções determinam como e se o &kate; restaurará sua sessão quando for lançada depois de um desligamento normal (se restaurada por um gerenciador de sessão, o &kate; sempre tentará restaurar sua sessão de modo mais próximo possível do que era quando você usou pela última vez o &kate;)

  Reabrir Arquivos

    Se esta opção estiver habilitada, arquivos que foram abertos na última vez que você usou o &kate; serão reabertos. Favoritos serão restaurados, e preferências de posição do cursor, borda do ícone e números de linhas, usados no último editor com documentos, serão reestabelecidas.

  Restaurar Configuração de Visão

    Se esta opção estiver habilitada, o &kate; tentará restaurar seus quadros exatamente do modo que foram deixados.

Restringir a uma única instância

  Habilitar isto significa que você pode somente ter uma instância do &kate; sendo executada em um certo momento. Se você tentar iniciar outra, a instância atual tomará posse do ambiente e dos arquivos abertos também. Por exemplo, se você usa o &kate; para abrir fontes de páginas web do Konqueror, elas serão todas abertas em uma instância existente do &kate; (e não será aberta outra), se esta opção estiver habilitada.

Mostrar Conteúdo ao Redimensionar Quadros

  Se esta opção estiver habilitada, as janelas serão totalmente redesenhadas ao arrastar os quadros divisores. Se não estiver marcada, em vez disso será usado a chamada banda elástica (indicando o novo tamanho do quadro).

Sincronizar Konsole com o Documento Ativo

  Isto causará a integração do &konsole; 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 &konsole; sozinho.

Número de Arquivos Recentes

  Isto permite a você decidir a quantidade de tamanho que o menu de arquivos Abrir Recentes deve aumentar.

#### The Doucment List Page

This page allows you to enable or disable the background shading visualization of your recent activity, and chose which colors to use if enabled. See the section about The Document List for more about this feature.

#### External Tools

In the Tools menu you will find a submenu labeled External Tools. These tools invokes external applications with data related to the current document, for example its URL, directory, text or selection. This page allows you to manage the menu and edit, remove or add new tools.

Each external tool is a shell command which contains macros representing the document data. When activated, the macros are substituted with data from the active document.

##### External Tools Properties

Label

  A friendly label for the External Tools menu.

Script

  The script to execute when the tool is activated. Before passing the script to the shell, the following macros are substituted:

  %URL

    The full URL of the current document, or an empty string if the document is unsaved.

  %URLS

    A space seperated list of the URLs of all open documents (except unsaved ones).

  %directory

    The directory part of the current documents URL or an empty string if the current document is unsaved.

  %filename

    the filename of the current document without the path, or an empty string if the current document is unsaved.

  %line

    The line number of the insertion cursor is in the current document.

  %column

    The column number of the insertion cursor in the current document.

  %selection

    The selected text in the current document, or an empty string if no text is selected

  %text

    The full text of the current document. Beware that this will potentially exceed the maximum command length allowed on your system. Use with care.

Executable

  The main executable i the script. This is mandatory, and is used to test if the command can be run at all. A fully qualified path is allowed in case the executable is not in your `PATH` variable.

Mimetypes

  A semicolon separated list of mimetypes for which this command should be enabled. This is currently unused.

Save

  You can optionally select to have the current or all documents saved prior to executing the script. This is handy if your script reads the file from disk.

Command Line Name

  If you fill this, the tool will be available in the editors command line as `exttool-Command Line Name` (the string you enter here prepended exttool-).

### O Grupo do Editor

This group contains all pages related to the editor component of &kate;. Most of the settings here are defaults, they can be overridden by defining a filetype, by Document Variables or by changing them pr. document during an editing session.

#### A Página Cores

Esta página permite modificar o fundo e a seleção das cores de fundo do editor. Inicialmente, o &kate; usará as cores que foram ajustadas na página do &kcontrolcenter; em Aparência Cores

Para modificar a core, pressione o botão associado e selecione a cor desejada do seletor de cores.

Escolher a cor do fundo pode renderizar o texto ilegível devido ao realce da sintaxe. Você deve usar uma cor leve par ao fundo, e uma cor escura para o fundo da seleção.

Caso contrário, você provavelmente precisará modificar os Estilos Padrão.

#### A Página de Fontes

Esta página permite escolher as fontes padrão para o &kate;. As preferências também serão usadas pelo &kwrite; e para a visualização de arquivos texto pelo &konqueror;.

A página apresenta duas abas, sendo uma para a fonte do editor e a outra para a fonte de impressão. Selecione uma aba e escolha a fonte desejada. O padrão é usar a configuração global do &kde; para a fonte fixa.

Como atualmente não é possível usar fontes individuais para os documentos, e nem modificar a fonte para a impressão, tenha cuidado. Uma fonte com largura fixa é fortemente recomendada.

#### A Página de Identação

Esta página permite a você modificar o comportamento da identação.

##### Opções de Identação

Identação Automática

  Se marcada, o &kate; irá automaticamente identar novas linhas de modo igual à linha anterior. Se a linha anterior for em branco, a linha anterior mais próxima e com conteúdo será usada.

Identar com Espaços

  Se marcada, o &kate; identará com espaços ao invés de tabulações.

Tecla backspace identa

  Se isto estiver marcado, o &kate; irá ''desindentar'' quando você pressionar a tecla Backspace, de modo igual à linha acima mais próxima com conteúdo, se a parte da linha precedendo o cursor conter somente espaço em branco.

Tecla Tab identa

  Se isto estiver marcado, o &kate; irá ''desindentar'' quando você pressionar a tecla Tab, de modo igual à linha acima mais próxima com conteúdo, se a parte da linha precedendo o cursor conter somente espaço em branco.

Manter espaços extras

  Com este comportamento configurado, o &kate; deixará espaço em branco atrás do cursor, após a identação.

#### A Página de Seleção

Esta página fornece opções para o ajuste fino do comportamento de seleção do &kate;.

##### Opções de Seleção

Seleções Persistentes

  Quando a opção Seleções Persistentes estiver habilitada, a tecla de entrada não causará a remoção/diminuição da seleção.

  Esta opção parcialmente conflita com a opção Seleção de Sobrescrita. Se ambas estiverem habilitadas, colar texto ou pressionar outras teclas diferentes das teclas de seta farão com que a seleção seja sobrescrita.

Sobrescrever Seleção

  Se isto estiver habilitado, quaisquer inserção de texto, se digitado ou colocado, fará com que o texto selecionado seja apagado e substituído pelo texto inserido.

#### A Página de Edição

Esta página contém opções mistas para o ajuste fino do comportamento do componente do edito do &kate;.

##### Opções do Editor

Quebra de linhas

  A Quebra de Linha, como usada aqui, significa formatar dinamicamente o texto quebrando linhas em um local apropriado, ao invés da quebra leve de linhas no editor, para uma leitura mais fácil.

  Se habilitado, o &kate; irá inserir uma quebra de linha como definido na configuração Fim da Linha, quando a linha estende o comprimento ajustado na opção Quebrar Linhas Emdescrita abaixo.

Quebrar Linhas Em

  Esta opção decide o comprimento máximo de linhas se a opção Quebra de linha estiver habilitada.

Substituir Tabs por Espaços

  Se habilitado, o &kate; substituirá caracteres Tab inseridos por um número único de espaços em branco, como definido na opção Largura da Tabulação.

Remover espaços finais

  Se habilitado, o &kate; removerá quaisquer espaços em branco do final de uma linha, cada vez que o cursor é movido para fora dela.

Largura da Tabulação/Identação

  Ajusta a largura da tabulação, que também é usado para decidir a quantidade da identação quanto a opção Identação Automática estiver habilitada, ou caso contrário, a identação é chamada.

  Dependendo das configurações para Identar , ela pode ser chamada pressionando as teclas Tab eBackspace, e ativando a entrada de menu Editar Identar que fará a identação.

Colchetes Automáticos

  Se isto estiver habilitado, o &kate; irá inserir automaticamente um parêntese direito imediatamente à direita do cursor, quando um parêntese esquerdo for inserido. Os tipos de caracteres suportados são: (, {, [e <

Agrupas comandos Desfazer

  Se habilitado, o &kate; agrupará quaisquer ações similares de edição (como por exemplo digitação, uso do Backspace, colagem) em uma entrada do histórico de Desfazer, assim, elas podem ser desfeitas uma vez.

Mostrar Abas

  Se habilitado, o &kate; desenhará um pequeno ponto no início do caractere Tab no editor, para indicar sua presença.

Home Esperto

  Isto faz com que o &kate; mova o cursor para o primeiro caractere diferente de espaço em branco da linha atual, em vez de ir ao início absoluto, quando a tecla Home (ou outra tecla atribuída para esta função) é pressionada.

Cursor de Quebra

  Se habilitado, mover o cursor para o fim da linha fará com que ele continue para a linha anterior/próxima, se existir.

  Se não estiver habilitada, o cursor não pode ser movido para a direita do início da linha, mas ele pode ser movido para o fim da linha, e quando um texto for inserido, o &kate; automaticamente inserirá um espaço em branco acima daquela posição. Isto algumas vezes é muito útil para programadores, por exemplo.

#### A Página de Teclado

Aqui você pode configurar atalhos de teclado para comandos internos do componente editor do &kate;. Isto inclui comandos para a movimentação no documento e seleção de texto. Para teclas relacionadas a cópia e colagem de texto, veja o Diálogo Configurar Teclas.

Mude aqui as teclas para um comando, ou adicione uma tecla alternativa.

##### Para mudar a(s) tecla(s) para o atalho de um comando, siga este procedimento:

1. Selecione o comando para o qual deseja configurar as teclas.

2. Escolha a opção Nenhuma abaixo da lista se você não deseja um atalho para este comando.

   Escolha a opção Padrão para usar a(s) tecla(s) padrão para o comando

   Escolha a opção Personalizar para selecionar uma tecla personalizada para o comando, ou configure uma que possa ser alternada.

3. Se você escolher a opção Personalizar, o botão de entrada da tecla, à direita da janela, ficará habilitado. Para configurar uma tecla, basta pressioná-la, e então o Diálogo de Definição de Atalho do &kde; aparecerá. Neste diálogo:

4. 1. Escolha se a configuração é padrão ou outra tecla. O Padrão não significa que você modificou a aplicação padrão para esta ação, e ao invés disso, ele ajusta a tecla padrão personalizada para ele.

   2. Pressione a seqüência de teclas desejada, e será visualizada no diálogo, para que você confirme.

      Se você é aventureiro, tente brincar com a opção Multi-tecla . Usá-la permitirá que você tenha as seqüências de teclas como o &Emacs; (uma tecla representa um grupo, e a próxima tecla executa a ação), com exceção do fato que em vez de somente fazer a tarefa, o &kde; abrirá um menu para a escolha de um local indefinido e muito provavelmente inapropriado. A única dúvida agora é se pressionar a próxima tecla na seqüência irá funcionar, ou você terá que digitar uma tecla aceleradora (ambas funcionam).

#### The Filetypes Page

This page allow you to override the default configuration for documents of specified mimetypes. When the editor loads a document, it will try if it matches the file masks or mimetypes for one of the defined filetypes, and if so apply the variables defined. If more filetypes matches, the one with the highest priority will be used. Please see the section Configuring With Document Variables for how to specify variables.

To create a filetype, press the New button and fill in the properties.

To remove an existing filtype, select it from the dropdown list and press the Delete button.

To edit an existing filtype, select it from the dropdown list.

##### Filetype Properties

Name

  This is a friendly name that can be displayed in the Tools Filetypes menu.

Section

  A submenu of Tools Filetypes in which to place this filtype. If the section does not allready exist, it will be created for you.

Variables

  This is where the actual configuration goes. Variables set here will overwrite the default configuration values. Please refer to Configuring With Document Variables for the available variables.

File Extensions

  A semicolon separated list of filename globs used to determine if a document matches this filetype.

Mimetypes

  A semicolon separated list of mime types, used to determine if a document matches this filetype.

Priority

  If a document matches several filetypes, the one with the highest priority will be chosen.

#### A Página de Verificação Ortográfica

Esta página permite a você configurar como se comporta o &kspell; com o &kate;.

#### A Página de Realce de Sintaxe

Esta página permite a você fazer um ajuste fino de cor e seleção do tipo de sintaxe do &kate;.

Para mais informações sobre o sistema de realce de sintaxe, veja ...

A página consiste de duas abas, uma para a configuração dos Estilos Padrão e outra para o gerenciamento dos Modos de Realce

A lista possui quatro ou cinco colunas, cada uma com o seguinte propósito:

Contexto

  Exibe o nome de contexto, pintado usando as propriedades de estilo para o contexto.

Negrito

  O estado da caixa de verificação decide se o contexto deve ser renderizado usando uma fonte em negrito.

Itálico

  O estado desta caixa de verificação decide se o contexto deve ser renderizado utilizando uma fonte itálica.

Normal

  Este botão exibe a cor para o desenho do estilo em modo normal, quando o texto não for selecionado, por exemplo, Para mudar a cor, clique no botão.

Selecionado

  Este botão exibe a cor para o desenho do estilo quando o texto for selecionado. Para modificar a cor, clique no botão.

Usando o Padrão

  Esta caixa de verificação, somente disponível na aba Modos de Realce, mostra se o estilo está usando seus valores padrão. Ela ficará automaticamente desmarcada se você mudar qualquer propriedade do estilo. Marque-a para reiniciar um estilo para que ele use os padrões.

##### A Aba de Estilos Padrão

Para modificar qualquer estilo padrão, ajuste suas propriedades como desejado.

##### A Aba de Modos de Realce

Aqui você pode modificar as propriedades mais importantes de cada modo de destaque disponível. Primeiro, use a opção Destaque para escolher um modo para trabalhar.

Os modos de destaque são inicialmente escolhidos pelo tipo &MIME; e pela extensão do arquivo. Para mudar a lista da seleção atual, edite as entradas Extensões de Arquivo e Tipos Mime . Alternativamente, pressione o botão do assistente, à direita da entrada Tipos Mime. Isto mostrará um diálogo, exibindo todos os tipos &MIME; disponíveis para escolha. Ao usá-lo, serão editados os tipos &MIME;, bem como as extensões do arquivo.

O diálogo de escolha do tipo &MIME; exibe uma árvore de tipos disponíveis, com uma descrição e padrões para o tipo &MIME;. Para um incluir um tipo, marque a caixa ao lado dele.

Você pode modificar as propriedades do estilo de qualquer contexto, como descrito abaixo.

Na base da aba, abaixo das propriedades de destaque, você pode ver um botão chamado Baixar. Ao pressioná-lo, ele tentará se conectar ao site do &kate; e buscar uma lista de modos de realce de sintaxe disponíveis que você pode atualizar ou adicionar.

### O Grupo de Plugins

Este grupo contém páginas relacionadas aos plugins. Com exceção da página de configuração do Gerenciador, alguns plugins fornecem opções individuais de configuração. Para mais informações, veja a documentação dos plugins.

#### A Página do Gerenciador de Plugins

Esta página fornece os plugins de carregamento/descarregamento, e a informação mínima sobre os plugins individuais.

Para carregar um plugin não-carregado, selecione-o na janela Plugins Disponíveis e use as teclas de seta para movê-lo para a janela Plugins Carregados

Para remover um plugin carregado, selecione-o na janela Plugins Carregados e use as teclas de seta para movê-lo para a janela Plugins Disponíveis

Para ver uma pequena descrição e informações sobre um plugin, selecione-o e a informação estará disponível abaixo das listas.

## Configuring With Document Variables

Kate variables is kateparts implementation of document variables, similar to emacs and vi modelines. In katepart, the lines has the format `kate: VARIABLENAME VALUE; [ VARIABLENAME VALUE; ... ]` the lines can of cause be in a comment, if the file is in a format with comments. Variable names are single words (no whitespace), and anything up to the next semicolon is the value. The semicolon is required.

Here is an example variable line, forcing indentation settings for a C++, java or javascript file:

    // kate: space-indent on; indent-width 4; mixedindent off; indent-mode cstyle;

Only the first and last 10 lines are searched for variable lines.

There are variables to support almost all configurations in katepart, and aditionally plugins can use variables, in which case it should be documented in the plugin's documentation.

### How kate uses variables

When reading configuration, katepart looks in the following places (in that order):

- The global configuration.

- Optional session data.

- The "Filetype" configuration.

- Document variables in the document itself.

- Settings made during editing from menu or command line.

As you can understand document variables has the next highest precedence. Whenever a document is saved, the document variables are reread, and will overwrite changes made using menu items or the command line.

Any variable not listed below is stored in the document and can be queried by other objects such as plugins, which can use them for their own purpose. For example the variable indent mode uses document variables for its configuration.

The variables listed here documents &kate; version 2.4. More variables may be added in the future. There are defied 3 types of values for variables, with the following valid expressions:

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

- INTEGER - any integer number

- STRING - anything else

#### Available Variables

    auto-bracketsBOOL

  Set auto insertion of brackets on or off.

    auto-center-linesINT

  Set the number of autocenter lines.

    auto-insert-doxygenBOOL

  Turn insertion of the leading asterisk in doxygen comments on or off. This has no effect unless you use the cstyle auto-indenter.

    background-colorSTRING

  Sets the document background color. The value must be something that can be evaluated to a valid color, for example "#ff0000".

    backspace-indentsBOOL

  Turn backspace indenting on or off.

    block-selectionBOOL

  Turn block selection on or off.

    bracket-highlight-colorSTRING

  Sets the color for the bracket highlight. The value must be something that can be evaluated to a valid color, for example "#ff0000"

    current-line-colorSTRING

  Sets the color for the current line. The value must be something that can be evaluated to a valid color, for example "#ff0000".

    dynamic-word-wrapBOOL

  Turns dynamic word wrap on or off.

    eol | end-of-lineSTRING

  Sets the end of line mode. Valid settings are unix, mac and dos

    encodingSTRING

  Sets the document encoding. The value must be a valid encoding name, like utf-8.

    font-sizeINT

  Sets the point size of the document font.

    fontSTRING

  Sets the font of the document. The value should be a valid font name, for example courier.

    icon-bar-colorSTRING

  Sets the icon bar color. The value must be something that can be evaluated to a valid color, for example `#ff0000`.

    icon-borderBOOL

  Set the display of the icon border on or off.

    folding-markersBOOL

  Set the display of folding markers on or off.

    indent-modeSTRING

  Set the auto-indentation mode. The options none, normal, cstyle, csands, python, xml are recognized. See the section Using Automatic Indenting for details.

    indent-widthINT

  Sets the indentation width.

    keep-extra-spacesBOOL

  Set wheather to keep extra spaces when calculating indentation width.

    keep-indent-profileBOOL

  If enabled, prevents unindenting a block if at least one line has no indentation.

    line-numbersBOOL

  Set the display of line numbers on or off.

    mixed-indentBOOL

  Sets mixed indentation ala Emacs on or off.

    overwrite-modeBOOL

  Set overwrite mode on or off.

    persistent-selectionBOOL

  Set persistent selection on or off.

    remove-trailing-spaceBOOL

  Set dynamic end of line cleanup on or off.

    replace-tabs-saveBOOL

  Set tab->space conversion on save on or off.

    replace-tabsBOOL

  Set dynamic tab->space conversion on or off.

    replace-trailing-space-saveBOOL

  Set end of line cleanup on save on or off.

    schemeSTRING

  Set the color scheme. The string must be the name of a color scheme that exists in your configuration to have any effect.

    selection-colorSTRING

  Set the selection color. The value must be something that can be evaluated to a valid color, for example "#ff0000".

    show-tabsBOOL

  Set the visual TAB character on or off.

    smart-homeBOOL

  Set smart home navigation on or off.

    space-indentBOOL

  Set indentation with spaces on or off.

    tab-indentsBOOL

  Set the TAB key indentation on or off.

    tab-widthINT

  Sets the tab display width.

    undo-stepsINT

  Sets the number of undo steps to remember.

    word-wrap-columnINT

  Set the hard word wrap width.

    word-wrap-marker-colorSTRING

  Sets the work wrap marker color. The value must be something that can be evaluated to a valid color, for example "#ff0000".

    word-wrapBOOL

  Set hard word wrapping on or off.

    wrap-cursorBOOL

  Set cursor wrapping on or off.