<chapter id="configuring-kate">
<chapterinfo>
<authorgroup>
<author
><personname
><firstname
></firstname
></personname
></author>
<othercredit role="translator"
><firstname
>Lisiane</firstname
><surname
>Sztoltz</surname
><affiliation
><address
><email
>lisiane@conectiva.com.br</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
> 
</authorgroup>
</chapterinfo>
<title
>Configurando o &kate;</title>

<sect1 id="configuring-overview">
<title
>Visão geral</title>
<para>
<indexterm>
<primary
>configurar</primary>
<secondary
>configurações</secondary>
<tertiary
>preferências</tertiary
></indexterm>
<anchor id="find"/> <anchor id="find-again"/> <anchor id="replace"/> <anchor id="undo"/> <anchor id="redo"/> O &kate; oferece vários meios de configurar a aplicação para comportar-se como  desejado. Os mais importantes são:  </para>

<variablelist>
<varlistentry>
<term id="configure"
>O Diálogo de Configuração</term>
<listitem
><para
>A principal ferramenta de configuração, permitindo a você configurar a aplicação &kate;, o componente de edição e o uso de plugins.</para
></listitem>
</varlistentry>
<varlistentry>
<term id="settings"
>O Menu <guimenu
>Preferências</guimenu
></term>
<listitem
><para
>Permite a você modificar preferências usadas com freqüência, e lançar os diálogos de configuração.</para
></listitem>
</varlistentry>
<varlistentry>
<term
>O Menu <guimenu
>Visão</guimenu
></term>
<listitem
><para
>Permite a você dividir o quadro atual, bem como exibir ícones e números de linha para o documento atualmente editado.</para
></listitem>
</varlistentry>
</variablelist>

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

</sect1>

<sect1 id="configuring-kate-configdialog">
<title
>O Diálogo de Configuração Principal</title>

<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="configdialog01.png"/>
</imageobject>
</mediaobject>

<para
>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.</para>

<sect2 id="config-dialog">
<title
>O grupo do &kate;</title>
<para
>Este grupo contém páginas para se configurar a aplicação principal do &kate;</para>

<sect3 id="config-dialog-general">
<title
>A Página Geral</title>
<para
>Opções globais para o &kate;</para>

<variablelist>
<varlistentry>
<term
>Modo de Aplicação</term>
<listitem>
<para
><indexterm
><primary
>MDI</primary
><secondary
>SDI</secondary
></indexterm>
Este grupo deixa você escolher entre o modo <acronym
>MDI</acronym
> e o <acronym
>SDI</acronym
> para o &kate;, selecionando o botão apropriado.</para>
 <para
