<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
><guilabel
>Exportação</guilabel
></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
>Codificação louca (não ZEN) de HTML (edição leve)</guilabel
></term>
<listitem
><para
>A plugin, which does zen-coding like selector completion.</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>
<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-->
</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
>Área de ferramentas para procurar nos ficheiros - uma área que permite procurar em todos os ficheiros abertos ou nos ficheiros do sistema de ficheiros</para>
</listitem>
<listitem>
<para
>Navegador de Registos de Chamadas - área de navegação por uma sequência de chamadas</para>
</listitem>
<listitem>
<para
>Selector rápido de documentos - Muda automaticamente para outro documento já aberto</para>
</listitem>
<listitem>
<para
>Barra de Páginas - Adiciona uma barra de páginas à janela principal do &kate;</para>
</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
>Navegador do sistema de ficheiros - Uma ferramenta de navegação pelo 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
>Ferramentas Externas</para>
</listitem>
<listitem>
<para
>'Plugin' de Compilação - Compilar e processar as mensagens de erro</para>
</listitem>
<listitem>
<para
>Enviar os ficheiros por e-mail - Envia os ficheiros por e-mail</para>
</listitem>
<listitem>
<para
>Excertos do Kate - 'Plugin' de excertos com o suporte de completação do código</para>
</listitem>
<listitem>
<para
>KTextEditor KTTSD Plugin - Adds a menu entry for speaking the text</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>
</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
>time</term>
            <listitem
><para
>Expande para a hora actual, no seu formato regional.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
>date</term>
            <listitem
><para
>Expande para a hora actual, num formato curto.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
>datetime</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
>year</term>
            <listitem
><para
>O ano actual, como um número de quatro algarismos.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
>month</term>
            <listitem
><para
>O nome completo do mês actual, de acordo com a sua configuração regional.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
>day</term>
            <listitem
><para
>Expande para o dia actual do mês.</para>
            </listitem>
          </varlistentry>
          <varlistentry
><term
>hostname</term>
            <listitem
><para
>Expande para o nome do seu computador.</para>
            </listitem>
          </varlistentry>
          <varlistentry
><term
>index</term>
            <listitem
><para
>Expande para 'i'.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
>fullname</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
>firstname</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
>lastname</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>

</chapter>
