<chapter id="configuring-kate">
<chapterinfo>
<authorgroup>
<author
><personname
><firstname
></firstname
></personname
></author>
<othercredit role="translator"
><firstname
>José</firstname
><surname
>Pires</surname
><affiliation
><address
><email
>jncp@netcabo.pt</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
> 
</authorgroup>
</chapterinfo>
<title
>Configurar o &kate;</title>

<sect1 id="configuring-overview">
<title
>Introdução</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árias formas de equipar a aplicação para que se comporte como desejado. As mais importantes são: </para>

<variablelist>
<varlistentry>
<term id="configure"
>A Janela de Configuração</term>
<listitem
><para
>A ferramenta de configuração principal, que te permite configurar a aplicação &kate;, o componente do editor e a utilização de 'plugins'.</para
></listitem>
</varlistentry>
<varlistentry>
<term id="settings"
>O Menu <guimenu
>Configuração</guimenu
></term>
<listitem
><para
>permite-lhe alterar as opções mais usadas e lançar as janelas de configuração.</para
></listitem>
</varlistentry>
<varlistentry>
<term
>O Menu <guimenu
>Ver</guimenu
></term>
<listitem
><para
>Permite-lhe repartir a janela actual, assim como mostrar a barra de ícones e de números de linha para o documento actual.</para
></listitem>
</varlistentry>
</variablelist>

<para
>O &konsole; embutido usa a configuração definida no &kcontrolcenter;, e pode ser configurado carregando com o botão <mousebutton
>direito</mousebutton
> do rato e seleccionando no sub-menu <guimenuitem
>Configuração</guimenuitem
>.</para>

</sect1>

<sect1 id="configuring-kate-configdialog">
<title
>A Janela Principal de Configuração</title>

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

<para
>A janela de configuração do &kate; mostra uma árvore com os tópicos à esquerda, bem como uma página de configuração correspondente ao tópico seleccionado à direita. A árvore agrupa as páginas da janela em grupos lógicos.</para>

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

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

<variablelist>
<varlistentry>
<term
>Modo da Aplicação</term>
<listitem>
<para
><indexterm
><primary
>MDI</primary
><secondary
>SDI</secondary
></indexterm>
Este grupo permite-lhe escolher entre o modo <acronym
>MDI</acronym
> do &kate; e o modo <acronym
>SDI</acronym
>, seleccionando o botão apropriado.</para>
 <para
>O modo do &kate; <acronym
>MDI</acronym
> (Multiple Document Interface), o qual é o modo por omissão, permite ao &kate; usar uma janela para todos os ficheiros abertos. Pode escolher o documento a editar na Lista de Ficheiros (acoplada na janela do &kate; à esquerda por omissão) ou seleccionando o documento no menu <guimenu
>Documento</guimenu
>.</para>
<para
>O modo <acronym
>SDI</acronym
> (Single Document Interface) fará com que o &kate; abra cada documento numa janela própria e, nesse caso, a Lista de Ficheiros/Selector de Ficheiros terá uma janela separada.</para>
 <para
>Se alterar esta opção, terá de reiniciar o &kate; para que faça efeito.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>No Início</term>
<listitem
><para
>Estas opções determinam como e se o &kate; irá recuperar a sua sessão de edição ao ser lançado após uma saída normal do sistema (se for recuperada pelo gestor de sessões, o &kate; irá tentar sempre recuperar a sua sessão, tanto quanto possível, como a tinha quando usou o &kate; pela última vez).</para>

<variablelist>
<varlistentry>
<term>
<anchor id="config-dialog-general-reopen-files"/>
<guibutton
>Reabrir os Ficheiros</guibutton
></term>
<listitem
><para
>Se esta opção estiver activa, os ficheiros abertos desde que fechaste o &kate; serão reabertos. Os Favoritos serão recuperados e a posição do cursor, o contorno do ícone e a configuração dos números de linha do último editor usados com o documento serão restabelecidos</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guibutton
>Restaurar a Configuração da Janela</guibutton
></term>
<listitem
><para
>Se esta opção estiver activa, o &kate; irá tentar recuperar as tuas janelas tal como as deixaste.</para
></listitem>
</varlistentry>
</variablelist>

</listitem>

</varlistentry>

