<chapter id="plugins">

<chapterinfo>
<authorgroup>
<author
>&Anders.Lund; &Anders.Lund.mail;</author>
<othercredit role="translator"
><firstname
>Lisiane</firstname
><surname
>Sztoltz</surname
><affiliation
><address
><email
>lisiane@conectiva.com.br</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
> 
</authorgroup>
</chapterinfo>

<title
>Trabalhando com plugins</title>

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

<para
>Você poderá ativar 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 delas.</para>

<para
>Existem vários plugins para vários fins e você poderá procurar mais na Web. Alguns plugins são fornecidos com o componente de edição, para fazer inserção automática de parênteses, inserções de arquivos, ferramentas de dados e exportação de 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
> da seção <guilabel
>Extensões</guilabel
> lista todos os plugins disponíveis e você poderá assinalar os que deseja usar. Clique no botão <guibutton
>Informações</guibutton
> para abrir a janela <guilabel
>Sobre</guilabel
> do referido plugin.</para>
<para
>Uma vez que um plug-in configurável esteja marcado, o botão <guibutton
>Configurar</guibutton
> fica habilitado para que se possa clicar nele, de modo a configurar o plug-in realçado.</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Parênteses automático</guilabel
></term>
<listitem
><para
>O plug-in de parênteses automático sobrepõe-se ao recurso interno do &kate; de <quote
>Parênteses automático</quote
>. Ele automaticamente insere um parênteses de fechamento <keycap
>}</keycap
> no início da próxima linha após terminar uma linha com um parênteses de abertura <keycap
>{</keycap
> e pressionar o &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
>Ativa as ferramentas de dados, como a verificação gramatical e ortográfica (se estiverem instaladas). As ferramentas de dados só ficam disponíveis quando tem texto é selecionado, ou quando o botão direito do mouse é clicado sobre uma palavra. Se não existirem ferramentas de dados disponíveis, mesmo quando selecionar algum texto, você terá que instalá-las. Algumas ferramentas de dados fazem parte do pacote &koffice;. Se este plugin estiver ativo e se as ferramentas de dados estiverem instaladas, 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 que você exporte o documento atual com todas as informações realçadas em um documento HTML usando o<menuchoice
><guimenu
>Arquivo</guimenu
><guimenuitem
>Exportar como HTML</guimenuitem
></menuchoice
>. Adicionalmente você pode usar o <menuchoice
><guimenu
>Editar</guimenu
> <guimenuitem
>Copiar como HTML</guimenuitem
></menuchoice
> para copiar o texto atualmente selecionado 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 somente é usado por desenvolvedores do &kde;. Ele adiciona um item <guimenuitem
>Inserir código do KIcon</guimenuitem
> no menu de contexto do editor. Se ativado, o seletor de ícones do &kde; é aberto (mostrando ícones de aplicações, de ações, &etc;...). Se você clicar nele, o nome do arquivo sem extensão será inserido como texto. Isto é útil somente para definir ícones usando a infraestrutura do &kde; através da classe KIcon(). </para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Codificação insana (não ZEN) de HTML (edição leve)</guilabel
></term>
<listitem
><para
>Um plugin que faz uma codificação Zen como um seletor de completamento. 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 arquivo</guilabel
></term>
<listitem
><para
>Este plugin permite que você insira qualquer arquivo legível na posição do cursor. Se ativado, o menu <guimenu
>Ferramentas</guimenu
> possui um item adicional <guimenuitem
>Inserir arquivo</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 do aplicativo &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 estender as funcionalidades do &kate;. Você 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ções</guimenu
><guimenuitem
>Configurar o &kate;...</guimenuitem
></menuchoice
>. Selecione o <menuchoice
><guimenu
>Aplicativo</guimenu
><guimenuitem
>Plugins</guimenuitem
></menuchoice
> para escolher os plugins desejados. </para>

<para
>O plugins do aplicativo disponíveis são: </para>
<itemizedlist>
<listitem>
<para
><link linkend="kate-application-plugin-findinfiles"
>Área de ferramenta para procura nos arquivos</link
> - Uma área que lhe permite procurar em todos os arquivos abertos ou no sistema de arquivos</para>
</listitem>
<listitem>
<para
>GDB - Oferece uma interface simples do GDB</para>
<!-- GDB Plugin http://kate-editor.org/2011/06/23/kate-plugin-updates-part-2/-->
</listitem>
<listitem>
<para
>Navegador de estouros - Janela da ferramenta de navegação dos estouros</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-quickswitcher"
>Mudança rápida de documento</link
> - Muda rapidamente para outro documento já aberto</para>
</listitem>
<listitem>
<para
>Plugin SQL - Executar uma pesquisa em bases de dados SQL</para>
</listitem>
<listitem>
<para
>Plugin de pesquisa - Procura um padrão nos arquivos</para>
</listitem>
<listitem>
<para
>Barra de páginas - Adiciona uma barra de páginas padrão à 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 simples de texto</para>
</listitem>
<listitem>
<para
>Visualizador de símbolos - Extrair e mostrar os símbolos de referência do código</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-fsbrowser"
>Navegador do sistema de arquivos</link
> - Ferramenta de navegação no sistema de arquivos</para>
</listitem>
<listitem>
<para
>Área de ferramentas do console - Área de ferramentas que incorpora um console</para>
</listitem>
<!--listitem>
<para
>Kate Python Browser Plugin - A Python browser plugin for Kate</para>
</listitem-->
<listitem>
<para
>Plugin CTags - Procurar definições/declarações com o CTags</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-filetemplate"
>Modelos de arquivo</link
> - Cria novos arquivos a partir de modelos</para>
</listitem>
<listitem>
<para
>Abrir cabeçalho - Abre o arquivo .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 - Compila ou executa o Make e processa 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 arquivos</link
> - Enviar os arquivos por e-mail</para>
</listitem>
<listitem>
<para
>Barra de abas multilinha - Adiciona uma barra de abas com várias linhas à janela principal do &kate;</para>
</listitem>
<listitem>
<para
>Trechos do Kate - Plugin de trechos com suporte a completamento de código</para>
</listitem>
<listitem>
<para
>Plugin de Texto-para-Fala do Jovie - Adiciona um item de meu para falar o texto</para>
</listitem>
<listitem>
<para
>O <link linkend="kate-application-plugin-xmlcheck"
>Validação do &XML;</link
> valida arquivos &XML; usando o xmllint</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-xmltools"
>Completamento de &XML;</link
>- Apresenta os elementos de &XML;, os seus atributos, valores e entidades permitidas pela DTD</para>
</listitem>
<listitem>
<para
>Tabulação - 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 Arquivos</title>

  <para
>O plugin de Modelos de Arquivos permite-lhe criar arquivos com base em outros arquivos.</para>
  <para
>Quando instalar o Kate da primeira vez, você terá que ativar o plugin:</para>
  <orderedlist>
        <listitem>
          <para
>Clique em <menuchoice
><guimenu
>Configurações</guimenu
><guimenuitem
>Configurar o Kate</guimenuitem
></menuchoice
> </para>
        </listitem>
        <listitem>
          <para
>Na árvore à esquerda da tela, clique em <guilabel
>Plugins</guilabel
>. </para>
        </listitem>
        <listitem>
          <para
>No painel do <guilabel
>Gerenciador de Plugins</guilabel
> à direita, selecione os <guilabel
>Modelos de Arquivos</guilabel
> e clique depois em <guibutton
>OK</guibutton
>. </para>
        </listitem>
   </orderedlist>
  <para
>Você pode agora usar qualquer arquivo como modelo (isto cria uma cópia do arquivo com um &URL; vazio). Os arquivos de modelos especiais poderão conter macros para preencher informações como o seu nome e endereço de e-mail, a data atual, entre outros, colocando o cursor numa posição conveniente do arquivo novo.</para>
  <para
>Você pode criar facilmente um novo modelo a partir de um documento aberto.</para>
  <para
>Os modelos que você salvar na pasta de modelos aparecem no item de menu <menuchoice
><guimenu
>Arquivo</guimenu
><guimenuitem
>Novo a partir do modelo</guimenuitem
></menuchoice
>.</para>
  <para
>A pasta de modelos faz parte do sistema de arquivos 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, elas 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
>Arquivo</guimenu
> <guisubmenu
>Novo a Partir do Modelo</guisubmenu
> <guimenuitem
>Qualquer Arquivo...</guimenuitem
> </menuchoice>
        </term>
        <listitem
><para
>Apresente o diálogo para Abrir Arquivo que permite usar qualquer arquivo como um modelo. Se o arquivo escolhido tiver a extensão <filename
>katetemplate</filename
> ele será analisado por informações e 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
>Arquivo</guimenu
> <guimenuitem
>Novo a Partir do Modelo</guimenuitem
> </menuchoice>
        </term>
        <listitem
><para
>O lembrador de submenus contém os links para modelos. Clique em um item de menu para criar um arquivo como descrito pelo texto do item de menu.</para
></listitem>
      </varlistentry>

      <!-- Settings menu -->

      <varlistentry>
        <term>
          <menuchoice
><guimenu
>Configurações</guimenu
><guimenuitem
>Gerenciar Modelos...</guimenuitem
></menuchoice
></term>
        <listitem
><para
>Isto lançará um diálogo com uma lista de todos os modelos encontrados nos diretórios de modelos, junto com opções para adicionar, editar ou remover modelos.</para
></listitem>
      </varlistentry>
    </variablelist>
  </sect2>

  <sect2 id="katefiletemplates-use">
    <title
>Usando um Modelo do &kate;</title>
    <para
>Ao criar um arquivo a partir de um modelo que contenha macros, alguns macros aparecerão como variáveis editáveis no texto. Como variáveis, eles aparecem como palavras sublinhadas no texto.</para>
    <para
>A primeira variável será selecionada, assim que você tenha digitado para editá-la. Se o texto do documento contiver mais de uma instância da mesma variável, elas serão mudadas assim que você editar a primeira. Para mover para a próxima variável editável, pressione a tecla TAB. Quando a última variável tiver sido editada, a lista é descartada, e sua tecla TAB voltará a funcionar normalmente.</para>
  </sect2>

  <sect2 id="katefiletemplates-create">
    <title
>Criando seus próprios modelos</title>
    <para
>Para criar um novo modelo, use o item <menuchoice
><guimenu
>Configurações</guimenu
><guimenuitem
>Gerenciar Modelos</guimenuitem
></menuchoice
> para lançar o diálogo de gerenciamento de modelo. Neste diálogo, clique em <guibutton
>Novo...</guibutton
> para lançar o Assistente de Modelo de Arquivo. Você será questionado por um arquivo opcional para tornar-se um modelo e por configurações de informações do modelo, criando assim um arquivo de modelo para você.</para
> <para
>Alternativamente, você pode criar um modelo manualmente adicionando informações do modelo no topo de qualquer arquivo, adicionando texto e macros, e salvando-o com a extensão <filename
>katetemplate</filename
>.</para>
    <para
>O menu de modelo será automaticamente atualizado se você escolher armazenar seu modelo no diretório de modelos.</para>
  </sect2>

  <sect2 id="katefiletemplates-edit">
    <title
>Editando modelos</title>
    <para
>Para editar um modelo, use o <menuchoice
><guimenu
>Configurações</guimenu
> <guimenuitem
>Gerenciar Modelos...</guimenuitem
></menuchoice
>. Selecione o modelo que você deseja editar e clique em <guibutton
>Editar...</guibutton
>, e o arquivo de modelo será aberto. Feche o diálogo, edite o arquivo de modelo como desejar, salve-o e feche-o. As mudanças para os modelos terão efeito imediatamente, e você pode ativar o modelo para testar suas mudanças após salvá-lo.</para>
  </sect2>

  <sect2 id="katefiletemplates-format">
    <title
>O Formato de Modelo do &kate;</title>
    <para
>Se você usar arquivos com extensão <filename
>katetemplate</filename
>, eles serão analisados por informações de modelo, macros e uma posição do cursor.</para>

    <sect3 id="katefiletemplates-template-info">
      <title
>Informações do modelo</title>
      <para
>Ao ler um arquivo, o analisador mantém as linhas que iniciam com a frase <constant
>katetemplate:</constant
> e procura nelas por informações do modelo no formato NOMEDAVARIAVEL=VALOR. A primeira linha que não iniciar com <constant
>katetemplate:</constant
> será tomada como inicial do conteúdo do modelo. VALOR pode conter qualquer caracter menos o sinal de igual (=). Nomes de variáveis válidos são: <variablelist>
          <varlistentry>
            <term
><varname
>Modelo</varname
></term>
            <listitem
><para
>Este é o nome do modelo, exibido no menu <menuchoice
><guimenu
>Arquivo</guimenu
><guimenuitem
>Novo A Partir do Modelo</guimenuitem
></menuchoice
>.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><varname
>Group</varname
></term>
            <listitem
><para
>O grupo de lugares do modelo no submenu do menu <menuchoice
><guimenu
>Arquivo</guimenu
><guimenuitem
>Novo A Partir do Modelo</guimenuitem
></menuchoice
>.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
><varname
>Nome</varname
></term>
            <listitem
><para
>Este é o nome que será configurado para o documento, e exibido na lista de arquivos e barra de título. Se o nome contiver <userinput
>%N</userinput
> isto será substituído com um número, aumentado se mais documentos tiverem o mesmo nome.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><varname
>Highlight</varname
></term>
            <listitem
><para
>O plug-in tentará configurar o Destaque do novo documento para o valor desta variável. O valor deve ser o nome, como encontrado em <menuchoice
><guimenu
>Ferramentas</guimenu
><guimenuitem
>Destaque</guimenuitem
> </menuchoice
>.</para>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term
><varname
>Description</varname
></term>
            <listitem
><para
>Uma descrição informativa curta do modelo. Isto é atualmente usado para configurar um string 'O Que É Isto?' para o item de menu, mas pode ser usado para outras finalidades no futuro.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
>Autor</term>
            <listitem
><para
>Um string identificando o autor, por exemplo na forma <userinput
>Nome &lt;endereço de email&gt;</userinput
>. Isto é atualmente usado para configurar um string 'O Quê É Isto?' para o item de menu, mas pode ser usado para outras finalidades no futuro.</para
></listitem>
          </varlistentry>
        </variablelist>
      </para>

    </sect3>

    <sect3 id="katetemplates-macros">
      <title
>Macros do modelo</title>

      <para
>Ao analisar o conteúdo do modelo, macros na forma <userinput
>%{NOME}</userinput
> ou <userinput
>${NOME}</userinput
> são expandidos. Se você usar o prefixo <userinput
>$</userinput
>, o macro expandido será tratado como uma variável editável quando um documento é criado a partir do modelo, enquanto se você usar o <userinput
>%</userinput
> ele não é, a menos que a expansão falhe.</para>
      <para
>Os seguintes macros são expandidos: <variablelist>
          <varlistentry
><term
><literal
>time</literal
></term>
            <listitem
><para
>Expande para a hora atual no seu formato local.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><literal
>data</literal
></term>
            <listitem
><para
>Expande para a data atual no formato reduzido.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><literal
>datahora</literal
></term>
            <listitem
><para
>Expande para a data e hora atual formatado como um string de acordo com seu local.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><literal
>ano</literal
></term>
            <listitem
><para
>O ano atual como um número de quatro dígitos.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><literal
>mês</literal
></term>
            <listitem
><para
>O nome completo do mês atual, de acordo com seu local.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
><literal
>dia</literal
></term>
            <listitem
><para
>Expande para o dia atual do mês.</para>
            </listitem>
          </varlistentry>
          <varlistentry
><term
><literal
>hostname</literal
></term>
            <listitem
><para
>Expande para o 'nome de máquina' do seu computador.</para>
            </listitem>
          </varlistentry>
          <varlistentry
><term
><literal
>índice</literal
></term>
            <listitem
><para
>Expande para 'i'.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
><literal
>fullname</literal
></term>
            <listitem
><para
>Expande para seu nome completo, como definido pelo endereço do dono em seu livro de endereços padrão do &kde;.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
><literal
>nome</literal
></term>
            <listitem
><para
>Expande para seu primeiro nome, como definido pelo endereço do dono em seu livro de endereços padrão do &kde;.</para>
            </listitem>
          </varlistentry>
          <varlistentry
><term
><literal
>lastname</literal
></term>
            <listitem
><para
>Expande para seu último nome, como definido pelo endereço do dono em seu livro de endereços padrão 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 seu endereço eletrônico, como definido pelo endereço do dono em seu livro de endereços padrão 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
>Qualquer macro que não esteja na lista acima é tratado como uma variável editável independente do prefixo. Se a mesma variável aparecer várias vezes no modelo, elas podem ser editadas de uma vez após criar um documento a partir do modelo.</para>
    </sect3>

    <sect3 id="katefiletemplates-cursor">
      <title
>Configurando a posição do cursor</title>
      <para
>O macro especial <userinput
>${cursor}</userinput
> será substituído com uma barra vertical e adicionado ao final da lista de variáveis editáveis, independente de sua localização no texto.</para>
    </sect3>

  </sect2>
  <sect2>
    <title
>Agradecimentos e Reconhecimentos</title>
    <para
>Plug-in <quote
>Modelos de arquivo</quote
> &kate; com direitos autorais 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 &XML;</title>

<para
>Este plug-in verifica arquivos &XML; para consistência e validação.</para>
<para
>Este plug-in verifica o arquivo atual. Uma lista de avisos e erros aparecerá na parte de baixo do janela principal do &kate;. Você pode clicar em uma mensagem de erro para pular para o lugar correspondente no arquivo. Se o arquivo tiver um <quote
>DOCTYPE</quote
> o DTD dado com este doctype será usado para validar este arquivo. O DTD é esperado em uma posição relativa ao arquivo atual. &eg;, se o doctype se refere ao <quote
>DTD/xhtml1-transitional.dtd</quote
> e o arquivo é <filename
>/home/peter/test/xml</filename
> o DTD deve estar localizado em <filename
>/home/peter/DTD/xhtml1-transitional.dtd</filename
>. De qualquer modo, DTDs remotos especificados via http são suportados.</para>

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

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

<para
>Internamente, este plug-in chama o comando externo <command
>xmllint</command
>, o qual é parte de libxml2. Se este comando não está instalado corretamente em seu sistema, o plug-in não funcionará.</para>

<note
><para
>Um arquivo temporário precisa ser escrito na mesma pasta do arquivo a ser verificado, e assim, você deve ter acesso de escrita para aquela pasta.</para
></note>

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

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

<variablelist>
<varlistentry>
<term>
<menuchoice
><guimenu
>XML</guimenu
> <guimenuitem
>Validar XML</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Isto iniciará a checagem, conforme descrito acima.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="xmlcheck-thanks-and-acknowledgements">
<title
>Agradecimentos e Reconhecimentos</title>
<para
>Plug-in 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
>Completamento &XML;</title>

<para
>Este plug-in dá pistas sobre o que é permitido em determinada posição de um arquivo &XML;, de acordo com o DTD do arquivo. Ele lista elementos, atributos, valores de atributos ou entidades válidas, dependendo da posição do cursor (&eg;, todas as entidades são mostradas se o caracter à esquerda do cursor for <quote
>&amp;</quote
>). Também é possível fechar a marca aberta mais próxima à esquerda.</para>

<para
>O <acronym
>DTD</acronym
> deve existir em formato &XML;, como produzido pelo programa Perl <command
>dtdparse</command
>. Chamaremos um DTD neste formato de <quote
>meta DTD</quote
>. Alguns meta DTDs são fornecidos. Eles estão instalados em <filename class="directory"
>$KDEDIR/share/apps/katexmltools/</filename
>, que também é a pasta padrão quando você escolhe <guimenuitem
>Designar Meta DTD...</guimenuitem
>. Para produzir seus próprios meta DTDs, baixe 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ções</guimenu
> <guimenuitem
>Configurar o &kate;...</guimenuitem
></menuchoice
>. Depois, selecione o <guilabel
>Completamento de XML</guilabel
> que irá aparecer na seção <guilabel
>Aplicação</guilabel
>/<guilabel
>Plugins</guilabel
>, fechando depois a janela. Depois disso, selecione 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 ele for desconhecido, você terá que selecionar uma meta-DTD no sistema de arquivos. Caso contrário, será carregada automaticamente a meta-DTD que corresponder ao DOCTYPE do documento atual.</para>

<para
>Você pode agora usar o plug-in enquanto digita seu texto:</para>

<variablelist>

<varlistentry>
<term
><keycap
>&lt;</keycap
> (chave menor que)</term>
<listitem
><para
>Isto disparará uma lista dos elementos possíveis a menos que o cursor esteja já dentro de uma tag. Note que você atualmente não pode usar isto para inserir os elementos de nível mais alto (&eg; <quote
>&lt;html&gt;</quote
>).</para
></listitem>
</varlistentry>

<varlistentry>
<term
><keycap
>&lt;</keycap
><keycap
>/</keycap
> (tecla 'menor que' + barra)</term>
<listitem
><para
>Inserir estes caracteres irá oferecer o fecho do elemento atual (o mais próximo do que se encontra à esquerda do cursor). Pressione &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
> (chave de citação)</term>
<listitem
><para
>A chave de citação disparará uma lista dos valores de atributos possíveis (se existirem) se você estiver dentro de uma tag.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><keycap
>&nbsp;</keycap
> (chave espaço)</term>
<listitem
><para
>Isto disparará uma lista dos atributos possíveis para o elemento atual se você estiver dentro de uma tag.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><keycap
>&amp;</keycap
> (chave E comercial)</term>
<listitem
><para
>Isto disparará uma lista de entidades nomeadas.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="xmltools-features-and-limitations">
<title
>Características e limitações</title>

<para
>Você pode testar todas as funções e limitações carregando <filename
>$KDEDIR/share/apps/katexmltools/testcases.xml</filename
> no &kate; e seguindo as instruções.</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 Elemento...</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Isto irá abrir uma janela que lhe permite inserir um elemento em &XML;. Os caracteres &lt;, &gt; e a marca de fecho serão inseridos automaticamente. Se você tiver selecionado algum texto quando tiver selecionado este item do menu, o texto selecionado será rodeado pela marca de abertura e de fecho. A janela também oferece o completamento de todos os elementos que poderão ser inseridos na posição atual 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 Elemento</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Isto irá pesquisar em seu texto por uma tag que não está ainda fechada e irá fechá-la inserindo a tag de fechamento correspondente. A pesquisa inicia na posição do cursor e vai para a esquerda. Se não puder encontrar uma tag aberta nada acontecerá.</para
></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><guimenu
>XML</guimenu
> <guimenuitem
>Designar Meta DTD...</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Isto irá dizer ao plug-in qual meta DTD usar para o documento atual. Note que esta designação não será salva. Você terá que repetir isto quando você iniciar o &kate; na próxima vez.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="xmltools-thanks-and-acknowledgements">
<title
>Agradecimentos e Reconhecimentos</title>
<para
>Plug-in para o &kate; de <quote
>Completação de &XML;</quote
> copyright 2001,2002 &Daniel.Naber; &Daniel.Naber.mail;. </para>
<para
>Versão para o KDE SC 4 com 'copyright' 2010 de Tomáš Trnka</para>
<para
>Copyright da Documentação 2001,2002 por &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
>Mudança Rápida de Documentos</guilabel
> com um campo de pesquisa e uma lista com os arquivos abertos. Ao inserir o texto no campo de pesquisa, os nomes e URL's dos documentos são pesquisados com base no texto correspondente. Enquanto introduz texto no campo de pesquisa, você poderá usar as teclas de cursores para <keysym
>Cima</keysym
> e para <keysym
>Baixo</keysym
> para navegar na lista. Se sair da janela com o <guilabel
>OK</guilabel
>, o plugin fará com que mude para o documento selecionado na lista. Isto torna a mudança de documentos mais simples, caso existam muitos documentos 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
>Arquivo</guimenu
> <guimenuitem
>Exportar como HTML...</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Exporta o seu arquivo para o formato &HTML;, para que o 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 selecionado com o realce de sintaxe como texto 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 arquivos</title>

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

<varlistentry>
<term>
<menuchoice
><guimenu
>Editar</guimenu
> <guimenuitem
>Procurar nos arquivos...</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Lança a janela para <guilabel
>Procurar nos arquivos</guilabel
> que lhe permite procurar por um texto nos documentos de uma pasta.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><guimenu
>Exibir</guimenu
><guisubmenu
>Áreas de ferramentas</guisubmenu
><guimenuitem
>Mostrar o Procurar nos arquivos</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Alterna a exibição da ferramenta <guilabel
>Procurar nos arquivos</guilabel
> do &kate;. </para>
</listitem>
</varlistentry>

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

<sect1 id="kate-application-plugin-searchinfiles">
<sect1info>
<authorgroup
><author
><firstname
>T.C.</firstname
> <surname
>Hollingsworth</surname
> <affiliation
><address
><email
>tchollingsworth@gmail.com</email
></address
></affiliation>
</author
></authorgroup>
</sect1info>
<title
>Pesquisar nos arquivos</title>

<sect2 id="searchinfiles-intro">
<title
>Introdução</title>
<para
>O plugin Pesquisar nos arquivos do &kappname; permite que você procure por um texto ou <link linkend="regular-expressions"
>expressão regular</link
> em vários arquivos de uma só vez. Você pode procurar em todos os arquivos abertos, ou todos os arquivos de uma pasta, e opcionalmente suas subpastas. Você pode até mesmo filtrar por nome de arquivo, para por exemplo procurar somente em arquivos que terminam com uma extensão específica de arquivo.</para>

<para
>O plugin Procurar nos arquivos não está ativo por padrão, uma vez que ele é novo no &kappname; 3.7. Ative-o no painel <link linkend="config-dialog-plugins"
>Plugins</link
> das configurações do &kappname;. Ele substituirá o antigo <link linkend="kate-application-plugin-findinfiles"
>plugin Procurar nos arquivos</link
> na próxima versão do &kappname;.</para>

</sect2>

<sect2 id="searchinfiles-ui">
<title
>Interface</title>

<sect3 id="searchinfiles-ui-query">
<title
>Parâmetros da pesquisa</title>

<para
>As opções a seguir são exibidas sempre no topo da ferramenta Pesquisar nos arquivos:</para>

<variablelist>

<varlistentry>
<term
><guiicon
>Nova aba</guiicon
></term>
<listitem
><para
>Você pode ter tantas pesquisas quanto desejar abertas ao mesmo tempo. Basta clicar no botão <guibutton
>Nova aba</guibutton
> no canto superior esquerdo da ferramenta de Pesquisa e uma nova aba de resultados será aberta, permitindo que você realize outra pesquisa. </para
></listitem>
</varlistentry>

<varlistentry>
<term
>Pesquisa</term>
<listitem
><para
>A grande caixa de texto no topo é onde você digita o que você deseja encontrar. Você pode inserir um texto padrão ou uma expressão regular se este recurso estiver ativo. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Pesquisar</guibutton
></term>
<listitem
><para
>Quando você tiver terminado de configurar tudo, basta pressionar o botão <guibutton
>Pesquisar</guibutton
> para que a pesquisa seja realizada. Você pode também pressionar o &Enter; na caixa de texto da Pesquisa para obter o mesmo efeito. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guimenu
>Localização</guimenu
></term>
<listitem
><para
>Isto possui duas opções. Selecione <guilabel
>nos arquivos abertos</guilabel
> para pesquisar em todos os arquivos atualmente abertos no &kappname;. Selecione <guilabel
>na pasta</guilabel
> para pesquisar em uma pasta e opcionalmente suas subpastas. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guimenu
>Opções</guimenu
></term>
<listitem
><para
>Existem duas opções disponíveis. Se ativado, a opção <guilabel
>Corresponder caixa</guilabel
> restringirá os resultados da pesquisa para somente aqueles que possuem a mesma combinação de letras maiúsculas e minúsculas do texto de sua pesquisa. A opção <guilabel
>Expressões regulares</guilabel
> permite que você use <link linkend="regular-expressions"
>expressões regulares</link
> ao invés de texto simples como sua pesquisa. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guiicon
>Alternar resultados</guiicon
></term>
<listitem
><para
>A seta para baixo no canto superior direito da ferramenta Pesquisar nos arquivos alternará a metade inferior da ferramenta entre exibir opções adicionais para o modo Pesquisar na pasta e os resultados de sua pesquisa. </para
></listitem>
</varlistentry>

</variablelist>
</sect3>

<sect3 id="searchinfiles-ui-folder">
<title
>Opções do Pesquisar na pasta</title>

<para
>Estas opções são exibidas abaixo das opções de consulta mencionadas anteriormente. Se os resultados da pesquisa estiverem sendo exibidos, pressione o botão <guiicon
>Alternar resultados</guiicon
> para exibi-las. Estas opções se aplicam somente quando o modo Pesquisar na pasta estiver ativo. Se o Pesquisar nos arquivos abertos estiver selecionado, as opções estarão desativadas.</para>

<variablelist>

<varlistentry>
<term
><guilabel
>Pasta</guilabel
></term>
<listitem
><para
>Você pode inserir a localização da pasta que deseja pesquisar. Por exemplo, você pode inserir <userinput
>~/development/kde/kate/</userinput
> se deseja pesquisar no código fonte do &kate;. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guiicon
>Diálogo de abertura de arquivo</guiicon
></term>
<listitem
><para
>Pressione este botão para localizar a pasta no navegador de pastas do seu computador. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guiicon
>Acima</guiicon
></term>
<listitem
><para
>Pressione este botão para mudar a <guilabel
>Pasta</guilabel
> para a pasta pai da atualmente selecionada. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guiicon
>Restaurar pasta atual</guiicon
></term>
<listitem
><para
>Este botão definirá a entrada <guilabel
>Pasta</guilabel
> para a pasta na qual o documento atual está localizado. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Filtro</guilabel
></term>
<listitem
><para
>Isto permite que você pesquise somente por nomes de arquivos que correspondam a um determinado padrão. Por exemplo, para pesquisar somente por arquivos escritos em C++, mude isto para <userinput
>*.cpp</userinput
>. Para pesquisar somente por arquivos começando com <literal
>kate</literal
>, mude isto para <userinput
>kate*</userinput
>. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Recursivo</guilabel
></term>
<listitem
><para
>Se esta opção estiver ativa, o &kappname; pesquisará também em todas as subpastas da pasta selecionada. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Incluir ocultos</guilabel
></term>
<listitem
><para
>Se esta opção estiver ativa, o &kappname; também pesquisará em arquivos ou pastas que estão normalmente ocultos pelo seu &OS;. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Seguir as ligações simbólicas</guilabel
></term>
<listitem
><para
>O plugin Pesquisar nos arquivos normalmente não segue <ulink url="http://en.wikipedia.org/wiki/Symbolic_link"
>ligações simbólicas</ulink
>. Quando esta opção estiver ativa, o plugin as seguirá ao invés de pesquisar dentro dos arquivos ou pastas às quais elas se referem. </para>
<warning
><para
>É possível ligações simbólicas que se referem a uma pasta que é a pai da pasta que estiver atualmente sendo pesquisada, ou que outras pastas contenham ligações simbólicas para seus pais. Se existir este tipo de ligação na pasta que está sendo pesquisada e esta opção estiver ativa, o &kappname; seguirá repetidamente a ligação e pesquisará a pasta, e a pesquisa nunca terminará.</para
></warning>
</listitem>
</varlistentry>

</variablelist>
</sect3>

<sect3 id="searchinfiles-ui-results">
<title
>Resultados da pesquisa</title>

<para
>Os resultados de sua pesquisa são exibidos abaixo das opções de consulta. Se as opções do modo de Pesquisa em pasta estiverem sendo exibidas, basta pressionar o botão <guiicon
>Alternar resultados</guiicon
> para exibi-los. Eles também serão automaticamente exibidos tão logo a pesquisa termine.</para>

<para
>Os resultados da pesquisa são exibidos em três colunas fornecendo informações sobre cada resultado de sua pesquisa. A coluna <guilabel
>Arquivo</guilabel
> mostra o nome do arquivo. A coluna <guilabel
>Linha</guilabel
> mostra o número da linha aonde o conteúdo de sua pesquisa foi encontrado. A coluna <guilabel
>Texto</guilabel
> exibe o texto completo da referida linha.</para>

<para
>Para abrir o arquivo encontrado pela sua pesquisa, basta dar um clique-duplo sobre ele. O &kappname; abrirá o arquivo, se necessário, e posicionará o cursor no início do texto inserido como pesquisa encontrado no arquivo.</para>

</sect3>
</sect2>

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

<!--<varlistentry>
<term>
<menuchoice>
<guimenu
>Edit</guimenu>
<guimenuitem
>Find in Files...</guimenuitem>
</menuchoice>
</term>
<listitem>
<para
>Launch the <guilabel
>Find in Files</guilabel
> dialog to allow you to
search for text in the files of a folder.</para>
</listitem>
</varlistentry
>-->

<varlistentry>
<term>
<menuchoice
><guimenu
>Exibir</guimenu
><guisubmenu
>Áreas de ferramentas</guisubmenu
><guimenuitem
>Mostrar o Pesquisar nos arquivos</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Alterna a exibição da ferramenta <guilabel
>Pesquisar nos arquivos</guilabel
> do &kappname;. </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 arquivos por e-mail</title>

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

<varlistentry>
<term>
<menuchoice
><guimenu
>Arquivo</guimenu
> <guimenuitem
>Enviar por E-mail...</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Abre o seu cliente de e-mail e anexa o arquivo na mensagem de e-mail. </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 do sistema de arquivos</title>

<para
>O navegador do sistema de arquivos é um visualizador de pastas que lhe permite abrir os arquivos a partir da pasta mostrada na janela atual.</para>

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

<varlistentry>
<term>
<anchor id="view-toolviews-show-fileselector"/>
<menuchoice
><guimenu
>Exibir</guimenu
><guisubmenu
>Áreas de Ferramentas</guisubmenu
><guimenuitem
>Mostrar o Navegador no sistema de arquivos</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Liga e desliga o navegador do sistema de arquivos do &kate;</para>
</listitem>
</varlistentry>

</variablelist>
</sect2>

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

<para
>De cima para baixo, o navegador do sistema de arquivos consiste nos seguintes elementos:</para>

<variablelist>
<varlistentry>
<term
>Uma barra de ferramentas</term>
<listitem>
<para
>Contém os botões de navegação padrão da ferramenta:</para>
<variablelist>
<varlistentry>
<term
><guibutton
>Voltar</guibutton
></term>
<listitem
><para
>Faz com que a visão de pastas, com o comando <command
>cd</command
>, vá para a pasta exibida anteriormente no histórico. Este botão ficará desligado, se não existir o item anterior.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guibutton
>Avançar</guibutton
></term>
<listitem
><para
>Faz com que a visão de pastas, com o <command
>cd</command
>, mostre o próxima pasta do histórico. O botão é desabilitado, caso não exista a próxima pasta.</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 e para adicionar uma nova pasta de favoritos.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guibutton
>Pasta de documento atual</guibutton
></term>
<listitem
><para
>Este botão fará com que a visão de pastas, com o comando <command
>cd </command
>, vá para a pasta do documento atualmente ativo, se possível. Este botão é desabilitado se o documento ativo é um arquivo novo ou ainda não salvo, ou se a pasta no qual ele reside não pode ser definida.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guibutton
>Opções</guibutton
></term>
<listitem>
<variablelist>
<varlistentry>
<term
><guimenuitem
>Visão abreviada</guimenuitem
></term>
<listitem
><para
>Mostra apenas os nomes dos arquivos.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guimenuitem
>Visão detalhada</guimenuitem
></term>
<listitem
><para
>Mostra o <guilabel
>Nome</guilabel
>, <guilabel
>Data</guilabel
>, <guilabel
>Tamanho</guilabel
> e <guilabel
>Tipo</guilabel
> dos arquivos.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guimenuitem
>Visão em árvore</guimenuitem
></term>
<listitem
><para
>Como a visão abreviada, mas as pastas podem ser expandidas para ver seu conteúdo.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guimenuitem
>Visão em árvore detalhada</guimenuitem
></term>
<listitem
><para
>Isto também permite que as pastas sejam expandidas, mas exibe as colunas adicionais disponíveis na visão detalhada.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guimenuitem
>Exibir arquivos ocultos</guimenuitem
></term>
<listitem
><para
>Mostra os arquivos normalmente ocultos pelo seu sistema operacional.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guimenuitem
>Sincronizar automaticamente com o documento atual</guimenuitem
></term>
<listitem
><para
>Quando esta opções estiver ativa, o navegador do sistema de arquivos fará um <command
>cd</command
> automaticamente para a pasta do documento atualmente aberto na área de edição toda vez que ele mudar.</para
></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term
>Um entrada de localização</term>
<listitem>
<para
>Isto exibe uma navegação no estilo 'trilha de pão' para a pasta atualmente aberta, como no &dolphin;. Você pode clicar em qualquer pasta para navegar nela, ou clicar em uma das setas à esquerda de uma pasta para selecionar qualquer pasta a partir dela. Você pode também selecionar a partir de sua lista de locais clicando no ícone mais à esquerda na navegação em 'trilha de pão', que exibe um ícone que representa seu Local atual.</para>

<para
>Você pode também clicar na trilha de pão para mudar para uma caixa de texto de onde pode digitar a localização de uma pasta para navegar. O campo do &URL; mantém uma lista dos campos introduzidos anteriormente. Para escolher um, utilize o botão da seta à direita do campo.</para>
<tip
><para
>O campo do &URL; tem a completamento automático das pastas. O método de completamento pode ser definido usando o menu do botão direito do mouse do campo.</para
></tip>
</listitem>
</varlistentry>

<varlistentry>
<term
>Uma visão de pastas</term>
<listitem
><para
>Esta é uma janela de pastas padrão do &kde;.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Uma entrada de filtro</term>
<listitem>
<para
>A entrada de Filtro permite a você digitar um filtro para arquivos exibidos na visão de pastas. O filtro está usando padrões, que devem estar separados por espaço em branco. Exemplo: <userinput
>*.cpp *.h *.moc</userinput
></para>
<para
>Para exibir todos os arquivos, digite um único asterisco - <userinput
>*</userinput
>.</para>
<para
>O campo do filtro salva os últimos 10 filtros inseridos entre sessões. Para usar um, clique no botão de setas à direita do campo e selecione o filtro desejado. Você poderá desativar o filtro se clicar no botão <guibutton
>Limpar o texto</guibutton
> à esquerda do botão de auto-completamento.</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 arquivos</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 no navegador do sistema de arquivos, movendo os que deseja ativar para a lista de <guilabel
>Ações Selecionadas</guilabel
> e ordenando-os com as 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
>, você irá encontrar um submenu chamado <guisubmenu
>Ferramentas externas</guisubmenu
>, se você habilitá-las nas configurações do &kate;. Estas ferramentas invocam os aplicativos externos com dados relativos ao documento atual como, por exemplo, o seu URL, pasta, texto ou seleção.</para>

<para
>As ferramentas externas são definidas pelo usuário e você poderá adicionar, editar ou remover as 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 aplicativos externos com dados relacionados com o documento atual, como por exemplo o seu URL, pasta, texto ou seleção. Esta página permite-lhe gerenciar o menu e editar, remover ou adicionar ferramentas novas.</para>

<para
>Cada ferramenta externa é um comando de console que contém macros representando dos dados do documento. Quando estiver ativada, as macros são substituídas por dados do documento ativo.</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 selecionada no momento, usando a folha de propriedades descrita abaixo.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Inserir separador</guibutton
></term>
<listitem
><para
>Adiciona uma linha separadora que aparece no menu abaixo do item atualmente selecionado.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Acima</guibutton
></term>
<listitem
><para
>Sobe o item atualmente selecionado para cima do anterior.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Abaixo</guibutton
></term>
<listitem
><para
>Desce o item atualmente selecionado 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 aparecerá no menu <guisubmenu
>Ferramentas externas</guisubmenu
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Ícone</guibutton
></term>
<listitem
><para
>Permite que você selecione 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 a ferramenta estiver ativada. Antes de passar o programa à linha de comando, são substituídas as seguintes macros: <variablelist>
<varlistentry>
<term
><userinput
>%URL</userinput
></term>
<listitem
><para
>O URL completo do documento atual ou um texto vazio, se o documento não estiver salvo.</para
></listitem>
</varlistentry>

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

<varlistentry>
<term
><userinput
>%directory</userinput
></term>
<listitem
><para
>A parte do diretório do URL do documento atual ou um texto vazio se o documento atual não estiver salvo.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%filename</userinput
></term>
<listitem
><para
>O nome do arquivo do documento atual, sem o caminho completo, ou um texto vazio se o documento atual não estiver salvo.</para
></listitem>
</varlistentry>

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

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

<varlistentry>
<term
><userinput
>%selection</userinput
></term>
<listitem
><para
>O texto selecionado no documento atual ou um texto vazio se não existir qualquer texto selecionado</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%text</userinput
></term>
<listitem
><para
>O texto completo do documento atual. Note que este texto 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
><guilabel
>Executável</guilabel
></term>
<listitem
><para
>O executável principal no programa. Isto é obrigatório e é usado para testar se o comando poderá ser executado de fato. É permitida uma localização absoluta, no caso do executável não se encontrar acessível através da sua variável <envar
>PATH</envar
>.</para
></listitem>
</varlistentry>

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

<varlistentry>
<term
><guilabel
>Salvar</guilabel
></term>
<listitem
><para
>Você poderá, opcionalmente, optar por salvar o documento atual ou todos os documentos, antes de executar o programa. Isto é útil se o seu programa ler o arquivo do disco.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Nome da linha de comando</guilabel
></term>
<listitem
><para
>Se você preencher isto, a ferramenta estará disponível na <link linkend="advanced-editing-tools-commandline"
>linha de comando dos editores</link
> como <command
>exttool-<replaceable
>nome da linha de comando</replaceable
></command
> (o texto que indicar aqui é antecedido por <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>
