<chapter id="plugins">

<chapterinfo>
<authorgroup>
<author
>&Anders.Lund; &Anders.Lund.mail;</author>
<othercredit role="translator"
><firstname
>José</firstname
><surname
>Pires</surname
><affiliation
><address
><email
>zepires@gmail.com</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
> 
</authorgroup>
</chapterinfo>

<title
>Lidar com 'Plugins'</title>

<para
>O Kate está a usar dois tipos diferentes de 'plugins', nomeadamente os 'plugins' para a aplicação &kate; e os 'plugins' para o componente de edição do &kate;. Os últimos estão disponíveis em qualquer aplicação que use o componente de edição, como o KDevelop, o Quanta, o Kile, o Kwrite e muitos outros, enquanto os 'plugins' da aplicação são específicos apenas do &kate;.</para>

<para
>Poderá activar ambos os tipos de 'plugins' na <link linkend="configuring-kate-configdialog"
>janela de configuração</link
>, a qual também oferece acesso às opções de configuração adicionais dos 'plugins' que necessitem deles.</para>

<para
>Existem vários 'plugins' para vários fins disponíveis e poderá procurar mais na Web. Alguns 'plugins' são fornecidos com o componente de edição, para fazer completação de palavras, favoritos automáticos, inserções de ficheiros, ferramentas de dados ou a exportação do texto como &HTML;.</para>

<sect1 id="kate-editor-plugins">
<title
>'Plugins' do Componente de Edição</title>

