diff options
Diffstat (limited to 'tde-i18n-pt/docs/kdeaddons/kate-plugins/filetemplates.docbook')
| -rw-r--r-- | tde-i18n-pt/docs/kdeaddons/kate-plugins/filetemplates.docbook | 462 |
1 files changed, 462 insertions, 0 deletions
diff --git a/tde-i18n-pt/docs/kdeaddons/kate-plugins/filetemplates.docbook b/tde-i18n-pt/docs/kdeaddons/kate-plugins/filetemplates.docbook new file mode 100644 index 00000000000..ce33a3916b9 --- /dev/null +++ b/tde-i18n-pt/docs/kdeaddons/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 +>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; -->
\ No newline at end of file |