Second part of prior commit

1 files changed, 462 insertions, 0 deletions

diff --git a/tde-i18n-pt/docs/tdeaddons/kate-plugins/filetemplates.docbook b/tde-i18n-pt/docs/tdeaddons/kate-plugins/filetemplates.docbook
new file mode 100644
index 00000000000..b6806d1a540
--- /dev/null
+++ b/tde-i18n-pt/docs/tdeaddons/kate-plugins/filetemplates.docbook
@@ -0,0 +1,462 @@
+<chapter id="filetemplates">
+  <chapterinfo>
+
+    <title
+>Modelos de Ficheiros</title>
+
+    <authorgroup>
+      <author
+><firstname
+>Anders</firstname
+> <surname
+>Lund</surname
+> <affiliation
+> <address
+>&Anders.Lund.mail;</address>
+        </affiliation>
+      </author>
+<othercredit role="translator"
+><firstname
+>José</firstname
+><surname
+>Pires</surname
+><affiliation
+><address
+><email
+>jncp@netcabo.pt</email
+></address
+></affiliation
+><contrib
+>Tradução</contrib
+></othercredit
+> 
+    </authorgroup>
+<date
+>Seg 16 Fev 2004</date
+> <releaseinfo
+>0.1</releaseinfo
+> <keywordset>
+      <keyword
+>KDE</keyword>
+      <keyword
+>kate</keyword>
+      <keyword
+>tdeaddons</keyword>
+      <keyword
+>modelo</keyword>
+      <keyword
+>macro</keyword>
+    </keywordset>
+  </chapterinfo>
+
+  <title
+>Introdução</title>
+
+  <para
+>O 'plugin' de Modelos de Ficheiros permite-lhe criar ficheiros com base noutros ficheiros. Você poderá usar qualquer ficheiro como modelo, o que irá criar uma cópia do ficheiro com um &URL; vazio ou usar um ficheiro de modelo especial que poderá conter macros para preencher alguma informação como o seu nome e endereço de e-mail, a data actual e as variáveis de ambiente, posicionando o cursor numa posição conveniente do ficheiro novo.</para>
+  <para
+>Para além disso, os modelos localizados nas directorias de modelos serão apresentados no item de menu <menuchoice
+><guimenu
+>Ficheiro</guimenu
+><guimenuitem
+>Do Modelo..</guimenuitem
+></menuchoice
+>.</para
+> <para
+>O 'plugin' também fornece um método para criar um novo modelo a partir de um documento aberto.</para>
+  <para
+>As pastas dos modelos fazem parte do sistema de ficheiros do &kde; e consistem em, pelo menos, a KDEDIR/share/applications/kate/plugins/katefiletemplates/templates e a KDEHOME/share/applications/kate/plugins/katefiletemplates/templates. Se a sua variável de ambiente KDEDIRS 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>
+  <sect1 id="katefiletemplates-menu">
+    <title
+>Estrutura do Menu</title>
+
+    <variablelist>
+      <varlistentry>
+        <term>
+          <menuchoice
+><guimenu
+>Ficheiro</guimenu
+> <guimenu
+>Novo a Partir do Modelo</guimenu
+> <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>
+
+      <varlistentry>
+        <term>
+          <menuchoice
+><guimenu
+>Ficheiro</guimenu
+> <guimenu
+>Novo a Partir do Modelo</guimenu
+> <guimenuitem
+>Usar um Recente</guimenuitem
+> </menuchoice>
+        </term>
+        <listitem
+><para
+>Apresenta uma lista dos ficheiros usados recentemente como modelos, representados pelo seu &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>
+  </sect1>
+
+  <sect1 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>
+  </sect1>
+
+  <sect1 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>
+  </sect1>
+
+  <sect1 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>
+  </sect1>
+
+  <sect1 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>
+
+    <sect2 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
+>Template</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
+>Name</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
+>Author</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>
+
+    </sect2>
+
+    <sect2 id="katetemplates-macros">
+      <title
+>Macros do Modelo</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
+>email</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>
+    </sect2>
+
+    <sect2 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>
+    </sect2>
+
+  </sect1>
+
+  <sect1 id="katefiletemplates-thanks-and-acknowledgements">
+    <title
+>Agradecimentos e Reconhecimentos</title>
+
+    <para
+>'Plugin' do &kate; <quote
+>Modelos de Ficheiro</quote
+> copyright 2004 Anders Lund <email
+>anders@alweb.dk</email
+>. </para>
+
+    <para
+>Documentação copyright 2004 &Anders.Lund; </para>
+
+    <para
+>Tradução de José Nuno Pires <email
+>jncp@netcabo.pt</email
+></para
+> 
+&underGPL; </sect1>
+</chapter>
+
+<!-- kate: word-wrap on; space-indent on; indent-width 2; -->
\ No newline at end of file