<para
>A página de <guilabel
>'Plugins'</guilabel
>, na página <guilabel
>Extensões</guilabel
>, apresenta todos os 'plugins' disponíveis e você poderá assinalar os que deseja usar. Carregue no botão <guibutton
>Informação</guibutton
> para abrir a janela <guilabel
>Acerca</guilabel
> deste 'plugin'.</para>
<para
>Assim que um 'plugin' configurável esteja assinalado, o botão <guibutton
>Configurar</guibutton
> fica activo para que possa carregar nele, de modo a configurar o 'plugin' realçado.</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Parêntesis Automáticos</guilabel
></term>
<listitem
><para
>O 'plugin' de parêntesis automáticos substitui a funcionalidade interna do &kate; para <quote
>Parêntesis Automáticos</quote
>. Introduz automaticamente um parêntesis de fecho <keycap
>}</keycap
> no início da próxima linha, depois de terminar uma dada linha com um parêntesis de abertura <keycap
>{</keycap
> e carregar na tecla &Enter;.</para
></listitem>
</varlistentry>
<!--http://jakob.petsovits.at/topic/kate-->
<!--Right, it's the automatic insertion of a closing brace ("}") after you ended a line with an opening one ("{"). Kate's standard insertion of parentheses, brackets and braces is simply too obtrusive for me, so even if I tried it several times I always had to disable it again because I can't stand it. So here's how AutoBrace works.
You, the developer, are writing a line of code, and want to open a new block delimited by braces. Looks like this:
If you press Enter and AutoBrace is enabled, it will insert your favorite new brace where it belongs. Looks like this:
-->
<varlistentry>
<term
><guilabel
>Ferramentas de Dados</guilabel
></term>
<listitem
><para
>Activa as ferramentas de dados, como a verificação gramatical e ortográfica (se estiverem instalados). As ferramentas de dados só ficam disponíveis quando tem texto seleccionado, ou quando o botão direito do rato é carregado sobre uma palavra. Se não existirem ferramentas de dados disponíveis, mesmo quando selecciona algum texto, terá de as instalar. Algumas ferramentas de dados fazem parte do pacote &koffice;. Se este 'plugin' estiver activo e se as ferramentas de dados estiverem instalados, irão aparecer alguns itens adicionais no fim do menu do contexto.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><link linkend="kate-editor-plugin-exporter"
><guilabel
>Exportador</guilabel
></link
></term>
<listitem
><para
>Este comando permite-lhe exportar o documento actual com toda a informação de realce para um documento em HTML, usando a opção <menuchoice
><guimenu
>Ficheiro</guimenu
><guimenuitem
>Exportar como HTML</guimenuitem
></menuchoice
>. Para além disso, poderá usar a opção <menuchoice
><guimenu
>Editar</guimenu
> <guimenuitem
>Copiar como HTML</guimenuitem
></menuchoice
> para copiar o texto seleccionado de momento como HTML para a área de transferência do sistema.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Inserção de Ícones</guilabel
></term>
<listitem
><para
>O 'plugin' de inserção de ícones só é usada para os programadores do &kde;: Adiciona um item <guimenuitem
>Inserir um Código de KIcon</guimenuitem
> no menu de contexto do editor. Se estiver activado, o selector de ícones do &kde; irá abrir (mostrando os ícones das aplicações, das acções, &etc;..). Se carregar num, será inserido como texto o nome do ficheiro sem a extensão do mesmo. Só é útil para atribuir ícones, através da plataforma do &kde;, com a classe KIcon(). </para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Codificação louca (não ZEN) de HTML (edição leve)</guilabel
></term>
<listitem
><para
>Um 'plugin' que faz uma completação de selectores semelhante à codificação Zen. Para mais informações, veja a <ulink url="http://en.wikipedia.org/wiki/Zen_Coding"
>Codificação Zen</ulink
>.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Inserir um Ficheiro</guilabel
></term>
<listitem
><para
>Este 'plugin' permite-lhe introduzir o conteúdo de qualquer ficheiro legível na posição do cursor. Se estiver activo, o menu <guimenu
>Ferramentas</guimenu
> tem uma opção adicional para <guimenuitem
>Inserir um Ficheiro</guimenuitem
>.</para
></listitem>
</varlistentry>
<!-- not build any longer in kde 4.5
<varlistentry>
<term
>Python Encoding check</term>
<listitem
><para
>This plugin is always enabled.  
If you are trying to save a python file as non ASCII, without specifying a 
correct source encoding line like &eg; <quote
># -*- coding: utf-8 -*-</quote
>, 
a warning dialog pops up and allows you to add a proper source encoding line for the
current encoding to the file.
</para
></listitem>
</varlistentry>
-->
</variablelist>
<!--
kdelibs/kate/plugins/ has additional plugins
autobookmark not build, its broken!
timedate not build? plugin is for howto-write-a-plugin purposes!
-->

<!-- Scripts tab ??? empty: Not implemented yet, hidden in 4.4 + 4.7  branch, removed in master bye bye-->
</sect1>

<sect1 id="kate-application-plugins">
<title
>'Plugins' da Aplicação &kate;</title>

<!-- from doc/kate-addons/index.docbook -->
<para
>Os 'plugins' do &kate; são funções adicionais para o editor &kate;. Eles poderão adicionar menus e atalhos extra, assim como extender as funcionalidades do &kate;. Poderá instalar ou desinstalar os que quiser, dentro do &kate;. Abra a janela de configuração do &kate; com a opção <menuchoice
><guimenu
>Configuração</guimenu
><guimenuitem
>Configurar o &kate;...</guimenuitem
></menuchoice
>. Seleccione o <menuchoice
><guimenu
>Aplicação</guimenu
><guimenuitem
>'Plugins'</guimenuitem
></menuchoice
> para escolher os 'plugins' desejados. </para>

<para
>Os 'plugins' de aplicações disponíveis são: </para>
<itemizedlist>
<listitem>
<para
><link linkend="kate-application-plugin-findinfiles"
>Área de ferramentas para procurar nos ficheiros</link
> - uma área que permite procurar em todos os ficheiros abertos ou nos ficheiros do sistema de ficheiros</para>
</listitem>
<listitem>
<para
>GDB - Fornece uma interface simples para o GDB</para>
<!-- GDB Plugin http://kate-editor.org/2011/06/23/kate-plugin-updates-part-2/-->
</listitem>
<listitem>
<para
>Navegador de Registos de Chamadas - área de navegação por uma sequência de chamadas</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-quickswitcher"
>Selector rápido de documentos</link
> - Muda automaticamente para outro documento já aberto</para>
</listitem>
<listitem>
<para
>'Plugin' de SQL - Executa uma pesquisa em bases de dados SQL</para>
</listitem>
<listitem>
<para
>'Plugin' de Pesquisa - Procurar um padrão nos ficheiros</para>
</listitem>
<listitem>
<para
>Barra de Páginas - Adiciona uma barra de páginas normal à janela principal do &kate;</para>
<!--http://kate-editor.org/2011/04/25/kates-tab-bar-plugins/-->
</listitem>
<!--listitem>
<para
>Text Snippets - Configurable Text Snippets</para>
</listitem-->
<listitem>
<para
>Filtro de Texto - Filtragem de texto simples</para>
</listitem>
<listitem>
<para
>Visualizador de Símbolos - Extrair e apresentar símbolos de referência em código-fonte</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-fsbrowser"
>Navegador do sistema de ficheiros</link
> - Ferramenta de navegação no sistema de ficheiros</para>
</listitem>
<listitem>
<para
>Área de terminal - uma janela que incorpora um emulador de terminal</para>
</listitem>
<!--listitem>
<para
>Kate Python Browser Plugin - A Python browser plugin for Kate</para>
</listitem-->
<listitem>
<para
>'Plugin' do CTags -  Procurar definições/declarações com o CTags</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-filetemplate"
>Modelos de Ficheiros</link
> - Criar ficheiros novos a partir de modelos</para>
</listitem>
<listitem>
<para
>Abrir o Ficheiro de Inclusão - Abre o ficheiro .h/[.cpp|.c] correspondente</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-exttools"
>Ferramentas Externas</link
></para>
</listitem>
<listitem>
<para
>'Plugin' de Compilação - Compilar e processar as mensagens de erro</para>
<!-- http://kate-editor.org/2011/06/21/kate-plugin-updates-part-1/ -->
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-mail"
>Enviar os ficheiros por e-mail</link
> - Enviar os ficheiros por e-mail</para>
</listitem>
<listitem>
<para
>Barra de Páginas Multi-Linha - Adiciona uma barra de páginas com várias linhas à janela principal do &kate;</para>
</listitem>
<listitem>
<para
>Excertos do Kate - 'Plugin' de excertos com o suporte de completação do código</para>
</listitem>
<listitem>
<para
>'Plugin' de Texto-para-Fala do Jovie - Adiciona um item de menu para sintetizar o texto</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-xmlcheck"
>Validação de &XML;</link
>- Faz a validação dos ficheiros em &XML; com o 'xmllint'</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-xmltools"
>Completação de &XML;</link
>- Apresenta os elementos de &XML;, os seus atributos, valores e entidades permitidas pela DTD</para>
</listitem>
<listitem>
<para
>Barra de Páginas - Adiciona uma barra de páginas à janela principal do Kate</para>
<!--http://kate-editor.org/2011/04/25/kates-tab-bar-plugins/-->
</listitem>
</itemizedlist>
</sect1>

<!-- from doc/kate-addons/filetemplates.docbook -->
<sect1 id="kate-application-plugin-filetemplate">
<sect1info>
<authorgroup>
<author
>&Anders.Lund; &Anders.Lund.mail;</author>
</authorgroup>
</sect1info>
<title
>Modelos de Ficheiros</title>

  <para
>O 'plugin' de Modelos de Ficheiros permite-lhe criar ficheiros com base noutros ficheiros.</para>
  <para
>Quando instalar o Kate da primeira vez, terá de activar o 'plugin':</para>
  <orderedlist>
        <listitem>
          <para
>Carregue em <menuchoice
><guimenu
>Configuração</guimenu
><guimenuitem
>Configurar o Kate</guimenuitem
></menuchoice
> </para>
        </listitem>
        <listitem>
          <para
>Na árvore à esquerda do ecrã, carregue em <guilabel
>'Plugins'</guilabel
>. </para>
        </listitem>
        <listitem>
          <para
>No painel do <guilabel
>Gestor de 'Plugins'</guilabel
> à direita, seleccione os  <guilabel
>Modelos de Ficheiros</guilabel
> e carregue depois em <guibutton
>OK</guibutton
>. </para>
        </listitem>
   </orderedlist>
  <para
>O 'plugin' de Modelos de Ficheiros permite-lhe criar ficheiros com base noutros (isto cria uma cópia do ficheiro com um &URL; vazio). Os ficheiros de modelos especiais poderão conter macros para preencher informações como o seu nome e endereço de e-mail, a data actual, entre outros, colocando o cursor numa posição conveniente do ficheiro novo.</para>
  <para
>Poderá também criar facilmente um novo modelo a partir de um documento aberto.</para>
  <para
>Os modelos que gravar na pasta de modelos aparecem no item de menu <menuchoice
><guimenu
>Ficheiro</guimenu
><guimenuitem
>Novo a Partir do Modelo</guimenuitem
></menuchoice
>.</para>
  <para
>A pasta de modelos faz parte do sistema de ficheiros do &kde; e consiste em, pelo menos</para>
    <itemizedlist>
      <listitem>
	<para>
	 <filename role="directory"
>$<envar
>KDEDIR</envar
>/share/applications/kate/plugins/katefiletemplates/templates</filename>
	</para>
      </listitem>
      <listitem>
       <para>
        <filename role="directory"
>$<envar
>KDEHOME</envar
>/share/applications/kate/plugins/katefiletemplates/templates.</filename>
	</para>
      </listitem>
    </itemizedlist>
    <para
>Se a sua variável de ambiente <envar
>KDEDIRS</envar
> contiver pastas adicionais, estas são pesquisadas por subpastas semelhantes. Se forem encontrados modelos com o mesmo nome, é escolhido o da pasta local (KDEHOME).</para>
  <sect2 id="katefiletemplates-menu">
    <title
>Estrutura do Menu</title>

    <variablelist>
      <varlistentry>
        <term>
          <menuchoice
><guimenu
>Ficheiro</guimenu
> <guisubmenu
>Novo a Partir do Modelo</guisubmenu
> <guimenuitem
>Qualquer Ficheiro...</guimenuitem
> </menuchoice>
        </term>
        <listitem
><para
>Apresenta-lhe uma janela de Abertura de Ficheiros que lhe permite usar qualquer ficheiro como modelo. Se o ficheiro escolhido tiver a extensão <filename
>katetemplate</filename
>, ele será processado para a informação e as macros do modelo.</para
></listitem>
      </varlistentry>
      <!-- not in 4.4
      <varlistentry>
        <term>
          <menuchoice>
            <guimenu
>File</guimenu>
            <guisubmenu
>New From Template</guisubmenu>
            <guimenuitem
>Use Recent</guimenuitem>
          </menuchoice>
        </term>
        <listitem
><para
>Presents a list of files recently used as
            templates, represented by their &URL;.</para
></listitem>
      </varlistentry>
      -->
      <varlistentry>
        <term>
          <menuchoice
><guimenu
>Ficheiro</guimenu
> <guimenuitem
>Novo a Partir do Modelo</guimenuitem
> </menuchoice>
        </term>
        <listitem
><para
>O resto dos sub-menus contém referências para os modelos. Carregue num item do menu para criar um ficheiro, tal como é descrito pelo texto do item do menu.</para
></listitem>
      </varlistentry>

      <!-- Settings menu -->

      <varlistentry>
        <term>
          <menuchoice
><guimenu
>Configuração</guimenu
><guimenuitem
>Gerir os Modelos</guimenuitem
></menuchoice
></term>
        <listitem
><para
>Isto irá lançar uma janela com uma lista com todos os modelos encontrados nas directorias de modelos, em conjunto com as opções para adicionar, editar ou remover os modelos.</para
></listitem>
      </varlistentry>
    </variablelist>
  </sect2>

  <sect2 id="katefiletemplates-use">
    <title
>Usar um Modelo do &kate;</title>
    <para
>Ao criar um ficheiro a partir de um modelo que contenha macros de modelos, algumas das macros aparecem como variáveis editáveis no texto. Essas variáveis aparecem como palavras sublinhadas no texto.</para>
    <para
>Será seleccionada a primeira variável, como tal só terá de escrever para a editar. Se o texto do documento contiver mais instâncias da mesma variável, podê-las-á alterar à medida que editar. Para mudar para a próxima variável editável, carregue na tecla TAB. Quando for editada a última variável, a lista é fechada e a sua tecla TAB passa a funcionar de forma normal.</para>
  </sect2>

  <sect2 id="katefiletemplates-create">
    <title
>Criar os seus próprios modelos</title>
    <para
>Para criar um modelo novo, use o item <menuchoice
><guimenu
>Configuração</guimenu
> <guimenuitem
>Gerir os Modelos</guimenuitem
></menuchoice
> para lançar a janela de gestão de modelos. Na mesma, carregue em <guibutton
>Novo...</guibutton
> para lançar o Assistente de Modelos de Ficheiros. Ser-lhe-á pedido um ficheiro opcional para transformar num modelo e a configuração dos dados do modelo, para que seja criado um ficheiro para si.</para
> <para
>Em alternativa, você poderá criar um modelo manualmente se adicionar a informação do modelo ao topo de qualquer ficheiro, adicionar o texto, as macros e o marcador da posição do cursor, gravando-o com a extensão <filename
>katetemplate</filename
>.</para>
    <para
>O menu do modelo é actualizado automaticamente se você optou por gravar o seu modelo na directoria respectiva.</para>
  </sect2>

  <sect2 id="katefiletemplates-edit">
    <title
>Editar os modelos</title>
    <para
>Para editar um modelo, use a opção <menuchoice
><guimenu
>Configuração</guimenu
> <guimenuitem
>Gerir os Modelos...</guimenuitem
></menuchoice
>. Seleccione o modelo com que deseja trabalhar e carregue em <guibutton
>Editar...</guibutton
>, para que seja aberto o ficheiro de modelo. Feche a janela, edite o ficheiro de modelo como desejar, grave-o e feche-o. As alterações aos modelos têm efeito imediato e você poderá activar o modelo para testar as suas alterações depois de o gravar.</para>
  </sect2>

  <sect2 id="katefiletemplates-format">
    <title
>O Formato dos Modelos do &kate;</title>
    <para
>Se você usar os ficheiros com a extensão <filename
>katetemplate</filename
>, eles serão processados no que respeita à informação do modelo, das macros e da posição do cursor.</para>

    <sect3 id="katefiletemplates-template-info">
      <title
>Informação do modelo</title>
      <para
>Ao ler o ficheiro, o analisador guarda as linhas que começam com a frase <constant
>katetemplate:</constant
> e procura nelas por informações do modelo no formato NOMEVARIAVEL=VALOR. A primeira linha que não começar por <constant
>katetemplate:</constant
> será aceite como o início do conteúdo do modelo. O VALOR poderá conter qualquer carácter excepto o sinal de igual (=). Os nomes válidos de variáveis são: <variablelist>
          <varlistentry>
            <term
><varname
>Modelo</varname
></term>
            <listitem
><para
>Este é o nome do modelo, mostrado no menu <menuchoice
><guimenu
>Ficheiro</guimenu
><guimenuitem
>A Partir do Modelo</guimenuitem
></menuchoice
>.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><varname
>Group</varname
></term>
            <listitem
><para
>O grupo coloca o modelo dentro de um sub-menu do <menuchoice
><guimenu
>Ficheiro</guimenu
><guimenuitem
>A Partir do Modelo</guimenuitem
></menuchoice
>.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
><varname
>Nome</varname
></term>
            <listitem
><para
>Este é o nome que será atribuído ao documento e mostrado na lista de ficheiros e na barra de título. Se o nome contiver um <userinput
>%N</userinput
>, este será substituído por um número, o qual será incrementado se existir mais do que um documento com o mesmo nome.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><varname
>Highlight</varname
></term>
            <listitem
><para
>O 'plugin' irá tentar configurar o Highlight (realce) para o valor desta variável. O valor deverá ser o nome, tal como consta no menu <menuchoice
><guimenu
>Ferramentas</guimenu
><guimenuitem
>Realce</guimenuitem
> </menuchoice
>.</para>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term
><varname
>Description</varname
></term>
            <listitem
><para
>Um breve descrição informativa do modelo. Este é usado de momento para definir um item O Que É Isto para o item do menu, mas poderá ser usado para mais fins no futuro.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
>Autoria</term>
            <listitem
><para
>Um texto que identifica o autor, por exemplo no formato <userinput
>Nome &lt;endereço de e-mail&gt;</userinput
>. Isto é usado de momento para definir um texto de O Que É Isto para o item do menu, mas poderá ser usado para mais fins no futuro.</para
></listitem>
          </varlistentry>
        </variablelist>
      </para>

    </sect3>

    <sect3 id="katetemplates-macros">
      <title
>Macros dos Modelos</title>

      <para
>Ao processar o conteúdo do modelo, as macros no formato <userinput
>%{NOME}</userinput
> ou <userinput
>${NOME}</userinput
> são expandidas. Se usar o prefixo <userinput
>$</userinput
>, a macro expandida será tratada como uma variável editável, quando for criado um documento a partir do modelo, enquanto que se usar o <userinput
>%</userinput
> não o será, a menos que a expansão seja mal-sucedida.</para>
      <para
>São expandidas as seguintes macros: <variablelist>
          <varlistentry
><term
><literal
>time</literal
></term>
            <listitem
><para
>Expande para a hora actual, no seu formato regional.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><literal
>date</literal
></term>
            <listitem
><para
>Expande para a hora actual, num formato curto.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><literal
>datetime</literal
></term>
            <listitem
><para
>Expande para a data e hora actuais, formatadas como uma cadeia de caracteres de acordo com a sua configuração regional.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><literal
>year</literal
></term>
            <listitem
><para
>O ano actual, como um número de quatro algarismos.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><literal
>month</literal
></term>
            <listitem
><para
>O nome completo do mês actual, de acordo com a sua configuração regional.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
><literal
>day</literal
></term>
            <listitem
><para
>Expande para o dia actual do mês.</para>
            </listitem>
          </varlistentry>
          <varlistentry
><term
><literal
>hostname</literal
></term>
            <listitem
><para
>Expande para o nome do seu computador.</para>
            </listitem>
          </varlistentry>
          <varlistentry
><term
><literal
>index</literal
></term>
            <listitem
><para
>Expande para 'i'.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
><literal
>fullname</literal
></term>
            <listitem
><para
>Expande para o seu nome completo, tal como está definido no seu livro de endereços normal do &kde;.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
><literal
>firstname</literal
></term>
            <listitem
><para
>Expande para o seu primeiro nome, tal como está definido no seu livro de endereços normal do &kde;.</para>
            </listitem>
          </varlistentry>
          <varlistentry
><term
><literal
>lastname</literal
></term>
            <listitem
><para
>Expande para o seu último nome (apelido), tal como está definido no seu livro de endereços do &kde;.</para>
            </listitem>
          </varlistentry>
          <!-- <varlistentry>
            <term
>username</term>
            <listitem
><para
>Expands to your username.</para
></listitem>
          </varlistentry
> -->
          <varlistentry>
            <term
>e-mail</term>
            <listitem
><para
>Expande para o seu endereço de e-mail, tal como está definido no seu livro de endereços normal do &kde;.</para
></listitem>
          </varlistentry>
          <!--<varlistentry>
            <term
>organisation</term>
            <listitem
><para
>This is your organisation, as defined by
                the owner address in your standard KDE
                addressbook.</para
></listitem>
          </varlistentry
>-->
        </variablelist>
      </para>
      <para
>Todas as macros que não estiverem na lista acima serão tratadas como variáveis editáveis, independentemente do prefixo. Se a mesma variável ocorrer várias vezes no modelo, elas poderão ser editadas de uma vez, depois de criar um documento a partir do modelo.</para>
    </sect3>

    <sect3 id="katefiletemplates-cursor">
      <title
>Configurar a posição do cursor</title>
      <para
>A macro especial <userinput
>${cursor}</userinput
> será substituída por uma barra vertical e será adicionada ao fim da lista de variáveis editáveis, independentemente da sua posição no texto.</para>
    </sect3>

  </sect2>
  <sect2>
    <title
>Agradecimentos e Reconhecimentos</title>
    <para
>'Plugin' do &kate; <quote
>Modelos de Ficheiros</quote
> com 'copyright' 2004 de &Anders.Lund; &Anders.Lund.mail;. </para>
    <para
>Documentação copyright 2004 &Anders.Lund;</para>
  </sect2>
</sect1>

<!-- from doc/kate-addons/xmlcheck.docbook -->
<sect1 id="kate-application-plugin-xmlcheck">
<sect1info>
<authorgroup
><author
><firstname
>Daniel</firstname
> <surname
>Naber</surname
> <affiliation
><address
>&Daniel.Naber.mail;</address
></affiliation>
</author
></authorgroup>
</sect1info>

<title
>Validação de &XML;</title>

<para
>Este plugin verifica para consistência e validade de ficheiros &XML;.</para>
<para
>Este plugin verifica o ficheiro actual. Uma lista de avisos e erros aparecerá na parte de baixo do janela principal do &kate;. Pode carregar numa mensagem de erro para saltar para o lugar correspondente no ficheiro. Se o ficheiro tiver um <quote
>DOCTYPE</quote
> o DTD dado com este doctype será utilizado para validar este arquivo. O DTD é esperado numa posição relativa ao ficheiro actual. Isto é, se o doctype se refere ao <quote
>DTD/xhtml1-transitional.dtd</quote
> e o ficheiro é <filename
>/home/pedro/test.xml</filename
> o DTD deve estar localizado em <filename
>/home/pedro/DTD/xhtml1-transitional.dtd</filename
>. No entanto, são também suportados DTDs remotos especificados via http.</para>

<para
>se o arquivo não tiver um doctype ele será verificado para boa formatação.</para>

<para
>Para aprender mais acerca de &XML; consulte as <ulink url="http://www.w3.org/XML/"
> páginas oficiais de &XML; do W3C</ulink
>.</para>

<para
>Internamente, este plugin chama o comando externo <command
>xmllint</command
>, o qual é parte de libxml2. Se este comando não estiver instalado correctamente no seu computador o plugin não funcionará.</para>

<note
><para
>É necessário escrever um arquivo temporário na mesma pasta do arquivo a ser verificado; por esta razão, é necessário que tenha permissões de escrita naquela pasta.</para
></note>

<para
>Para carregar este 'plugin', abra a janela de configuração do &kate; em <menuchoice
><guimenu
>Configuração</guimenu
> <guimenuitem
>Configurar o &kate;...</guimenuitem
></menuchoice
>. Depois, seleccione a opção <guilabel
>Validação de XML</guilabel
> que irá aparecer na secção <guilabel
>Aplicação</guilabel
> / <guilabel
>'Plugins'</guilabel
> e feche a janela. </para>

<sect2 id="xmlcheck-menu">
<title
>Estrutura do Menu</title>

<variablelist>
<varlistentry>
<term>
<menuchoice
><guimenu
>Ferramentas</guimenu
> <guimenuitem
>Validar XML</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Iniciar a verificação, conforme descrito acima.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="xmlcheck-thanks-and-acknowledgements">
<title
>Agradecimentos e Reconhecimentos</title>
<para
>Plugin para o &kate; de <quote
>Validação de XML</quote
> copyright 2002 &Daniel.Naber; &Daniel.Naber.mail;. </para>
<para
>Copyright da Documentação 2002 por &Daniel.Naber;</para>

</sect2>
</sect1>

<sect1 id="kate-application-plugin-xmltools">
<sect1info>
<authorgroup
><author
><firstname
>Daniel</firstname
> <surname
>Naber</surname
> <affiliation
><address
>&Daniel.Naber.mail;</address
></affiliation>
</author
></authorgroup>
</sect1info>
<title
>Completação de &XML;</title>

<para
>Este 'plugin' dá-lhe algumas sugestões sobre o que é permitido numa dada posição de um ficheiro &XML;, de acordo com a DTD do ficheiro. Irá apresentar os elementos, atributos, valores de atributos ou entidades possíveis, dependendo da posição do cursor (&eg; todas as entidades aparecem se o carácter à esquerda do cursor for o <quote
>&amp;</quote
>). Também é possível fechar a marca aberta mais próxima à esquerda.</para>

<para
>A <acronym
>DTD</acronym
> deverá existir no formato &XML;, como é produzido pelo programa em Perl <command
>dtdparse</command
>. Iremos chamar a uma DTD neste formato uma <quote
>meta-DTD</quote
>. São fornecidas algumas meta-DTD's. As mesmas estão instaladas na pasta <filename class="directory"
>$KDEDIR/share/apps/katexmltools/</filename
>, que também é a pasta predefinida quando escolhe a opção <guimenuitem
>Atribuir uma Meta-DTD...</guimenuitem
>. Para produzir as suas próprias meta-DTD's, obtenha o <command
>dtdparse</command
> em <ulink url="http://dtdparse.sourceforge.net"
>http://dtdparse.sourceforge.net</ulink
>.</para>

<sect2 id="xmltools-how-to-use">
<title
>Como Usar</title>

<para
>Inicie o &kate; e abra a janela de configuração em <menuchoice
><guimenu
>Configuração</guimenu
> <guimenuitem
>Configurar o &kate;...</guimenuitem
></menuchoice
>. Depois, seleccione a <guilabel
>Completação de XML</guilabel
> que irá aparecer na secção <guilabel
>Aplicação</guilabel
>/<guilabel
>'Plugins'</guilabel
>, fechando depois a janela. Depois disso, seleccione a opção do menu <menuchoice
><guimenu
>XML</guimenu
><guimenuitem
>Atribuir uma Meta-DTD...</guimenuitem
></menuchoice
>. Se o seu documento não tiver nenhum <quote
>DOCTYPE</quote
> ou se este for desconhecido, terá de seleccionar uma meta-DTD no sistema de ficheiros. Caso contrário, será carregada automaticamente a meta-DTD que corresponder ao DOCTYPE do documento actual.</para>

<para
>Pode agora usar o 'plugin' enquanto escreve o seu texto:</para>

<variablelist>

<varlistentry>
<term
><keycap
>&lt;</keycap
> (tecla 'menor que')</term>
<listitem
><para
>Isto irá despoleta uma lista com os elementos possíveis, a menos que o cursor já esteja dentro de uma marca. Lembre-se que não pode usar isto para inserir o elemento de topo (&eg; <quote
>&lt;html&gt;</quote
>).</para
></listitem>
</varlistentry>

<varlistentry>
<term
><keycap
>&lt;</keycap
><keycap
>/</keycap
> (tecla 'menor que' + barra)</term>
<listitem
><para
>Se introduzir estes caracteres, irá oferecer o fecho do elemento actual (o mais próximo do que se encontra à esquerda do cursor). Carregue em &Enter; para aceitar a sugestão. Ao contrário do item <guimenuitem
>Fechar o Elemento</guimenuitem
>, isto funciona apenas com uma DTD atribuída.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><keycap
>"</keycap
> (tecla de 'aspas')</term>
<listitem
><para
>A tecla de aspas irá despoletar uma lista com os valores possíveis dos atributos (se existirem), caso esteja dentro de uma marca.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><keycap
>&nbsp;</keycap
> (tecla de espaço)</term>
<listitem
><para
>Esta tecla irá despoletar uma lista com os atributos possíveis para o elemento actual, caso esteja dentro de uma marca.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><keycap
>&amp;</keycap
> (tecla de 'e-comercial')</term>
<listitem
><para
>Esta tecla irá despoletar uma lista com as entidades conhecidas.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="xmltools-features-and-limitations">
<title
>Funcionalidades e Limitações</title>

<para
>Poderá testar todas as funções e limitações se carregar o ficheiro <filename
>$KDEDIR/share/apps/katexmltools/testcases.xml</filename
> no &kate; e seguir as instruções descritas.</para>

</sect2>


<sect2 id="xmltools-menu">
<title
>Estrutura do Menu</title>

<variablelist>
<varlistentry>
<term>
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Return</keycap
></keycombo
> </shortcut
> <guimenu
>XML</guimenu
> <guimenuitem
>Inserir um Elemento...</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Isto irá abrir uma janela que lhe permite introduzir um elemento em &XML;. Os caracteres &lt;, &gt; e a marca de fecho serão inseridos automaticamente. Se tiver seleccionado algum texto quando tiver seleccionado este item do menu, o texto seleccionado será rodeado pela marca de abertura e de fecho. A janela também oferece a completação de todos os elementos que poderão ser inseridos na posição actual do cursor, caso tenha atribuído uma meta-DTD com a opção <guimenuitem
>Atribuir uma Meta-DTD...</guimenuitem
>. </para
></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>&lt;</keycap
></keycombo
> </shortcut
> <guimenu
>XML</guimenu
> <guimenuitem
>Fechar o Elemento</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Isto irá procurar no seu texto por uma marca que ainda não tenha sido fechada, fechando-a então ao introduzir a marca de fecho correspondente. A procura começa na posição do cursor e segue para a esquerda. Se não encontrar nenhuma marca aberta, não irá acontecer nada.</para
></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><guimenu
>XML</guimenu
> <guimenuitem
>Atribuir uma Meta-DTD...</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Isto irá indicar ao 'plugin' qual a meta-DTD a usar para o documento actual. Lembre-se que esta associação não será gravada. Terá de a repetir quando iniciar o  &kate; da próxima vez.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="xmltools-thanks-and-acknowledgements">
<title
>Agradecimentos e Reconhecimentos</title>
<para
>Plugin para o &kate; de <quote
>Completação de XML</quote
> com 'copyright' 2002 de &Daniel.Naber; &Daniel.Naber.mail;. </para>
<para
>Versão para o KDE SC 4 com 'copyright' 2010 de Tomáš Trnka</para>
<para
>Documentação com 'copyright' 2001,2002 de &Daniel.Naber;</para>
</sect2>

</sect1>

<sect1 id="kate-application-plugin-quickswitcher">
<!--<sect1info>
<authorgroup
><author>
<firstname
>T.C.</firstname>
<surname
>Hollingsworth</surname>
<affiliation
><address
>tchollingsworth@gmail.com</address
></affiliation>
</author
></authorgroup>
</sect1info
>-->
<title
>Mudança Rápida de Documentos</title>

<sect2 id="quickswitcher-menu">
<title
>Estrutura do Menu</title>

<variablelist>
<varlistentry
> 
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>1</keycap
> </keycombo
></shortcut
><guimenu
>Ir</guimenu
><guimenuitem
>Mudança Rápida</guimenuitem
></menuchoice
></term>
<listitem
><para
>Abre a janela de <guilabel
>Selecção Rápida de Documentos</guilabel
> com um campo de pesquisa e uma lista dos ficheiros aberto. Ao introduzir texto no campo de pesquisa, são pesquisados os nomes e os URL's dos documentos à procura do texto correspondente. Ao introduzir o texto no campo de pesquisa, poderá usar as teclas de cursores <keysym
>Cima</keysym
> e <keysym
>Baixo</keysym
> para navegar pela lista. Se sair da janela com o <guilabel
>OK</guilabel
>, o 'plugin' muda a vista para o documento seleccionado na lista. Isto facilita a mudança de documentos, caso tenha muitos abertos. </para
></listitem>
</varlistentry>
</variablelist>

</sect2>
</sect1>

<sect1 id="kate-editor-plugin-exporter">
<!--<sect1info>
<authorgroup
><author>
<firstname
>T.C.</firstname>
<surname
>Hollingsworth</surname>
<affiliation
><address
>tchollingsworth@gmail.com</address
></affiliation>
</author
></authorgroup>
</sect1info
>-->
<title
>Exportador</title>

<sect2 id="exporter-menu">
<title
>Estrutura do Menu</title>

<variablelist>
<varlistentry>
<term>
<menuchoice
><guimenu
>Ficheiro</guimenu
> <guimenuitem
>Exportar como HTML...</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Exporta o seu ficheiro no formato &HTML;, para que o seu documento possa ser visto como uma página Web. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><guimenu
>Editar</guimenu
> <guimenuitem
>Copiar como HTML...</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Copia o texto seleccionado com realce de sintaxe como um texto em HTML.</para>
</listitem>
</varlistentry>

</variablelist>
</sect2>
</sect1>

<sect1 id="kate-application-plugin-findinfiles">
<!--<sect1info>
<authorgroup
><author>
<firstname
>T.C.</firstname>
<surname
>Hollingsworth</surname>
<affiliation
><address
>tchollingsworth@gmail.com</address
></affiliation>
</author
></authorgroup>
</sect1info
>-->
<title
>Procurar nos Ficheiros</title>

<sect2 id="findinfiles-menu">
<title
>Estrutura do Menu</title>
<variablelist>

<varlistentry>
<term>
<menuchoice
><guimenu
>Editar</guimenu
> <guimenuitem
>Procurar nos Ficheiros...</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Invoca a janela para <guilabel
>Procurar nos Ficheiros</guilabel
>, que lhe permite procurar por texto nos ficheiros de uma pasta.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><guimenu
>Ver</guimenu
><guisubmenu
>Áreas de Ferramentas</guisubmenu
> <guimenuitem
>Mostrar o 'Procurar nos Ficheiros'</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Activa/desactiva a visualização da ferramenta do &kate; para <guilabel
>Procurar nos Ficheiros</guilabel
>. </para>
</listitem>
</varlistentry>

</variablelist>
</sect2>
</sect1>

<sect1 id="kate-application-plugin-mail">
<!--<sect1info>
<authorgroup
><author>
<firstname
>T.C.</firstname>
<surname
>Hollingsworth</surname>
<affiliation
><address
>tchollingsworth@gmail.com</address
></affiliation>
</author
></authorgroup>
</sect1info
>-->
<title
>Enviar os Ficheiros por E-Mail</title>

<sect2 id="mail-menu">
<title
>Estrutura do Menu</title>
<variablelist>

<varlistentry>
<term>
<menuchoice
><guimenu
>Ficheiro</guimenu
> <guimenuitem
>Enviar por E-Mail...</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Abre o seu cliente de e-mail e anexa o ficheiro na mensagem. </para>
</listitem>
</varlistentry>

</variablelist>
</sect2>
</sect1>

<sect1 id="kate-application-plugin-fsbrowser">
<!--<sect1info>
<authorgroup
><author>
<firstname
>T.C.</firstname>
<surname
>Hollingsworth</surname>
<affiliation
><address
>tchollingsworth@gmail.com</address
></affiliation>
</author
></authorgroup>
</sect1info
>-->
<title
>Navegador no Sistema de Ficheiros</title>

<para
>O Navegador do Sistema de Ficheiros é um visualizador de pastas que lhe permite abrir os ficheiros de uma pasta visível na área actual.</para>

<sect2 id="fsbrowser-menu">
<title
>Estrutura do Menu</title>
<variablelist>

<varlistentry>
<term>
<anchor id="view-toolviews-show-fileselector"/>
<menuchoice
><guimenu
>Ver</guimenu
><guisubmenu
>Áreas de Ferramentas</guisubmenu
> <guimenuitem
>Mostrar o Navegador do Sistema de Ficheiros</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Activa/desactiva a visualização do Navegador do Sistema de Ficheiros do &kate;</para>
</listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="fsbrowser-interface">
<title
>Interface</title>

<para
>De cima para baixo, o Navegador do Sistema de Ficheiros consiste nos seguintes elementos:</para>

<variablelist>
<varlistentry>
<term
>Uma Barra de Ferramentas</term>
<listitem>
<para
>Esta contém os botões de navegação comuns:</para>
<variablelist>
<varlistentry>
<term
><guibutton
>Recuar</guibutton
></term>
<listitem
><para
>Faz com que a área de pastas faça um <command
>cd</command
> para a pasta anteriormente apresentada no histórico. Este botão está desactivado caso não exista nenhum item anterior.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guibutton
>Avançar</guibutton
></term>
<listitem
><para
>Faz com que a área de pastas faça um <command
>cd</command
> para a pasta seguinte apresentada no histórico. Este botão está desactivado caso não exista nenhum item posterior.</para
></listitem>
</varlistentry>
<!--varlistentry>
<term
><guibutton
>Parent Folder</guibutton
></term>
<listitem
><para
>This will cause the folder view to <command
>cd</command
> to the immediate parent of the currently displayed
folder if possible.</para
></listitem>
</varlistentry-->
<varlistentry>
<term
><guibutton
>Favoritos</guibutton
></term>
<listitem
><para
>Abre um submenu para editar ou adicionar favoritos, bem como para adicionar uma nova pasta de favoritos.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guibutton
>Pasta Actual do Documento</guibutton
></term>
<listitem
><para
>Este botão fará com que a área de pastas faça um <command
>cd</command
> para a pasta do documento activo de momento, se possível. Este botão está desactivado se o documento activo for um ficheiro novo e não-gravado ou se a pasta onde reside não puder ser acedida.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guibutton
>Opções</guibutton
></term>
<listitem>
<variablelist>
<varlistentry>
<term
><guimenuitem
>Vista Abreviada</guimenuitem
></term>
<listitem
><para
>Mostra apenas os nomes dos ficheiros.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guimenuitem
>Vista Detalhada</guimenuitem
></term>
<listitem
><para
>Mostra o <guilabel
>Nome</guilabel
>, a <guilabel
>Data</guilabel
>, o <guilabel
>Tamanho</guilabel
> e o <guilabel
>Tipo</guilabel
> dos ficheiros.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guimenuitem
>Vista em Árvore</guimenuitem
></term>
<listitem
><para
>Como a Vista Curta, só que poderá expandir as pastas para ver o seu conteúdo.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guimenuitem
>Árvore Detalhada</guimenuitem
></term>
<listitem
><para
>Isto também permite expandir as pastas, mas mostra as colunas adicionais que estão disponíveis na Vista Detalhada.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guimenuitem
>Mostrar os Ficheiros Escondidos</guimenuitem
></term>
<listitem
><para
>Mostra os ficheiros normalmente escondidos pelo seu sistema operativo.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guimenuitem
>Sincronizar automaticamente com o documento actual</guimenuitem
></term>
<listitem
><para
>Quando esta opção estiver activa, o navegador do sistema de ficheiros fará um <command
>cd</command
> automático para a pasta do documento aberto de momento na área de edição, sempre que esta alterar.</para
></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term
>Um Item de Localização</term>
<listitem>
<para
>Isto mostra a navegação pelas pastas constituintes da localização completa da pasta aberta de momento, como no &dolphin;. Poderá carregar em qualquer pasta para navegar para dentro dela ou carregar numa das setas para seleccionar qualquer pasta abaixo dela. Seleccione a primeira seta para escolher dentro da sua lista de Locais.</para>
<para
>Poderá também carregar à direita da área de navegação para que esta mude para um campo de texto, no qual poderá escrever a localização da pasta a navegar. O item do &URL; mantém uma lista com as localizações escritas anteriormente. Para escolher uma, use o botão da seta à direita do campo.</para>
<tip
><para
>O item do &URL; tem activada a completação automática das pastas. O método de completação pode ser definido com o menu do &RMB; do campo de texto.</para
></tip>
</listitem>
</varlistentry>

<varlistentry>
<term
>Uma Área de Pastas</term>
<listitem
><para
>Esta é uma área de pastas normal do &kde;.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Um Item de Filtragem</term>
<listitem>
<para
>O campo do Filtro permite-lhe indicar um filtro para os ficheiros apresentados na área de pastas. O filtro usa padrões globais normais, separados por espaços em branco. Exemplo: <userinput
>*.cpp *.h *.moc</userinput
></para>
<para
>Para mostrar todos os ficheiros, indique um simples asterisco <userinput
>*</userinput
>.</para>
<para
>O campo do filtro grava os últimos 10 filtros introduzidos entre sessões. Para usar um, carregue no botão de setas à direita do campo e seleccione o filtro desejado. Poderá desactivar o filtro se carregar no botão <guibutton
>Limpar o texto</guibutton
> à esquerda do botão de auto-completação.</para>
</listitem>
</varlistentry>

</variablelist>
</sect2>


<sect2 id="fsbrowser-config">
<title
>Configuração</title>

<para
>Este 'plugin' pode ser configurado na página do <guilabel
>Navegador do Sistema de Ficheiros</guilabel
> da <link linkend="configuring-kate-configdialog"
>configuração do &kate;</link
>.</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Barra de Ferramentas</guilabel
></term>
<listitem
><para
>Configure os botões da barra do navegador, movendo os que deseja activar para a lista de <guilabel
>Acções Seleccionadas</guilabel
>, ordenando-os com os botões das setas ao lado da lista.</para>
 </listitem>
</varlistentry>

</variablelist>
</sect2>
</sect1>

<!--some material from mdi.docbook needs to be migrated here too-->
<sect1 id="kate-application-plugin-exttools">
<!--<sect1info>
<authorgroup
><author>
<firstname
>T.C.</firstname>
<surname
>Hollingsworth</surname>
<affiliation
><address
>tchollingsworth@gmail.com</address
></affiliation>
</author
></authorgroup>
</sect1info
>-->
<title
>Ferramentas Externas</title>

<para
>No menu <guimenu
>Ferramentas</guimenu
>, irá encontrar um submenu chamado <guisubmenu
>Ferramentas Externas</guisubmenu
>, se as tiver activado na configuração do  &kate;. Estas ferramentas invocam aplicações externas com dados relacionados com o documento actual, como por exemplo o seu URL, pasta, texto ou selecção.</para>

<para
>As ferramentas externas são definidas pelo utilizador; poderá adicionar, editar ou remover ferramentas com o painel de configuração das <link linkend="exttools-config"
>Ferramentas Externas</link
>. </para>

<sect2 id="exttools-menu">
<title
>Estrutura do Menu</title>
<variablelist>

<varlistentry>
<term
><menuchoice
><guimenu
>Ferramentas</guimenu
><guisubmenu
>Ferramentas Externas</guisubmenu
></menuchoice
></term>
<listitem
><para
>Este submenu contém todas as ferramentas externas que tiver configurado.</para
></listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="exttools-config">
<title
>Configuração</title>

<para
>As ferramentas externas são configuradas na página <guilabel
>Ferramentas Externas</guilabel
> da <link linkend="configuring-kate-configdialog"
>configuração do &kate;</link
>. Estas ferramentas invocam as 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 novas.</para>

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

<variablelist>
<title
>Comandos Disponíveis</title>

<varlistentry>
<term
><guibutton
>Novo</guibutton
></term>
<listitem
><para
>Adiciona uma nova ferramenta externa à lista. Isto irá invocar a folha de propriedades descrita abaixo, onde poderá configurar uma ferramenta externa.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Editar</guibutton
></term>
<listitem
><para
>Edita a ferramenta externa seleccionada de momento, usando a folha de propriedades descrita em baixo.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Inserir um Separador</guibutton
></term>
<listitem
><para
>Adiciona uma linha separadora que aparece no menu por baixo do item seleccionado de momento.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Cima</guibutton
></term>
<listitem
><para
>Sobe o item seleccionado de momento para cima do anterior.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Baixo</guibutton
></term>
<listitem
><para
>Desce o item seleccionado de momento para baixo do anterior.</para
></listitem>
</varlistentry>

</variablelist>

<variablelist>
<title
>Propriedades das Ferramentas Externas</title>
<varlistentry>
<term
><guilabel
>Legenda</guilabel
></term>
<listitem
><para
>Uma legenda amigável que irá aparecer no menu de <guisubmenu
>Ferramentas Externas</guisubmenu
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Ícone</guibutton
></term>
<listitem
><para
>Permite-lhe seleccionar o ícone que aparece ao lado da legenda no menu de <guisubmenu
>Ferramentas Externas</guisubmenu
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Programa</guilabel
></term>
<listitem
><para
>O programa a executar quando activar a ferramenta. Antes de passar o comando à consola, são substituídas as seguintes macros: <variablelist>
<varlistentry>
<term
><userinput
>%URL</userinput
></term>
<listitem
><para
>O URL completo do documento actual ou um texto vazio, caso o documento não tenha sido gravado.</para
></listitem>
</varlistentry>

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

<varlistentry>
<term
><userinput
>%directory</userinput
></term>
<listitem
><para
>A componente da pasta do URL do documento actual, ou um texto vazio, caso o documento actual não esteja gravado.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%filename</userinput
></term>
<listitem
><para
>O nome do ficheiro do documento actual sem a localização, ou um texto vazio, caso o documento actual não esteja gravado.</para
></listitem>
</varlistentry>

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

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

<varlistentry>
<term
><userinput
>%selection</userinput
></term>
<listitem
><para
>O texto seleccionado no documento actual, ou um texto vazio, caso não esteja seleccionado nenhum texto</para
></listitem>
</varlistentry>

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

</variablelist>

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

<varlistentry>
<term
><guilabel
>Executável</guilabel
></term>
<listitem
><para
>O executável principal do programa. Isto é obrigatório e é usado para testar se o comando pode ser executado de todo. É permitida uma localização completa, no caso de o seu executável não se encontrar incluído na sua variável de ambiente <envar
>PATH</envar
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Tipos MIME</guilabel
></term>
<listitem
><para
>Uma lista, separada por ponto-e-vírgula, dos tipos MIME que deverão estar activos para este comando.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Gravar</guilabel
></term>
<listitem
><para
>Poderá 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
><guilabel
>Nome da linha de comandos</guilabel
></term>
<listitem
><para
>Se preencher isto, a ferramenta ficará disponível na <link linkend="advanced-editing-tools-commandline"
>linha de comandos do editor</link
> como <command
>exttool-<replaceable
>Nome da Linha de Comandos</replaceable
></command
> (o texto que indicar aqui, antecedido de <quote
>exttool-</quote
>).</para
></listitem>
</varlistentry>

</variablelist>
</sect2>
</sect1>

<!--
Missing (according to config docs)
Additional pages for enabled plugins: 
Kate Snippets
Backtrace Browser
Symbol Viewer
-->
</chapter>
