##master-page:HelpTemplate
##master-date:Unknown-Date
#format wiki
#language pt
Esta página contém mais informação sobre a utilização de variáveis nas páginas do wiki. É especialmente útil nos [[AjudaComModelos|modelos]], mas também nas páginas "normais" do wiki (ex: assinar um texto).

<<TableOfContents>>

== Variáveis Pré-definidas ==
As seguintes variáveis são substituídas ao guardar a página. '''''Tenha em consideração de que não aparecerão substituídas na pré-visualização!'''''

|| Variável        || Descrição                                || Exemplo ||
|| @``PAGE@     || Nome da página (útil para páginas modelo) || AjudaNaCriaçãoDePáginas ||
|| @``DATE@     || Data actual no formato do sistema          || <<Date(2004-08-30T06:38:05Z)>> ||
|| @``TIME@     || Data e hora actuais no formato do utlizador  || <<DateTime(2004-08-30T06:38:05Z)>> ||
|| @``ME@       || Só o nome do utilizador || TheAnarcat ||
|| @``USERNAME@ || Só o nome do utilizador (ou o seu domínio/IP)      || TheAnarcat ||
|| @``USER@     || Assinatura "-- nome de acesso"                     || -- TheAnarcat ||
|| @``SIG@      || Assinatura datada "-- nome de acesso, data e hora"     || -- TheAnarcat <<DateTime(2004-08-30T06:38:05Z)>> ||
|| @``MAILTO@   || Uma ligação mailto: com os dados do utilizador    || Nenhum - em sítios públicos, é preferível utilizar a macro Mail``To) ||


== Expandir Variáveis ==

Pode utilizar Nome``Da``Página``Principal/My``Dict para expandir essas variáveis. Basta ter um dicionário (ver AjudaComDicionários) com as suas variáveis e valores. Por exemplo,
{{{
 VAR1:: substituição 1
 VAR2:: substituição 2
}}}


== Obter Variáveis ==

=== Ao Recarregar a Página ===

Pode utilizar estes valores utilizando a macro `GetVal`:

{{{
<<GetVal(WikiDict,var1)>> <<GetVal(WikiDict,var2)>> <<GetVal(WikiDict,var3)>>
}}}

Surge como:

<<GetVal(WikiDict,var1)>> <<GetVal(WikiDict,var2)>> <<GetVal(WikiDict,var3)>>

=== Ao Guardar a Página ===

Se as variáveis forem definidas em !NomeDeUtilizador/!MyDict (!NomeDeUtilizador deve ser substituído apropriadamente), pode obter as variáveis ao guardar qualquer página com @var1@, @var2@, ...etc. em vez da macro {{{GetVal}}}. 

----

/!\ Tenha em consideração que os dados nas páginas de dicionários são guardados na cache e não é necessário abrir ou editar o ficheiro da página por cada acesso ao valor. No CGI, o valor recolhido de uma lista (de um processo em execução) carregada uma vez. O valor é acedido por memória.

/!\ Tenha em consideração que guardar páginas modelo e utilizar a pré-visualização ''não'' expande as variáveis. Para além disso, a expansão de variáveis é global e acontece em qualquer sítio da página, incluindo a apresentação de código, comentários, processamento de instruções e outras áreas "especiais" de uma página, que possivelmente julgava excluídas.
