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
![]() |
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.
Índice
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é}}
|
|
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é}} |
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.
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 job queue. |
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]
- 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 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]
- 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 Funções do analisador, você tem que instalar ParserFunctions extension.
Ver também[editar | editar código-fonte]
- 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
- MetaWiki:Help:Template - contém um manual muito mais completo sobre como predefinições exatamente funcionam
- MetaWiki:Help:Embed page - incorpora páginas a partir de namespaces que não são
Predefinição:
.
|