Mostrar código-fonte de Ajuda:Predefinições

{{Artigo de ajuda}} 
<div align="justify">
<br> Se você tiver textos padrão que você deseja incluir em várias páginas, o recurso de predefinição da MediaWiki entra em jogo. 

=== Criação  ===

As predefinições são páginas de wiki padrão cujo conteúdo foi projetado para ser [[Ajuda:Transclusão|transcluída]] (embutidos) dentro de outras páginas. Predefinições seguem a convenção que o nome começa com "Predefinição<code>:</code>". Portanto, você pode [[Ajuda:Como criar um artigo|criá-los como qualquer outra página wiki]]. 

=== Uso  ===

As predefinições são páginas da wiki que podem ser utilizadas em outras páginas de três maneiras: 

*<code><nowiki>{{Nome}}</nowiki></code> 'transcluem' (isto é, incluem uma cópia ) do conteúdo da predefinição (armazenados na página <nowiki>[[Predefinição:Nome]]</nowiki>) sempre que a página que contém a inclusão da predefinição é obtida e mostrada; ou seja, se a predefinição for alterada posteriormente, a página transcluída exibida vai mudar automaticamente também. 
*<code><nowiki>{{subst:Nome}}</nowiki></code> substitui a string com o conteúdo da predefinição, na fonte da página transcluída, quando você salvar essa página; a cópia do conteúdo da predefinição pode ser editada normalmente (e separadamente do original na página da predefinição). '''''Nota''''': não use isso se você estiver querendo propagar continuamente as alterações da predefinição de origem para a página (s) que faz referência a ela. 
*<code><nowiki>{{msgnw:Nome}}</nowiki></code> inclui a predefinição num formato que displaia a sintaxe wiki simples da mesma sempre que a página que a contém é mostrada.

Na verdade, uma página wiki comum também pode ser usada como um predefinição, simplesmente especificando o título (namespace) em que reside, da seguinte forma: 

*<code><nowiki>{{Predefinição:Pagename}}</nowiki></code> inclui <code><nowiki>[[Predefinição:Pagename]]</nowiki></code> 
*<code><nowiki>{{Foo:Pagename}}</nowiki></code> inclui <code><nowiki>[[Foo:Pagename]]</nowiki></code> 
*<code><nowiki>{{:Pagename}}</nowiki></code> inclui <code><nowiki>[[Pagename]]</nowiki></code> 
**<code><nowiki>{{subst::Pagename}}</nowiki></code> substitui ela mesma com o conteúdo da <code><nowiki>[[Pagename]]</nowiki></code>

Se não existe tal título (namespace), o título completo é assumido como sendo uma predefinição: 

*<code><nowiki>{{Foo:Bar}}</nowiki></code> inclui <code><nowiki>[[Predefinição:Foo:Bar]]</nowiki></code>

