# Modelos de Ficheiros

## Introdução

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 além disso, os modelos localizados nas directorias de modelos serão apresentados no item de menu Ficheiro Do Modelo...

O 'plugin' também fornece um método para criar um novo modelo a partir de um documento aberto.

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).

## Estrutura do Menu

Ficheiro Novo a Partir do Modelo Qualquer Ficheiro...

- Apresenta-lhe uma janela de Abertura de Ficheiros que lhe permite usar qualquer ficheiro como modelo. Se o ficheiro escolhido tiver a extensão `katetemplate`, ele será processado para a informação e as macros do modelo.

Ficheiro Novo a Partir do Modelo Usar um Recente

- Apresenta uma lista dos ficheiros usados recentemente como modelos, representados pelo seu URL.

Ficheiro Novo a Partir do Modelo

- 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.

Configuração Gerir os Modelos

- 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.

## Usar um Modelo do &kate;

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.

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.

## Criar os seus próprios modelos

Para criar um modelo novo, use o item Configuração Gerir os Modelos para lançar a janela de gestão de modelos. Na mesma, carregue em Novo... 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.

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 `katetemplate`.

O menu do modelo é actualizado automaticamente se você optou por gravar o seu modelo na directoria respectiva.

## Editar os modelos

Para editar um modelo, use a opção Configuração Gerir os Modelos.... Seleccione o modelo com que deseja trabalhar e carregue em Editar..., 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.

## O Formato dos Modelos do Kate

Se você usar os ficheiros com a extensão `katetemplate`, eles serão processados no que respeita à informação do modelo, das macros e da posição do cursor.

### Informação do modelo

Ao ler o ficheiro, o analisador guarda as linhas que começam com a frase `katetemplate:` e procura nelas por informações do modelo no formato NOMEVARIAVEL=VALOR. A primeira linha que não começar por `katetemplate:` 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:

`Template`

- Este é o nome do modelo, mostrado no menu Ficheiro A Partir do Modelo.

`Group`

- O grupo coloca o modelo dentro de um sub-menu do Ficheiro A Partir do Modelo.

`Name`

- 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 `%N`, este será substituído por um número, o qual será incrementado se existir mais do que um documento com o mesmo nome.

`Highlight`

- 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 Ferramentas Realce .

`Description`

- 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.

Author

- Um texto que identifica o autor, por exemplo no formato `Nome <endereço de e-mail>`. 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.

### Macros do Modelo

Ao processar o conteúdo do modelo, as macros no formato `%{NOME}` ou `${NOME}` são expandidas. Se usar o prefixo `$`, 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 `%` não o será, a menos que a expansão seja mal-sucedida.

São expandidas as seguintes macros:

time

- Expande para a hora actual, no seu formato regional.

date

- Expande para a hora actual, num formato curto.

datetime

- Expande para a data e hora actuais, formatadas como uma cadeia de caracteres de acordo com a sua configuração regional.

year

- O ano actual, como um número de quatro algarismos.

month

- O nome completo do mês actual, de acordo com a sua configuração regional.

day

- Expande para o dia actual do mês.

hostname

- Expande para o nome do seu computador.

index

- Expande para 'i'.

fullname

- Expande para o seu nome completo, tal como está definido no seu livro de endereços normal do KDE.

firstname

- Expande para o seu primeiro nome, tal como está definido no seu livro de endereços normal do KDE.

lastname

- Expande para o seu último nome (apelido), tal como está definido no seu livro de endereços do KDE.

email

- Expande para o seu endereço de e-mail, tal como está definido no seu livro de endereços normal do KDE.

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.

### Configurar a posição do cursor

A macro especial `${cursor}` 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.

## Agradecimentos e Reconhecimentos

'Plugin' do &kate; Modelos de Ficheiro copyright 2004 Anders Lund anders@alweb.dk.

Documentação copyright 2004 Anders Lund

Tradução de José Nuno Pires jncp@netcabo.pt

&underGPL;