>O <acronym
>MDI</acronym
> (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  <guimenu
>Documento</guimenu
>.</para>
<para
>O <acronym
>SDI</acronym
> (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.</para>
 <para
>Se você mudar esta configuração, será necessário reiniciar o &kate; para que faça efeito.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Na Inicialização</term>
<listitem
><para
>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;)</para>

<variablelist>
<varlistentry>
<term>
<anchor id="config-dialog-general-reopen-files"/>
<guibutton
>Reabrir Arquivos</guibutton
></term>
<listitem
><para
>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. </para
></listitem>
</varlistentry>
<varlistentry>
<term
><guibutton
>Restaurar Configuração de Visão</guibutton
></term>
<listitem
><para
>Se esta opção estiver habilitada, o &kate; tentará restaurar seus quadros exatamente do modo que foram deixados.</para
></listitem>
</varlistentry>
</variablelist>

</listitem>

</varlistentry>

<varlistentry>
<term
><guibutton
>Restringir a uma única instância</guibutton
></term>
<listitem
><para
>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.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Mostrar Conteúdo ao Redimensionar Quadros</guibutton
></term
> <listitem
><para
>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 <quote
>banda elástica</quote
> (indicando o novo tamanho do quadro).</para
></listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-general-sync-konsole"/>
<guibutton
>Sincronizar Konsole com o Documento Ativo</guibutton
></term>
<listitem
><para
>Isto causará a integração do &konsole; ao comando <command
>cd</command
> 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. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Número de Arquivos Recentes</guibutton
></term>
<listitem
><para
>Isto permite a você decidir a quantidade de tamanho que o menu de arquivos <guimenu
>Abrir Recentes</guimenu
> deve aumentar.</para
></listitem>
</varlistentry>

</variablelist>
</sect3>

<sect3 id="config-dialog-documentlist">
<title
>The Doucment List Page</title>
<para
>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 <link linkend="kate-mdi-tools-file-list"
>The Document List</link
> for more about this feature.</para>
</sect3>

<sect3 id="config-dialog-externaltools">
<title
>External Tools</title>

<para
>In the <guimenu
>Tools</guimenu
> menu you will find a submenu labeled <guisubmenu
>External Tools</guisubmenu
>. 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.</para>

<para
>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.</para>

<variablelist>
<title
>External Tools Properties</title>
<varlistentry>
<term
>Label</term>
<listitem
><para
>A friendly label for the External Tools menu.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Script</term>
<listitem
><para
>The script to execute when the tool is activated. Before passing the script to the shell, the following macros are substituted: <variablelist>
<varlistentry>
<term
>%URL</term>
<listitem
><para
>The full URL of the current document, or an empty string if the document is unsaved.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>%URLS</term>
<listitem
><para
>A space seperated list of the URLs of all open documents (except unsaved ones).</para
></listitem>
</varlistentry>

<varlistentry>
<term
>%directory</term>
<listitem
><para
>The directory part of the current documents URL or an empty string if the current document is unsaved.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>%filename</term>
<listitem
><para
>the filename of the current document without the path, or an empty string if the current document is unsaved.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>%line</term>
<listitem
><para
>The line number of the insertion cursor is in the current document.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>%column</term>
<listitem
><para
>The column number of the insertion cursor in the current document.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>%selection</term>
<listitem
><para
>The selected text in the current document, or an empty string if no text is selected</para
></listitem>
</varlistentry>

<varlistentry>
<term
>%text</term>
<listitem
><para
>The full text of the current document. Beware that this will potentially exceed the maximum command length allowed on your system. Use with care.</para
></listitem>
</varlistentry>

</variablelist>

</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Executable</term>
<listitem
><para
>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 <envar
>PATH</envar
> variable.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Mimetypes</term>
<listitem
><para
>A semicolon separated list of mimetypes for which this command should be enabled. This is currently unused.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Save</term>
<listitem
><para
>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.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Command Line Name</term>
<listitem
><para
>If you fill this, the tool will be available in the <link linkend="advanced-editing-tools-commandline"
>editors command line</link
> as <command
>exttool-<replaceable
>Command Line Name</replaceable
></command
> (the string you enter here prepended <quote
>exttool-</quote
>).</para
></listitem>
</varlistentry>

</variablelist>

</sect3>

</sect2>

<sect2 id="config-dialog-editor">
<title
>O Grupo do Editor</title>
<para
>This group contains all pages related to the editor component of &kate;. Most of the settings here are defaults, they can be overridden by <link linkend="config-dialog-editor-filetypes"
>defining a filetype</link
>, by <link linkend="config-variables"
>Document Variables</link
> or by changing them pr. document during an editing session.</para>

<sect3 id="config-dialog-editor-colors">
<title
>A Página  <guilabel
>Cores</guilabel
></title
> <para
>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 <menuchoice
><guimenu
>Aparência</guimenu
> <guimenuitem
>Cores</guimenuitem
> </menuchoice
></para>

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

<note
><para
>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. </para>
<para
>Caso contrário, você provavelmente precisará modificar os <link linkend="config-dialog-editor-highlight-default-styles"
>Estilos Padrão</link
>.</para>
</note>
</sect3>

<sect3 id="config-dialog-editor-fonts">
<title
>A Página de Fontes</title
> <!-- FIXME LINKS //-->

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

<para
>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.</para>

<tip
><para
>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. </para
></tip>
</sect3>

<sect3 id="config-dialog-editor-indent">
<title
>A Página de Identação</title>
<para
>Esta página permite a você modificar o comportamento da identação.</para>

<variablelist>
<title
>Opções de Identação</title>

<varlistentry>
<term>
<anchor id="config-dialog-editor-indent-auto-indent"/>
<guibutton
>Identação Automática</guibutton>
</term>
<listitem>
<para
>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.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-indent-indent-with-spaces"/>
<guibutton
>Identar com Espaços</guibutton>
</term>
<listitem>
<para
>Se marcada, o &kate; identará com espaços ao invés de tabulações.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-indent-backspace-key-indents"/>
<guibutton
>Tecla backspace identa </guibutton>
</term>
<listitem>
<para
>Se isto estiver marcado, o &kate; irá ''desindentar'' quando você pressionar a tecla <keycap
>Backspace</keycap
>, 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.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-indent-tab-key-indents"/>
<guibutton
>Tecla Tab identa </guibutton>
</term>
<listitem>
<para
>Se isto estiver marcado, o &kate; irá ''desindentar'' quando você pressionar a tecla <keycap
>Tab</keycap
>, 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.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-indent-keep-extra-spaces"/>
<guibutton
>Manter espaços extras</guibutton>
</term>
<listitem>
<para
>Com este comportamento configurado, o &kate; deixará espaço em branco atrás do cursor, após a identação.</para>
</listitem>
</varlistentry>

</variablelist>

</sect3>

<sect3 id="config-dialog-editor-select">
<title
>A Página de Seleção</title>

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

<variablelist>
<title
>Opções de Seleção</title>

<varlistentry>
<term>
<anchor id="config-dialog-editor-select-persistent-selections"/>
<guibutton
>Seleções Persistentes </guibutton>
</term>
<listitem>
<para
>Quando a opção Seleções Persistentes estiver habilitada, a tecla de entrada não causará a remoção/diminuição da seleção.</para>
<note
><para
>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.</para
></note>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-select-overwrite-selections"/>
<guibutton
>Sobrescrever Seleção</guibutton>
</term>
<listitem>
<para
>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.</para>
</listitem>
</varlistentry>

</variablelist>

</sect3>

<sect3 id="config-dialog-editor-edit">
<title
>A Página de Edição</title>
<para
>Esta página contém opções mistas para o ajuste fino do comportamento do componente do edito do &kate;.</para>

<variablelist>
<title
>Opções do Editor</title>

<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-word-wrap"/>
<guibutton
>Quebra de linhas</guibutton>
</term>
<listitem>
<para
>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.</para>
<para
>Se habilitado, o &kate; irá inserir uma quebra de linha como definido na configuração <link linkend="document-end-of-line"
>Fim da Linha</link
>, quando a linha estende o comprimento ajustado na opção <link linkend= "config-dialog-editor-edit-wrap-words-at"
>Quebrar Linhas Em</link
>descrita abaixo.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-wrap-words-at"/>
<guibutton
>Quebrar Linhas Em</guibutton>
</term>
<listitem>
<para
>Esta opção decide o comprimento máximo de linhas se a opção <link linkend="config-dialog-editor-edit-word-wrap"
>Quebra de linha</link
> estiver habilitada.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-replace-tabs-with-spaces"/>
<guibutton
>Substituir Tabs por Espaços</guibutton>
</term>
<listitem>
<para
>Se habilitado, o &kate; substituirá caracteres  <keycap
>Tab</keycap
> inseridos por um número único de espaços em branco, como definido na opção  <link linkend="config-dialog-editor-edit-tab-indent-width"
>Largura da Tabulação</link
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-remove-trailing-spaces"/>
<guibutton
>Remover espaços finais</guibutton>
</term>
<listitem>
<para
>Se habilitado, o &kate; removerá quaisquer espaços em branco do final de uma linha, cada vez que o cursor é movido para fora dela.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-tab-indent-width"/>
<guibutton
>Largura da Tabulação/Identação</guibutton>
</term>
<listitem>
<para
>Ajusta a largura da tabulação, que também é usado para decidir a quantidade da identação quanto a opção <link linkend="config-dialog-editor-indent-auto-indent"
> Identação Automática</link
> estiver habilitada, ou caso contrário, a identação é chamada.</para>
<para
>Dependendo das configurações para <link linkend="config-dialog-editor-indent"
>Identar </link
>, ela pode ser chamada pressionando as teclas <keycap
>Tab</keycap
> e<keycap
>Backspace</keycap
>, e ativando a entrada de menu  <link linkend="edit-indent"
><guimenu
>Editar</guimenu
> <guimenuitem
> Identar</guimenuitem
></link
> que fará a identação.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-auto-brackets"/>
<guibutton
>Colchetes Automáticos</guibutton>
</term>
<listitem>
<para
>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: <keycap
>(</keycap
>, <keycap
>{</keycap
>, <keycap
>[</keycap
>e <keycap
>&lt;</keycap
></para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-group-undos"/>
<guibutton
>Agrupas comandos Desfazer</guibutton>
</term>
<listitem>
<para
>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.</para>
</listitem>
</varlistentry>


<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-show-tabs"/>
<guibutton
>Mostrar Abas</guibutton>
</term>
<listitem>
<para
>Se habilitado, o &kate; desenhará um pequeno ponto no início do caractere <keycap
>Tab</keycap
> no editor, para indicar sua presença.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-smart-home"/>
<guibutton
>Home Esperto</guibutton>
</term>
<listitem>
<para
>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 <keycap
>Home</keycap
> (ou outra tecla atribuída para esta função) é pressionada.</para>
</listitem>
</varlistentry>

<!-- NOTE This option has gone (anders)
<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-page-up-down-moves-cursor"/>
<guibutton
>Page Up/Down moves cursor</guibutton>
</term>
<listitem>
<para
>If enabled, the cursor will be moved to the first/last visible
line when <keycap
>Page Up</keycap
>/<keycap
>Page Down</keycap
> (or
other key assigned to those functions) is pressed, rather than being
kept at its relative position.</para>
</listitem>
</varlistentry>
-->
<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-wrap-cursor"/>
<guibutton
>Cursor de Quebra</guibutton>
</term>
<listitem>
<para
>Se habilitado, mover o cursor para o fim da linha fará com que ele continue para a linha anterior/próxima, se existir.</para>
<para
>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.</para>
</listitem>
</varlistentry>

</variablelist>

</sect3>

<sect3 id="config-dialog-editor-keyboard">
<title
>A Página de Teclado</title>

<para
>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. </para>

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

<procedure>
<title
>Para mudar a(s) tecla(s) para o atalho de um comando, siga este procedimento:</title>
<step>
<para
>Selecione o comando para o qual deseja configurar as teclas.</para>
</step>
<step>
<para
>Escolha a opção <guibutton
>Nenhuma</guibutton
> abaixo da lista se você não deseja um atalho para este comando.</para>
<para
>Escolha a opção <guibutton
>Padrão</guibutton
> para usar a(s) tecla(s) padrão para o comando</para>
<para
>Escolha a opção <guibutton
>Personalizar</guibutton
> para selecionar uma tecla personalizada para o comando, ou configure uma que possa ser alternada.</para>
</step>
<step>
<para
>Se você escolher a opção <guibutton
>Personalizar</guibutton
>, 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:</para>
</step>
<step>
<procedure>
<step>
<para
>Escolha se a configuração é padrão ou outra tecla. O <guilabel
> Padrão</guilabel
> 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.</para>
</step>
<step>
<para
>Pressione a seqüência de teclas desejada, e será visualizada no diálogo, para que você confirme. </para>

<para
>Se você é aventureiro, tente brincar com a opção <guibutton
>Multi-tecla </guibutton
>.  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).</para>
</step>
</procedure>
</step>
</procedure>
</sect3>

<sect3 id="config-dialog-editor-filetypes">
<title
>The Filetypes Page</title>

<para
>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 <link linkend="config-variables"
>Configuring With Document Variables</link
> for how to specify variables.</para>

<para
>To create a filetype, press the <guibutton
>New</guibutton
> button and fill in the properties.</para>

<para
>To remove an existing filtype, select it from the dropdown list and press the <guibutton
>Delete</guibutton
> button.</para>

<para
>To edit an existing filtype, select it from the dropdown list.</para>

<variablelist>

<title
>Filetype Properties</title>

<varlistentry>
<term
>Name</term>
<listitem
><para
>This is a friendly name that can be displayed in the <menuchoice
><guisubmenu
>Tools</guisubmenu
><guisubmenu
>Filetypes</guisubmenu
></menuchoice
> menu.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Section</term>
<listitem
><para
>A submenu of <menuchoice
><guisubmenu
>Tools</guisubmenu
><guisubmenu
>Filetypes</guisubmenu
></menuchoice
> in which to place this filtype. If the section does not allready exist, it will be created for you.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Variables</term>
<listitem
><para
>This is where the actual configuration goes. Variables set here will overwrite the default configuration values. Please refer to <link linkend="config-variables"
>Configuring With Document Variables</link
> for the available variables.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>File Extensions</term>
<listitem
><para
>A semicolon separated list of filename globs used to determine if a document matches this filetype.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Mimetypes</term>
<listitem
><para
>A semicolon separated list of mime types, used to determine if a document matches this filetype.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Priority</term>
<listitem
><para
>If a document matches several filetypes, the one with the highest priority will be chosen.</para
></listitem>
</varlistentry>

</variablelist>

</sect3>

<sect3 id="config-dialog-editor-spelling">
<title
>A Página de Verificação Ortográfica</title>
<para
>Esta página permite a você configurar como se comporta o &kspell; com o &kate;. </para>
</sect3>

<sect3 id="config-dialog-editor-hl">
<title
>A Página de Realce de Sintaxe</title>

<para
>Esta página permite a você fazer um ajuste fino de cor e seleção do tipo de sintaxe do &kate;.</para>
<para>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="configdialog02.png"/></imageobject>
</mediaobject>
</para>
<para
>Para mais informações sobre o sistema de realce de sintaxe, veja ...</para>

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

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

<variablelist>

<varlistentry>
<term
>Contexto</term>
<listitem
><para
>Exibe o nome de contexto, pintado usando as propriedades de estilo para o contexto.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Negrito</term>
<listitem
><para
>O estado da caixa de verificação decide se o contexto deve ser renderizado usando uma fonte em negrito.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Itálico</term>
<listitem
><para
>O estado desta caixa de verificação decide se o contexto deve ser renderizado utilizando uma fonte itálica.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Normal</term>
<listitem
><para
>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.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Selecionado</term>
<listitem
><para
>Este botão exibe a cor para o desenho do estilo quando o texto for selecionado. Para modificar a cor, clique no botão.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Usando o Padrão</term>
<listitem
><para
>Esta caixa de verificação, somente disponível na aba <guibutton
>Modos de Realce</guibutton
>, 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.</para
></listitem>
</varlistentry>

</variablelist>

<sect4 id="config-dialog-editor-highlight-default-styles">
<title
>A Aba de Estilos Padrão</title>
<para
>Para modificar qualquer estilo padrão, ajuste suas propriedades como desejado.</para>
</sect4>

<sect4 id="config-dialog-editor-highlight-highlight-modes">
<title
>A Aba de Modos de Realce</title>

<para
><indexterm
><primary
>realce de sintaxe, configurando</primary
></indexterm
> Aqui você pode modificar as propriedades mais importantes de cada modo de destaque disponível. Primeiro, use a opção <guibutton
>Destaque </guibutton
> para escolher um modo para trabalhar.</para
> <para
>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 <guibutton
>Extensões de Arquivo</guibutton
> e <guibutton
>Tipos Mime </guibutton
>. Alternativamente, pressione o botão do assistente, à direita da entrada <guibutton
>Tipos Mime</guibutton
>. 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.</para>

<mediaobject>
<imageobject
><imagedata format="PNG" fileref="mimetypechooser.png"/></imageobject>
</mediaobject>
<para
>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. </para>

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

<para
>Na base da aba, abaixo das propriedades de destaque, você pode ver um botão chamado <guibutton
>Baixar</guibutton
>.  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.</para>

</sect4>

</sect3>

</sect2>

<sect2 id="config-dialog-plugins">
<title
>O Grupo de Plugins</title>

<para
><indexterm
><primary
>plugins, configurando</primary
></indexterm
> 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.</para>

<sect3 id="config-dialog-plugins-manager">
<title
>A Página do Gerenciador de Plugins</title>

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

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

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

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

</sect2>

</sect1>

<sect1 id="config-variables">

<title
>Configuring With Document Variables</title>

<para
>Kate variables is kateparts implementation of document variables, similar to emacs and vi modelines. In katepart, the lines has the format <userinput
>kate: VARIABLENAME VALUE; [ VARIABLENAME VALUE; ... ]</userinput
> 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.</para>

<para
>Here is an example variable line, forcing indentation settings for a C++, java or javascript file: <programlisting
>// kate: space-indent on; indent-width 4; mixedindent off; indent-mode cstyle;</programlisting>
</para>

<note
><para
>Only the first and last 10 lines are searched for variable lines.</para
></note>

<para
>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.</para>

<sect2 id="config-variables-howto">
<title
>How kate uses variables</title>

<para
>When reading configuration, katepart looks in the following places (in that order): <itemizedlist
> <listitem
><para
>The global configuration.</para
></listitem
> <listitem
><para
>Optional session data.</para
></listitem
> <listitem
><para
>The "Filetype" configuration.</para
></listitem
> <listitem
><para
>Document variables in the document itself.</para
></listitem
> <listitem
><para
>Settings made during editing from menu or command line.</para
></listitem
> </itemizedlist
> 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.</para>

<para
>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.</para>

<para
>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: <itemizedlist>
<listitem
><para
>BOOL - on|off|true|false|1|0</para
></listitem>
<listitem
><para
>INTEGER - any integer number</para
></listitem>
<listitem
><para
>STRING - anything else</para
></listitem>
</itemizedlist>
</para>

<variablelist>
<title
>Available Variables</title>

<varlistentry>
<term
><cmdsynopsis
><command
>auto-brackets</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Set auto insertion of brackets on or off.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>auto-center-lines</command
><arg
>INT</arg
></cmdsynopsis
></term>
<listitem
><para
>Set the number of autocenter lines.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>auto-insert-doxygen</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Turn insertion of the leading asterisk in doxygen comments on or off. This has no effect unless you use the cstyle auto-indenter. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>background-color</command
><arg
>STRING</arg
></cmdsynopsis
></term>
<listitem
><para
>Sets the document background color. The value must be something that can be evaluated to a valid color, for example "#ff0000".</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>backspace-indents</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Turn backspace indenting on or off.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>block-selection</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Turn block selection on or off.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>bracket-highlight-color</command
><arg
>STRING</arg
></cmdsynopsis
></term>
<listitem
><para
>Sets the color for the bracket highlight. The value must be something that can be evaluated to a valid color, for example "#ff0000" </para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>current-line-color</command
><arg
>STRING</arg
></cmdsynopsis
></term>
<listitem
><para
>Sets the color for the current line. The value must be something that can be evaluated to a valid color, for example "#ff0000".</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>dynamic-word-wrap</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Turns dynamic word wrap on or off.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>eol | end-of-line</command
><arg
>STRING</arg
></cmdsynopsis
></term>
<listitem
><para
>Sets the end of line mode. Valid settings are <quote
>unix</quote
>, <quote
>mac</quote
> and <quote
>dos</quote
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>encoding</command
><arg
>STRING</arg
></cmdsynopsis
></term>
<listitem
><para
>Sets the document encoding. The value must be a valid encoding name, like <quote
>utf-8</quote
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>font-size</command
><arg
>INT</arg
></cmdsynopsis
></term>
<listitem
><para
>Sets the point size of the document font.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>font</command
><arg
>STRING</arg
></cmdsynopsis
></term>
<listitem
><para
>Sets the font of the document. The value should be a valid font name, for example <quote
>courier</quote
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>icon-bar-color</command
><arg
>STRING</arg
></cmdsynopsis
></term>
<listitem
><para
>Sets the icon bar color. The value must be something that can be evaluated to a valid color, for example <literal
>#ff0000</literal
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>icon-border</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Set the display of the icon border on or off.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>folding-markers</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Set the display of folding markers on or off.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>indent-mode</command
><arg
>STRING</arg
></cmdsynopsis
></term>
<listitem
><para
>Set the auto-indentation mode. The options <quote
>none</quote
>, <quote
>normal</quote
>, <quote
>cstyle</quote
>, <quote
>csands</quote
>, <quote
>python</quote
>, <quote
>xml</quote
> are recognized. See the section <link linkend="kate-part-autoindent"
>Using Automatic Indenting</link
> for details.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>indent-width</command
><arg
>INT</arg
></cmdsynopsis
></term>
<listitem
><para
>Sets the indentation width.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>keep-extra-spaces</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Set wheather to keep extra spaces when calculating indentation width.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>keep-indent-profile</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>If enabled, prevents unindenting a block if at least one line has no indentation.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>line-numbers</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Set the display of line numbers on or off.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>mixed-indent</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Sets mixed indentation ala Emacs on or off.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>overwrite-mode</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Set overwrite mode on or off.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>persistent-selection</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Set persistent selection on or off.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>remove-trailing-space</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Set dynamic end of line cleanup on or off.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>replace-tabs-save</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Set tab-&gt;space conversion on save on or off.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>replace-tabs</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Set dynamic tab-&gt;space conversion on or off.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>replace-trailing-space-save</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Set end of line cleanup on save on or off.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>scheme</command
><arg
>STRING</arg
></cmdsynopsis
></term>
<listitem
><para
>Set the color scheme. The string must be the name of a color scheme that exists in your configuration to have any effect.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>selection-color</command
><arg
>STRING</arg
></cmdsynopsis
></term>
<listitem
><para
>Set the selection color. The value must be something that can be evaluated to a valid color, for example "#ff0000".</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>show-tabs</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Set the visual TAB character on or off.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>smart-home</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Set smart home navigation on or off.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>space-indent</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Set indentation with spaces on or off.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>tab-indents</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Set the TAB key indentation on or off.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>tab-width</command
><arg
>INT</arg
></cmdsynopsis
></term>
<listitem
><para
>Sets the tab display width.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>undo-steps</command
><arg
>INT</arg
></cmdsynopsis
></term>
<listitem
><para
>Sets the number of undo steps to remember.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>word-wrap-column</command
><arg
>INT</arg
></cmdsynopsis
></term>
<listitem
><para
>Set the hard word wrap width.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>word-wrap-marker-color</command
><arg
>STRING</arg
></cmdsynopsis
></term>
<listitem
><para
>Sets the work wrap marker color. The value must be something that can be evaluated to a valid color, for example "#ff0000".</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>word-wrap</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Set hard word wrapping on or off.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>wrap-cursor</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Set cursor wrapping on or off.</para
></listitem>
</varlistentry>

</variablelist>

</sect2>

</sect1>

</chapter>