==== Parâmetros  ====
<div style="float:right; margin:8px;">
{|
|-
| align="center" colspan="2" | '''Predefinição com parâmetros numerados'''
|-
| colspan="2" | <pre> 
'''Um pequeno agradecimento...'''&lt;br /&gt; 
&lt;small&gt;for {{{1}}}.&lt;br /&gt; 
hugs, {{{2}}}&lt;/small&gt; 
</pre>
|-
| '''Você digita''' 
| '''Você tem'''
|-
| <code><nowiki>{{Obrigado|por todo o seu trabalho árduo|José}}</nowiki></code> 
| 
{{Obrigado|por todo o seu trabalho árduo|José}} 

|-
| align="center" colspan="2" | '''com nomes como parâmetros'''
|-
| colspan="2" | <pre> 
'''Um pequeno agradecimento...'''&lt;br /&gt; 
&lt;small&gt;for {{{razão}}}.&lt;br /&gt; 
hugs, {{{assinatura}}}&lt;/small&gt; 
</pre>
|-
| '''Você digita''' 
| '''Você tem'''
|-
| <pre>{{Obrigado 
&#124;razão=por todo o seu trabalho árduo 
&#124;assinatura=José}}</pre> 
| 
{{Obrigado|por todo o seu trabalho árduo|José}} 

|}
</div> 
<br> Você pode definir parâmetros em predefinições com números como {{{1}}} ou com nomes como {{{param}}}. Por favor, note que há um conjunto de três chaves (<code><nowiki>{{{</nowiki></code> e <code><nowiki>}}}</nowiki></code>) em torno de cada parâmetro. Isso é diferente do que o uso do nome da predefinição normal. 

'''Exemplo:''' Você quer uma pequena nota de agradecimento que você pode colocar na página de discussão de outros usuários. Isto irá conter uma razão e sua assinatura. Você poderia criar [[Predefinição:Obrigado]] para introduzir o seu texto, como no exemplo na tabela. 

Quando usar a predefinição numa página, você vai incluir os parâmetros separados por barras (|): <code><nowiki>{{Obrigado|por todo o seu trabalho árduo|José}}</nowiki></code>. Para parâmetros com nomes use "nome=valor" separados por barras: <code><nowiki>{{Obrigado|razão=por todo o seu trabalho árduo|assinatura=José}}</nowiki></code>. A vantagem de usar parâmetros nomeados em seu predefinição é que eles são flexíveis em ordem. Isto também faz a predefinição mais fácil de entender se você tem muitos parâmetros. Se você quiser alterar a ordem dos parâmetros numerados, você tem que mencionar explicitamente: <code><nowiki>{{Obrigado|2=José|1=por todo o seu trabalho árduo}}</nowiki></code>. 

Você também pode fornecer valores padrão para os parâmetros, isto é, valores que serão usados se nenhum valor é fornecido para um parâmetro. Por exemplo, <code><nowiki>{{{razão|por todo o seu trabalho árduo}}}</nowiki></code> resultará em ''"por todo o seu trabalho árduo"'' se nenhum valor for informado para o parâmetro <tt>razão</tt>. 

==== Controle de Inclusão de predefinição  ====

Você pode controlar a inclusão da predefinição usando <code><nowiki><noinclude></nowiki></code> e <code><nowiki><includeonly></nowiki></code> tags. 

Qualquer coisa entre <code><nowiki><noinclude></nowiki></code> e <code><nowiki></noinclude></nowiki></code> será processado e apresentado apenas quando a página da Predefinição estiver sendo vista diretamente. 

As aplicações possíveis são: 

*Predefinições de categorização 
*Links interlínguas para predefinições semelhantes em outros idiomas 
*Texto explicativo sobre como usar a predefinição

O inverso é <code><nowiki><includeonly></nowiki></code>. O texto entre <code><nowiki><includeonly></nowiki></code> e <code><nowiki></includeonly></nowiki></code> será processado e apresentado apenas quando a página está sendo incluída. A aplicação óbvia é a de adicionar todas as páginas que contêm uma determinado predefinição a uma [[Ajuda:Categorização|categoria]], sem colocar a predefinição em si nessa categoria. 

{{Note|Quando você altera as categorias aplicadas por uma Predefinição, a categorização das páginas que usam essa Predefinição não podem ser atualizados até algum tempo depois: esta é tratada pelo {{mediawiki|Manual:Job queue|job queue}}.}} 

==== Documentação  ====

Documentação para os usuários, em conjunto com as categorias do predefinição são normalmente colocadas após o código do predefinição, dentro de etiquetas "noinclude". É normalmente necessário para colocar a etiqueta de abertura "noinclude" imediatamente após o final do código, sem espaços ou quebras de linha, para evitar incluir espaço em branco indesejado. 

No caso de predefinições complexos, a documentação (em conjunto com as categorias e wikilinks) é muitas vezes mantidos em uma separada [[Ajuda:Sub-páginas|sub-página]] da página do predefinição (chamado "Template:XXX/doc"). Isto também se aplica a muitas predefinições [[Ajuda:Páginas protegidas|protegidas]] (para permitir que a informação seja editada por não-administradores). Isto é conseguido, colocando a predefinição {{tl|Documentation}} após o código principal de Predefinição (dentro de "noinclude" tags). Se a sub-página ";/doc" não existe, um link aparecerá, então, permitindo ser criada. 

==== Predefinições Organizadoras  ====

Para que os predefinições sejam eficazes, os usuários precisam encontrá-las e serem capazes de usá-los. Uma técnica simples é incluir um exemplo na página da predefinição. Por exemplo 
<div style="width: auto; display: table"><pre>&lt;noinclude&gt; 
== Uso == 
Permite estabelecer um link para um assunto: 
{{NameOfTemplate|Term1+Term2+Term3}} 
&lt;/noinclude&gt; 
</pre></div> 
Em seguida, um editor pode simplesmente copiar e colar o exemplo criando uma página similar. 

== Copiar de uma wiki para outra  ==

As predefinições muitas vezes exigem [http://meta.wikimedia.org/wiki/Help:CSS CSS] ou outras predefinições, assim os usuários freqüentemente têm problemas de copiar predefinições de uma wiki para outra. Os passos a seguir devem funcionar para a maioria das predefinições: 

=== Se você tiver direitos de importação sobre a nova wiki  ===

#Vá para [[Especial:Export]] na wiki original. Digite o nome da predefinição na caixa de texto grande, marque a opção "Incluir predefinições" e clique em Exportar. Isto irá baixar um arquivo .xml. 
#Vá para [[Especial:Import]] na nova wiki e carregue o arquivo .xml. 
#Procure por classes CSS (como class="foobar") no texto da predefinição. Se estas classes aparecerem em "MediaWiki:Common.css" ou "MediaWiki:Monobook.css" na wiki original, copie "MediaWiki:Common.css" para a nova wiki. 
#Se a predefinição usa [[Ajuda:Palavras mágicas#Fun.C3.A7.C3.B5es_do_analisador|Funções do analisador]], você tem que instalar {{mediawiki|Extension:ParserFunctions|ParserFunctions extension}}.

=== Se você não tem direitos de importação na nova wiki  ===

#Copie o texto da predefinição para a nova wiki; faça o link para a página original no sumário de edição para atribuição. 
#Edite a predefinição na nova wiki, e dê uma olhada na lista de predefinições na parte inferior. As que estiverem em vermelho também precisarão ser copiados da wiki original para a nova wiki. Você pode ter que repetir este processo várias vezes antes que todas as predefinições de dependência tenham sidos reconhecidas e copiadas. 
#Olhe para as classes CSS (como class="foobar") no texto da predefinição. Se todas as classes aparecem em "MediaWiki:Common.css" ou "MediaWiki:Monobook.css" na wiki original, copie "MediaWiki:Common.css" para a nova wiki. 
#Se a predefinição usa [[Ajuda:Palavras mágicas#Fun.C3.A7.C3.B5es_do_analisador|Funções do analisador]], você tem que instalar {{mediawiki|Extension:ParserFunctions|ParserFunctions extension}}.

== Ver também  ==

*[[FamilySearch Wiki:Predefinições de manutenção|FamilySearch Wiki:Predefinições de manutenção]] - uma lista gráfica de códigos de predefinição de manutenção e as caixas que eles geram. 
*[[Ajuda:Pesquisas Externas]] -uma predefinição especial usa exemplo de caso 
*[[Ajuda:Palavras mágicas]] - fantasia coisas que você pode encontrar em alguns predefinições 
*[[Ajuda:Funções Parser em predefinições]] 
*[[Ajuda:Transclusão]] 
*{{meta|Help:Template}} - contém um manual muito mais completo sobre como predefinições exatamente funcionam 
*{{meta|Help:Embed page}} - incorpora páginas a partir de [[Ajuda:Namespaces|namespaces]] que não são <code>Predefinição:</code>.

{{Contributor help-navbox}} 

{{Editing help}} 

{{H-langs|es=Ayuda:Plantillas|en=Help:Templates|pt=Ajuda:Predefinições}} 
</div> 
[[Category:Ajuda]] [[Category:Templates]]