<varlistentry>
<term
><guibutton
>Restringir a uma só instância</guibutton
></term>
<listitem
><para
>Se activar isto, só pode ter uma instância do &kate; em execução a qualquer altura. Se tentar iniciar outra, a instância actual sobrepor-se-á e irá abrir os ficheiros pedidos. Por exemplo, se usar o &kate; para abrir código-fonte em páginas Web no &konqueror;, elas serão todas abertas numa instância existente do &kate; se esta opção estiver activa.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Mostrar Conteúdo ao Redimensionar Janelas</guibutton
></term
> <listitem
><para
>Se esta opção estiver activa, as janelas serão redesenhadas por completo enquanto arrasta os separadores de janelas.  Se estiver desligada, será mostrada apenas uma <quote
>banda</quote
> (que indica o novo tamanho da janela) em alternativa.</para
></listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-general-sync-konsole"/>
<guibutton
>Sincronizar o Konsole com o Documento Actual</guibutton
></term>
<listitem
><para
>Isto fará com que o &konsole; embutido faça <command
>cd</command
> para a directoria do documento activo quando for lançado e de cada vez que um novo documento passa para primeiro plano. Se não estiver activo, tem de efectuar a sua navegação no &konsole; por si próprio. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Número de Ficheiros Recentes</guibutton
></term>
<listitem
><para
>Permite-lhe decidir quanto deve crescer o menu <guimenu
>Abrir Recente</guimenu
>.</para
></listitem>
</varlistentry>

</variablelist>
</sect3>

<sect3 id="config-dialog-documentlist">
<title
>A Página de Lista de Documentos</title>
<para
>Esta página permite-lhe activar ou desactivar a visualização sombreada do fundo da sua actividade recente e escolher as cores a usar, se estiver activada. Veja a secção sobre a <link linkend="kate-mdi-tools-file-list"
>Lista de Documentos</link
> para mais dados sobre esta funcionalidade.</para>
</sect3>

<sect3 id="config-dialog-externaltools">
<title
>Ferramentas Externas</title>

<para
>No menu <guimenu
>Ferramentas</guimenu
>, você poderá ver um submenu chamado <guisubmenu
>Ferramentas Externas</guisubmenu
>. Estas ferramentas invocam aplicações externas com dados relacionados com o documento actual, como por exemplo o seu URL, pasta, texto ou selecção. Esta página permite-lhe gerir o menu e editar, remover ou adicionar ferramentas.</para>

<para
>Cada ferramenta externa é um comando da consola que contém macros representantes dos dados do documento. Quando estiver activada, as macros são substituídas por dados do documento activo.</para>

<variablelist>
<title
>Propriedades das Ferramentas Externas</title>
<varlistentry>
<term
>Legenda</term>
<listitem
><para
>Uma legenda amigável para o menu de Ferramentas Externas.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>'Script'</term>
<listitem
><para
>O programa a executar quando a ferramenta estiver activada. Antes de passar o programa à linha de comandos, são substituídas as seguintes macros: <variablelist>
<varlistentry>
<term
>%URL</term>
<listitem
><para
>O URL completo do documento actual ou um texto vazio, se o documento não for gravado.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>%URLS</term>
<listitem
><para
>Uma lista, separada por espaços, dos URLs de todos os documentos abertos (excepto os não-gravados).</para
></listitem>
</varlistentry>

<varlistentry>
<term
>%directory</term>
<listitem
><para
>A parte de directoria do URL do documento actual ou um texto vazio se o documento actual não estiver gravado.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>%filename</term>
<listitem
><para
>O nome do ficheiro do documento actual, sem a parte da pasta, ou um texto vazio se o documento actual não estiver gravado.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>%line</term>
<listitem
><para
>O número de linha onde o cursor de inserção se encontra no documento actual.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>%column</term>
<listitem
><para
>O número da coluna onde o cursor de inserção se encontra no documento actual.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>%selection</term>
<listitem
><para
>O texto seleccionado no documento actual ou um texto vazio se não estiver qualquer texto seleccionado</para
></listitem>
</varlistentry>

<varlistentry>
<term
>%text</term>
<listitem
><para
>O texto completo do documento actual. Tenha em atenção que este poderá exceder potencialmente o comprimento máximo do comando no seu sistema. Use-o com cuidado.</para
></listitem>
</varlistentry>

</variablelist>

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

<varlistentry>
<term
>Executável</term>
<listitem
><para
>O executável principal no programa. Isto é obrigatório e é usado para testar se o comando poderá ser executado de todo. É permitida uma localização absoluta, no caso de o executável não se encontrar acessível através da sua variável <envar
>PATH</envar
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Tipos MIME</term>
<listitem
><para
>Uma lista, separada por pontos-e-vírgulas, dos tipos MIME que estão activos para este comando. Isto normalmente não é usado.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Gravar</term>
<listitem
><para
>Você poderá, opcionalmente, optar por gravar o documento actual ou todos os documentos, antes de executar o programa. Isto é útil se o seu programa ler o ficheiro do disco.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Nome da Linha de Comandos</term>
<listitem
><para
>Se você preencher isto, a ferramenta estará disponível na <link linkend="advanced-editing-tools-commandline"
>linha de comandos dos editores</link
> como <command
>exttool-<replaceable
>Nome da Linha de Comandos</replaceable
></command
> (o texto que indicar aqui é antecedido por <quote
>exttool-</quote
>).</para
></listitem>
</varlistentry>

