diff options
Diffstat (limited to 'tde-i18n-pt_BR/docs/tdeaddons/kate-plugins/xmltools.docbook')
| -rw-r--r-- | tde-i18n-pt_BR/docs/tdeaddons/kate-plugins/xmltools.docbook | 236 |
1 files changed, 236 insertions, 0 deletions
diff --git a/tde-i18n-pt_BR/docs/tdeaddons/kate-plugins/xmltools.docbook b/tde-i18n-pt_BR/docs/tdeaddons/kate-plugins/xmltools.docbook new file mode 100644 index 00000000000..95c9679efd3 --- /dev/null +++ b/tde-i18n-pt_BR/docs/tdeaddons/kate-plugins/xmltools.docbook @@ -0,0 +1,236 @@ +<chapter id="xmltools"> +<chapterinfo> + +<title +>Complementação de <acronym +>XML</acronym +></title> + +<authorgroup> +<author +><firstname +>Daniel</firstname +> <surname +>Naber</surname +> <affiliation +> <address +><email +>daniel.naber@t-online.de</email +></address> +</affiliation> +</author> +</authorgroup +> <date +>2002-07-20</date +> <releaseinfo +>0.90.00</releaseinfo +> <abstract +> <para +>Este plug-in suporta escrever arquivos XML listando tags permitidas e mais.</para> + +</abstract> +<keywordset> +<keyword +>KDE</keyword> +<keyword +>kate</keyword> +<keyword +>xml</keyword> +</keywordset> +</chapterinfo> + +<title +>introdução</title> + +<para +>Este plug-in dá pistas sobre o que é permitido em certa posição de um arquivo XML, de acordo com o DTD do arquivo. Ele listará possíveis elementos, atributos, valores de atributos ou entidades, dependendo da posição do cursor (por exemplo, todas as entidades são listadas se o caractere a esquerda do cursor for <quote +>&</quote +>). Também é possível fechar a tag aberta mais próxima a 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 +>, o qual também é a pasta padrão quando você escolhe <guimenuitem +>Designar Meta DTD...</guimenuitem +>. Para produzir seus próprios meta DTDs, pegue o <command +>dtdparse</command +> em <ulink url="http://dtdparse.sourceforge.net" +>http://dtdparse.sourceforge.net</ulink +>.</para> + +<sect1 id="xmltools-how-to-use"> +<title +>Como Usar</title> + +<para +>Inicie o Kate e selecione <guilabel +>Complementação XML do Kate</guilabel +> o qual aparecerá na seção <guilabel +>Aplicação</guilabel +>/<guilabel +>Plug-ins</guilabel +> sob <menuchoice +><guimenu +>Configuração</guimenu +> <guimenuitem +>Configurar Kate..</guimenuitem +></menuchoice +>. Após isto, selecione <menuchoice +><guimenu +>Plug-in XML</guimenu +><guimenuitem +>Designar Meta DTD</guimenuitem +></menuchoice +>. Se o seu documento não contém <quote +>DOCTYPE</quote +> ou o doctype é desconhecido, você terá que selecionar um meta DTD do sistema de arquivo. Senão, o meta DTD que combinar com o DOCTYPE do documento atual será carregado automaticamente.</para> + +<para +>Você pode agora usar o plug-in enquanto digita seu texto:</para> + +<variablelist> + +<varlistentry> +<term +>< (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 (isto é <quote +><html></quote +>).</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>" (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 +>(chave de 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 +>& (chave E comercial)</term> +<listitem +><para +>Isto disparará uma lista de entidades nomeadas.</para +></listitem> +</varlistentry> +</variablelist> + +</sect1> + +<sect1 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. Note que trabalhar com mais de uma visualização por documento ainda não é suportado corretamente por este plug-in.</para> + +</sect1> + + +<sect1 id="xmltools-menu"> +<title +>Estrutura do Menu</title> + +<variablelist> +<varlistentry> +<term> +<menuchoice +><guimenu +>Plug-in XML</guimenu +> <guimenuitem +>Inserir Elemento...</guimenuitem +> </menuchoice> +</term> +<listitem +><para +>Isto abrirá um dialogo que lhe permite inserir um elemento XML. Os caracteres <, > e a tag de fechamento serão inseridas automaticamente. Se você tiver selecionado texto quando este item de menu for selecionado, o texto selecionado será circundado pelas tags de abertura e fechamento. O dialogo também oferece Complementação de todos os elementos que podem ser inseridos na posição atual do cursor se você tiver designado um meta DTD usando <guimenuitem +>Designar Meta DTD...</guimenuitem +>. </para +></listitem> +</varlistentry> + +<varlistentry> +<term> +<menuchoice +><guimenu +>Plug-in 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á fecha-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 +>Plug-in 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> + +</sect1> + +<sect1 id="xmltools-thanks-and-acknowledgements"> +<title +>Agradecimentos e Reconhecimentos</title> + +<para +>Plug-in <quote +>Complementação de XML</quote +> do &kate; - copyright 2001,2002 Daniel Naber <email +>daniel.naber@t-online.de</email +>. </para> + +<para +>Copyright da Documentação 2001,2002 por Daniel Naber </para> + +<para +>Tradução de José Monteiro <email +>monteiro@ajato.com.br</email +></para +> +&underGPL; </sect1> +</chapter> + +<!-- +Local Variables: +mode: sgml +sgml-omittag: nil +sgml-shorttag: t +End: +--> + |