Se você não conseguir editar a wiki após o login, você precisará solicitar direitos de edição usando este formulário. Você será notificado assim que tais direitos de edição lhe forem concedidos.

Ajuda:Predefinições

Da wiki FamilySearch Wiki
Saltar para a navegação Saltar para a pesquisa
Help-content.png Este "artigo de ajuda" irá guiá-lo como você editar na Wiki. Veja Editar e contribuir para mais artigos de ajuda.


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[editar | editar código-fonte]

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

Uso[editar | editar código-fonte]

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

  • {{Nome}} 'transcluem' (isto é, incluem uma cópia ) do conteúdo da predefinição (armazenados na página [[Predefinição:Nome]]) 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.
  • {{subst:Nome}} 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.
  • {{msgnw:Nome}} 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:

  • {{Predefinição:Pagename}} inclui [[Predefinição:Pagename]]
  • {{Foo:Pagename}} inclui [[Foo:Pagename]]
  • {{:Pagename}} inclui [[Pagename]]
    • {{subst::Pagename}} substitui ela mesma com o conteúdo da [[Pagename]]

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

  • {{Foo:Bar}} inclui [[Predefinição:Foo:Bar]]

Parâmetros[editar | editar código-fonte]

Predefinição com parâmetros numerados
 
'''Um pequeno agradecimento...'''<br /> 
<small>for {{{1}}}.<br /> 
hugs, {{{2}}}</small> 
Você digita Você tem
{{Obrigado|por todo o seu trabalho árduo|José}}

Predefinição:Obrigado

com nomes como parâmetros
 
'''Um pequeno agradecimento...'''<br /> 
<small>for {{{razão}}}.<br /> 
hugs, {{{assinatura}}}</small> 
Você digita Você tem
{{Obrigado 
|razão=por todo o seu trabalho árduo 
|assinatura=José}}

Predefinição:Obrigado


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 ({{{ e }}}) 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 (|): {{Obrigado|por todo o seu trabalho árduo|José}}. Para parâmetros com nomes use "nome=valor" separados por barras: {{Obrigado|razão=por todo o seu trabalho árduo|assinatura=José}}. 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: {{Obrigado|2=José|1=por todo o seu trabalho árduo}}.

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, {{{razão|por todo o seu trabalho árduo}}} resultará em "por todo o seu trabalho árduo" se nenhum valor for informado para o parâmetro razão.

Controle de Inclusão de predefinição[editar | editar código-fonte]

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

Qualquer coisa entre <noinclude> e </noinclude> 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 é <includeonly>. O texto entre <includeonly> e </includeonly> 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 categoria, sem colocar a predefinição em si nessa categoria.

Documentação[editar | editar código-fonte]

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 sub-página da página do predefinição (chamado "Template:XXX/doc"). Isto também se aplica a muitas predefinições protegidas (para permitir que a informação seja editada por não-administradores). Isto é conseguido, colocando a predefinição {{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[editar | editar código-fonte]

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

<noinclude> 
== Uso == 
Permite estabelecer um link para um assunto: 
{{NameOfTemplate|Term1+Term2+Term3}} 
</noinclude> 

Em seguida, um editor pode simplesmente copiar e colar o exemplo criando uma página similar.

Copiar de uma wiki para outra[editar | editar código-fonte]

As predefinições muitas vezes exigem 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[editar | editar código-fonte]

  1. 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.
  2. Vá para Especial:Import na nova wiki e carregue o arquivo .xml.
  3. 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.
  4. Se a predefinição usa Funções do analisador, você tem que instalar ParserFunctions extension.

Se você não tem direitos de importação na nova wiki[editar | editar código-fonte]

  1. 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.
  2. 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.
  3. 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.
  4. Se a predefinição usa Funções do analisador, você tem que instalar ParserFunctions extension.

Ver também[editar | editar código-fonte]