</variablelist>

</sect3>

</sect2>

<sect2 id="config-dialog-editor">
<title
>O Grupo Editor</title>
<para
>Este grupo contém todas as páginas relacionadas com o componente de edição do &kate;. A maioria das configurações aqui são os valores predefinidos, que podem ser substituídos ao <link linkend="config-dialog-editor-filetypes"
>definir um tipo de ficheiro</link
>, nas <link linkend="config-variables"
>Variáveis do Documento</link
> ou através da sua alteração, durante uma sessão de edição do documento.</para>

<sect3 id="config-dialog-editor-colors">
<title
>A Página <guimenu
>Cores</guimenu
></title
> <para
>Esta página permite-lhe alterar as cores do texto e do fundo do editor. Inicialmente, o &kate; irá usar as cores definidas no &kcontrolcenter;, na sua página <menuchoice
><guimenu
>Aparência e Comportamento</guimenu
><guimenuitem
>Cores</guimenuitem
> </menuchoice
>.</para>

<para
>Para mudares uma cor, carrega no botão associado e selecciona a cor desejada no seu selector respectivo.</para>

<note
><para
>Ao escolheres a cor de fundo pode tornar o texto com a sintaxe realçada ilegível. Deve escolher uma cor clara para o fundo e uma cor escura para o fundo das selecções. </para>
<para
>Caso contrário, poderás necessitar de alterar os <link linkend="config-dialog-editor-highlight-default-styles"
>Estilos por Omissão</link
>.</para>
</note>
</sect3>

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

<para
>Esta página permite escolher os tipos de letra por omissão do &kate;. A configuração será também usada para o &kwrite; e para ver os ficheiros de texto no &konqueror;.</para>

<para
>A página apresenta duas secções, uma para o tipo de letra do editor e outra para o tipo de letra da impressão. Selecciona uma página e escolhe o tipo de letra desejado. Por omissão, é utilizado o tipo de letra monoespaçado global do &kde;.</para>

<tip
><para
>Dado que não é possível de momento usar tipos de letra individuais para os documentos, nem é permitido alterar o tipo de letra da impressão na janela de impressão, tem cuidado. Recomenda-se um tipo de letra monoespaçado. </para
></tip>
</sect3>

<sect3 id="config-dialog-editor-indent">
<title
>A Página Indentar</title>
<para
>Esta página permite-lhe alterar o comportamento da indentação.</para>

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

<varlistentry>
<term>
<anchor id="config-dialog-editor-indent-auto-indent"/>
<guibutton
>Auto-indentar</guibutton>
</term>
<listitem>
<para
>se estiver activa, o &kate; irá indentar as linhas novas como a anterior. Se a linha anterior estiver em branco, é usada a linha anterior que tiver texto.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-indent-indent-with-spaces"/>
<guibutton
>Indentar com Espaços</guibutton>
</term>
<listitem>
<para
>Se estiver seleccionada, o &kate; irá indentar com espaços em vez de tabulações.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-indent-backspace-key-indents"/>
<guibutton
>A tecla Backspace indenta</guibutton>
</term>
<listitem>
<para
>Se isto estiver seleccionado, o &kate; irá desfazer a indentação de uma forma igual à linha não-vazia anterior quando carregar na tecla <keycap
>Backspace</keycap
> se a parte da linha que precede o cursor só contiver espaços.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-indent-tab-key-indents"/>
<guibutton
>A tecla Tab indenta</guibutton>
</term>
<listitem>
<para
>Se isto estiver seleccionado, o &kate; irá tentar indentar a linha actual da mesma forma que a linha não-vazia anterior quando carregar na tecla <keycap
>Tab</keycap
>, se a componente da linha que precede o cursor só conter espaços.</para>
</listitem>
</varlistentry>

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

</variablelist>

</sect3>

<sect3 id="config-dialog-editor-select">
<title
>A Página Seleccionar</title>

<para
>Esta página oferece opções para afinar o comportamento da selecção do &kate;</para>

<variablelist>
<title
>Opções da Selecção</title>

<varlistentry>
<term>
<anchor id="config-dialog-editor-select-persistent-selections"/>
<guibutton
>Selecções Persistentes</guibutton>
</term>
<listitem>
<para
>Quando as Selecções Persistentes estão activas, a introdução de caracteres não provoca a diminuição/remoção da selecção.</para>
<note
><para
>Esta opção entra parcialmente em conflito com a opção Substituir Selecções. Se ambas estiverem seleccionadas, a colagem de texto ou o pressionar de outras teclas sem serem os cursores fará com que a selecção seja substituída.</para
></note>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-select-overwrite-selections"/>
<guibutton
>Substituir Selecções</guibutton>
</term>
<listitem>
<para
>Se isto estiver seleccionado, toda a introdução de texto, quer escrito quer colado, fará com que o texto seleccionado seja apagado e substituído pelo texto inserido.</para>
</listitem>
</varlistentry>

