You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
462 lines
14 KiB
462 lines
14 KiB
<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
|
|
>kdeaddons</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 <endereço de e-mail></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; --> |