</variablelist>

</sect3>

<sect3 id="config-dialog-editor-edit">
<title
>A Página Editar</title>
<para
>Esta página contém opções diversas para ajustar o comportamento da componente do editor &kate;.</para>

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

<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-word-wrap"/>
<guibutton
>Mudança de Linha</guibutton>
</term>
<listitem>
<para
>A opção Mudança de Linha significa que o texto é formatado dinamicamente através da quebra de linhas a partir de um local apropriado, em vez da mudança normal de linha, para uma leitura mais fácil.</para>
<para
>Se estiver activo, o &kate; irá inserir uma quebra de linha tal como está definido na opção <link linkend="document-end-of-line"
>Fim de Linha</link
> para o documento quando a linha ultrapassa o tamanho definido em <link linkend="config-dialog-editor-edit-wrap-words-at"
>Mudar Palavras em</link
> descrita em baixo.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-wrap-words-at"/>
<guibutton
>Mudar Palavras Em</guibutton>
</term>
<listitem>
<para
>Esta opção decide o tamanho máximo das linhas se a opção <link linkend="config-dialog-editor-edit-word-wrap"
>Mudar de Linha</link
> estiver activa.</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 estiver activa, o &kate; irá substituir os caracteres <keycap
>Tab</keycap
> introduzidos por um número conveniente de espaços, tal como definido na <link linkend="config-dialog-editor-edit-tab-indent-width"
>Tabulação</link
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-remove-trailing-spaces"/>
<guibutton
>Remover os espaços finais</guibutton>
</term>
<listitem>
<para
>Se estiver activo, o &kate; irá remover os espaços em branco no fim de cada linha, de cada vez que o cursor passa para lá do seu fim.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-tab-indent-width"/>
<guibutton
>Tabulação</guibutton>
</term>
<listitem>
<para
>Define o tamanho da tabulação, o qual também é usado para definir o tamanho da indentação quando a opção <link linkend="config-dialog-editor-indent-auto-indent"
>Auto-Indentar</link
> está activa ou a indentação é chamada explicitamente.</para>
<para
>Dependendo da configuração da página <link linkend="config-dialog-editor-indent"
>Indentar</link
>, a indentação pode ser efectuada através do carregar das teclas <keycap
>Tab</keycap
> e <keycap
>Backspace</keycap
>. Activando a opção do menu  <link linkend="edit-indent"
><guimenu
>Editar</guimenu
> <guimenuitem
>Indentar</guimenuitem
></link
> causa o mesmo efeito.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-auto-brackets"/>
<guibutton
>Parêntesis Automáticos</guibutton>
</term>
<listitem>
<para
>Se isto estiver seleccionado, o &kate; irá tentar inserir um parêntesis direito imediatamente à direita do cursor quando é introduzido um parêntesis esquerdo pelo utilizador. Os tipos de parêntesis suportados são o <keycap
>(</keycap
>, o <keycap
>{</keycap
>, o <keycap
>[</keycap
> e o <keycap
>&lt;</keycap
></para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-group-undos"/>
<guibutton
>Agrupar as anulações</guibutton>
</term>
<listitem>
<para
>Se estiver activo, o &kate; irá agrupar as acções de edição semelhantes (como por exemplo a escrita, o apagar de caracteres ou a colagem) como um registo só no histórico do 'desfazer', de modo a que possam ser efectuadas as anulações de uma vez.</para>
</listitem>
</varlistentry>


<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-show-tabs"/>
<guibutton
>Mostrar Tabulações</guibutton>
</term>
<listitem>
<para
>Se a opção estiver activa, o &kate; irá desenhar um pequeno ponto no início de um carácter <keycap
>Tab</keycap
> no editor para indicar a sua presença.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<anchor id="config-dialog-editor-edit-smart-home"/>
<guibutton
>Início Inteligente</guibutton>
</term>
<listitem>
<para
>Isto fará com que o &kate; mova o cursor para o primeiro carácter válido da linha actual em vez de ir para a primeira coluna da linha, quando se carrega na tecla <keycap
>Home</keycap
> (ou em qualquer outra tecla atribuída a essa função).</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
>Mudar o Cursor</guibutton>
</term>
<listitem>
<para
>Se estiver activo, ao moveres o cursor para lá do fim de uma linha fará com que ele continue na linha anterior/seguinte, se existir.</para>
<para
>Se não estiver activo, o cursor não pode ser movido para o início da linha, mas pode ser movido para lá do fim da mesma e, quando o texto é introduzido, o &kate; irá inserir automaticamente espaços em branco até essa posição, o que pode ser útil para os programadores, por exemplo, em algumas situações.</para>
</listitem>
</varlistentry>

</variablelist>

</sect3>

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

<para
>Aqui pode configurar os atalhos de teclado para os comandos internos da componente de editor do &kate;. Isto inclui os comandos para percorrer o documento e seleccionar texto. Para as teclas usadas para copiar e colar texto, veja a janela Configurar Teclas </para>

<para
>Pode alterar as teclas para um comando ou adicionar uma tecla alternativa.</para>

<procedure>
<title
>Para alterar a(s) tecla(s) para um comando, segue este procedimento:</title>
<step>
<para
>Selecciona o comando para o qual queres configurar as teclas.</para>
</step>
<step>
<para
>Escolhe a opção <guibutton
>Nenhuma</guibutton
> na área por baixo da lista se não quiseres uma tecla para este comando.</para>
<para
>Escolhe a opção <guibutton
>Predefinida</guibutton
> para usares a(s) tecla(s) por omissão para o comando</para>
<para
>Seleccione a opção <guibutton
>Personalizada</guibutton
> para escolher uma tecla personalizada para o comando ou definir uma alternativa.</para>
</step>
<step>
<para
>Se escolheu a opção <guibutton
>Personalizada</guibutton
>, o botão da tecla à direita ficará activo. Para alterar uma tecla, carregue nela. A Janela de Definição do Atalho irá aparecer. Nesta janela:</para>
</step>
<step>
<procedure>
<step>
<para
>Escolhe se queres alterar a tecla por omissão ou a alternativa. A <guilabel
>Primária</guilabel
> não significa que alteras a tecla por omissão, simplesmente ela altera a tecla personalizada respectiva.</para>
</step>
<step>
<para
>Carrega na sequência de teclas desejada; esta será visualizada por ti na janela para tu confirmares. </para>

<para
>Se tiver uma natureza aventureira, tente brincar com a opção <guibutton
>Multi-tecla</guibutton
>. Ao usá-la poderá usar sequências semelhantes às do &Emacs; (uma indica o grupo, a outra executa a acção), à parte do facto que, em vez de desempenhar apenas a tarefa, o &kde; irá mostrar um menu para escolher num local indefinido e às vezes inapropriado. Agora não terá dúvidas que, enquanto carregar a próxima tecla da sequência, irá funcionar, ou então terá de indicar o acelerador do menu (ambos funcionarão).</para>
</step>
</procedure>
</step>
</procedure>
</sect3>

<sect3 id="config-dialog-editor-filetypes">
<title
>A Página Tipos de Ficheiro</title>

<para
>Esta página permite-lhe sobrepor a configuração predefinida para os documentos com os tipos MIME indicados. Quando o editor carregar um documento, ele irá tentar ver se corresponde aos padrões de nomes de ficheiros ou tipos MIME para um dos tipos de ficheiros de definidos e, se algum corresponder, irá aplicar as variáveis definidas. Se vários corresponderem, será usado o que tiver a prioridade maior. Veja por favor a secção <link linkend="config-variables"
>Configurar com as Variáveis do Documento</link
> para saber como definir variáveis.</para>

<para
>Para criar um tipo de ficheiro, carregue no botão <guibutton
>Novo</guibutton
> e preencha as propriedades.</para>

<para
>Para remover um tipo de ficheiro existente, seleccione-o na lista e carregue no botão <guibutton
>Apagar</guibutton
>.</para>

<para
>Para editar um tipo de ficheiro existente, seleccione-o na lista.</para>

<variablelist>

<title
>Propriedades de Tipo de Ficheiro</title>

<varlistentry>
<term
>Nome</term>
<listitem
><para
>Este é um nome amigável que poderá ser mostrado no menu <menuchoice
><guisubmenu
>Ferramentas</guisubmenu
><guisubmenu
>Tipos de Ficheiros</guisubmenu
></menuchoice
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Secção</term>
<listitem
><para
>Um submenu de <menuchoice
><guisubmenu
>Ferramentas</guisubmenu
><guisubmenu
>Tipos de Ficheiros</guisubmenu
></menuchoice
>, no qual colocar este tipo de ficheiro. Se a secção não existir já, será criada para si.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Variáveis</term>
<listitem
><para
>Aqui é par aonde vai a configuração actual. As variáveis aqui definidas irão sobrepor os valores de configuração predefinidos. Por favor, veja a secção <link linkend="config-variables"
>Configurar com as Variáveis do Documento</link
> para saber as variáveis disponíveis.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Extensões de Ficheiro</term>
<listitem
><para
>Uma lista, separada por pontos-e-vírgulas, dos padrões de nomes de ficheiros que serão usados para determinar se um documento pertence a este tipo de ficheiros.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Tipos MIME</term>
<listitem
><para
>Uma lista, separada por pontos-e-vírgulas, dos tipos MIME, que é usada para determinar se um documento corresponde a este tipo de ficheiro.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Prioridade</term>
<listitem
><para
>Se um documento corresponder a vários tipos de ficheiros, o que tiver a prioridade mais elevada será o escolhido.</para
></listitem>
</varlistentry>

</variablelist>

</sect3>

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

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

<para
>Esta página permite-lhe ajustar a cor e a selecção do tipo de sintaxe do &kate;</para>
<para>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="configdialog02.png"/></imageobject>
</mediaobject>
</para>
<para
>Para uma informação mais detalhada acerca do sistema de realce de sintaxe, vê ??</para>

<para
>A página consiste em duas secções, uma para definir os <guibutton
>Estilos por omissão</guibutton
> e outra para gerir os <guibutton
>Modos de Realce</guibutton
>. Ambas as secções mostram uma lista de contextos nos quais as cores e tipos de letra por omissão são usados para visualizar a aparência de cada estilo. O nome do contexto é desenhado com as propriedades actuais do contexto.</para>

<para
>A lista tem quatro ou cinco colunas, cada uma com o seguinte fim:</para>

<variablelist>

<varlistentry>
<term
>Contexto</term>
<listitem
><para
>Mostra o nome do contexto, desenhado com as propriedades do estilo para o contexto.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Negrito</term>
<listitem
><para
>O estado desta opção decide se o contexto deve ser desenhado com um tipo de letra negrito (mais carregado).</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Itálico</term>
<listitem
><para
>O estado desta opção decide se o contexto deve ser desenhado com um tipo de letra itálico.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Normal</term>
<listitem
><para
>Este botão mostra a cor para desenhar o estilo no modo normal, isto é, quando não está seleccionado. Para alterar a cor, carregue no botão.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Seleccionado</term>
<listitem
><para
>Este botão mostra a cor para desenhar o estilo quando o texto está seleccionado. Para alterares a cor, carrega no botão.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Usar Estilo Predefinido</term>
<listitem
><para
>Esta opção, só disponível na página <guibutton
>Modos de Realce</guibutton
>, mostra se o estilo está a usar os seus valores por omissão. Ficará automaticamente deseleccionada se mudares alguma propriedade do estilo. Selecciona-a para repor um estilo para os seus valores predefinidos.</para
></listitem>
</varlistentry>

</variablelist>

<sect4 id="config-dialog-editor-highlight-default-styles">
<title
>A Página Estilos Predefinidos</title>
<para
>Para alterares algum dos estilos por omissão, define as suas propriedades para o valor desejado.</para>
</sect4>

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

<para
><indexterm
><primary
>realce de sintaxe, configuração</primary
></indexterm
> Aqui pode alterar as propriedades mais importantes de cada modo de realce disponível. Primeiro, utilize a lista <guibutton
>Realce</guibutton
> para escolher um modo no qual trabalhar.</para
> <para
>Os modos de realce são seleccionados inicialmente com base no tipo &MIME; e na extensão do ficheiro. Para mudares a lista para a selecção actual, edita os campo <guibutton
>Extensões do Ficheiro</guibutton
> e <guibutton
>Tipos MIME</guibutton
>. Em alternativa, carrega no botão de assistência à direita do campo <guibutton
>Tipos MIME</guibutton
>. Isto irá mostrar uma janela que apresenta todos os tipos &MIME; a partir dos quais poderás escolher. Se usares essa janela irás editar os tipos &MIME; assim como as extensões dos ficheiros.</para>

<mediaobject>
<imageobject
><imagedata format="PNG" fileref="mimetypechooser.png"/></imageobject>
</mediaobject>
<para
>A janela de selecção de tipos &MIME; mostra uma árvore com todos os tipos &MIME;, com uma descrição e os padrões para o tipo &MIME;. Para incluir um tipo &MIME;, assinala a opção por baixo dele. </para>

<para
>Pode alterar as propriedades do estilo de qualquer contexto tal como descrito em cima.</para>

<para
>À direita da secção, por baixo das propriedades do realce, pode ver um botão chamado <guibutton
>Obter</guibutton
>. Se carregar nele, será efectuada uma ligação ao 'site' do &kate; para obter uma lista com os modos de sintaxe disponíveis para poder efectuar a sua actualização.</para>

</sect4>

</sect3>

</sect2>

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

<para
><indexterm
><primary
>'plugins', configuração</primary
></indexterm
> Este grupo contém as páginas referentes aos 'plugins'. Para além da página de configuração do Gestor, alguns dos 'plugins' disponibilizam opções de configuração individuais. Para mais informação sobre estas, vê a documentação para os 'plugins' individuais.</para>

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

<para
>Esta página disponibiliza os meios para activar/desactivar 'plugins', bem como informações mínimas sobre os 'plugins' individualmente.</para>

<para
>Para carregar um 'plugin' inactivo, seleccione-o na lista <guibutton
>'Plugins' Disponíveis</guibutton
> e use as teclas das setas para o mover para os <guibutton
>'Plugins' Carregados</guibutton
>.</para>

<para
>Para desactivar um 'plugin' activo, seleccione-o na lista <guibutton
>'Plugins' Carregados</guibutton
> e utilize as setas para os mover para a lista de <guibutton
>'Plugins' Disponíveis</guibutton
>.</para>

<para
>Para veres uma descrição mínima e as informações sobre um 'plugin', selecciona-o para que a informação fique disponível por baixo das listas.</para>
</sect3>

</sect2>

</sect1>

<sect1 id="config-variables">

<title
>Configurar com as Variáveis do Documento</title>

<para
>As variáveis do Kate 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 formato <userinput
>kate: NOMEVARIÁVEL VALOR; [ NOMEVARIÁVEL VALOR; ... ]</userinput
>; as linhas poderão estar, claro, num comentário, se o ficheiro 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é ao próximo ponto-e-vírgula é o valor. Esse ponto-e-vírgula é obrigatório.</para>

<para
>Aqui está uma linha de variável de exemplo, obrigando a configuração da indentação para um ficheiro em C++, Java ou JavaScript: <programlisting
>// kate: space-indent on; indent-width 4; mixedindent off; indent-mode cstyle;</programlisting>
</para>

<note
><para
>Só as primeiras e últimas 10 linhas serão pesquisadas pelas linhas de variáveis.</para
></note>

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

<sect2 id="config-variables-howto">
<title
>Como o kate utiliza as variáveis</title>

<para
>Ao ler a configuração, o 'katepart' procura nos seguintes locais (por esta ordem): <itemizedlist
> <listitem
><para
>A configuração global.</para
></listitem
> <listitem
><para
>Os dados opcionais da sessão.</para
></listitem
> <listitem
><para
>A configuração do "Tipo de ficheiro".</para
></listitem
> <listitem
><para
>As variáveis do próprio documento.</para
></listitem
> <listitem
><para
>As configurações feitas durante a edição do menu ou da linha de comandos.</para
></listitem
> </itemizedlist
> Como poderá compreender, as variáveis do documento têm a próxima precedência mais elevada. Sempre que um documento for gravado, as variáveis do documento são lidas de novo e irão sobrepor as alterações feitas, usando os itens do menu ou nas linhas de comandos.</para>

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

<para
>As variáveis aqui indicadas dizem respeito ao &kate; versão 2.4. Poderão ser adicionadas mais variáveis no futuro. Existem 3 tipos de valores definidos para as variáveis, com as expressões válidas seguintes: <itemizedlist>
<listitem
><para
>BOOL - on|off|true|false|1|0</para
></listitem>
<listitem
><para
>INTEIRO - qualquer número inteiro</para
></listitem>
<listitem
><para
>TEXTO - tudo o resto</para
></listitem>
</itemizedlist>
</para>

<variablelist>
<title
>Variáveis Disponíveis</title>

<varlistentry>
<term
><cmdsynopsis
><command
>auto-brackets</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa ou desactiva a inserção automática de parêntesis rectos.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>auto-center-lines</command
><arg
>INT</arg
></cmdsynopsis
></term>
<listitem
><para
>Define o número de linhas centradas automaticamente.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>auto-insert-doxygen</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa ou desactiva a inserção do asterisco inicial nos comentários do 'doxygen'. Isto não faz efeito, a menos que você use o sistema de indentação do tipo do C. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>background-color</command
><arg
>TEXTO</arg
></cmdsynopsis
></term>
<listitem
><para
>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".</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>backspace-indents</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa ou desactiva a indentação com o Backspace.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>block-selection</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa ou desactiva a selecção em bloco.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>bracket-highlight-color</command
><arg
>TEXTO</arg
></cmdsynopsis
></term>
<listitem
><para
>Define a cor de realce dos parêntesis. O valor deverá ser algo que possa ser avaliado como uma cor válida, como por exemplo "#ff0000" </para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>current-line-color</command
><arg
>TEXTO</arg
></cmdsynopsis
></term>
<listitem
><para
>Define a cor da linha actual. O valor deverá ser algo que possa ser avaliado como uma cor válida, como por exemplo "#ff0000".</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>dynamic-word-wrap</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa ou desactiva a mudança de linha dinâmica.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>eol | end-of-line</command
><arg
>TEXTO</arg
></cmdsynopsis
></term>
<listitem
><para
>Define o modo de fim-de-linha. Os valores válidos são o <quote
>unix</quote
>, o <quote
>mac</quote
> e o <quote
>dos</quote
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>encoding</command
><arg
>TEXTO</arg
></cmdsynopsis
></term>
<listitem
><para
>Define a codificação do documento. O valor deverá ser um nome de codificação válido, como por exemplo <quote
>utf-8</quote
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>font-size</command
><arg
>INT</arg
></cmdsynopsis
></term>
<listitem
><para
>Define o tamanho da letra do documento.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>font</command
><arg
>TEXTO</arg
></cmdsynopsis
></term>
<listitem
><para
>Define o tipo de letra do documento. O valor deverá ser um nome de um tipo de letra válido, como por exemplo <quote
>courier</quote
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>icon-bar-color</command
><arg
>TEXTO</arg
></cmdsynopsis
></term>
<listitem
><para
>Define a cor da barra de ícones. O valor deverá ser algo que possa ser avaliado como uma cor válida, como por exemplo <literal
>#ff0000</literal
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>icon-border</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa ou desactiva a visibilidade do contorno dos ícones.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>folding-markers</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa ou desactiva a visualização dos marcadores de expansão/contracção do código.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>indent-mode</command
><arg
>TEXTO</arg
></cmdsynopsis
></term>
<listitem
><para
>Define o modo de indentação automática. As opções <quote
>none</quote
>, <quote
>normal</quote
>, <quote
>cstyle</quote
>, <quote
>csands</quote
>, <quote
>python</quote
>, <quote
>xml</quote
> são as reconhecidas, de momento. Veja a secção <xref linkend="kate-part-autoindent"/> para mais detalhes.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>indent-width</command
><arg
>INT</arg
></cmdsynopsis
></term>
<listitem
><para
>Define a largura de indentação.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>keep-extra-spaces</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Define se deseja manter os espaços extra ao calcular a largura de indentação.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>keep-indent-profile</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Se estiver activada, evita a remoção da indentação de um bloco se, pelo menos, uma linha não tiver indentação.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>line-numbers</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa ou desactiva a visibilidade dos números de linha.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>mixed-indent</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa ou desactiva a indentação mista à Emacs.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>overwrite-mode</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa ou desactiva o modo de sobreposição.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>persistent-selection</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Ligar ou desligar as selecções persistentes.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>remove-trailing-space</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa ou desactiva a limpeza dinâmica dos fins-de-linha.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>replace-tabs-save</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa ou desactiva a conversão de tabulações para espaços na gravação.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>replace-tabs</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa ou desactiva a conversão dinâmica de tabulações para espaços na gravação.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>replace-trailing-space-save</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa ou desactiva a limpeza dos fins-de-linha na gravação.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>scheme</command
><arg
>TEXTO</arg
></cmdsynopsis
></term>
<listitem
><para
>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.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>selection-color</command
><arg
>TEXTO</arg
></cmdsynopsis
></term>
<listitem
><para
>Define a cor da selecção. O valor deverá ser algo que possa ser avaliado como uma cor válida, como por exemplo "#ff0000".</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>show-tabs</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa ou desactiva o carácter TAB visível.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>smart-home</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa ou desactiva a navegação inteligente do Home.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>space-indent</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa ou desactiva a indentação com espaços.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>tab-indents</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa ou desactiva a indentação com tabulações.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>tab-width</command
><arg
>INT</arg
></cmdsynopsis
></term>
<listitem
><para
>Define a largura das tabulações.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>undo-steps</command
><arg
>INT</arg
></cmdsynopsis
></term>
<listitem
><para
>Define o número de passos a recordar no Desfazer/Refazer.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>word-wrap-column</command
><arg
>INT</arg
></cmdsynopsis
></term>
<listitem
><para
>Define a largura restrita da linha para as palavras.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>word-wrap-marker-color</command
><arg
>TEXTO</arg
></cmdsynopsis
></term>
<listitem
><para
>Define a cor do marcador de mudança de linha. O valor deverá ser algo que possa ser avaliado como uma cor válida, como por exemplo "#ff0000".</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>word-wrap</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa ou desactiva a mudança restrita de linha das palavras.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>wrap-cursor</command
><arg
>BOOL</arg
></cmdsynopsis
></term>
<listitem
><para
>Activa ou desactiva a envolvência do cursor.</para
></listitem>
</varlistentry>

</variablelist>

</sect2>

</sect1>

</chapter>
