Wikilivros:Exemplos para testes: diferenças entre revisões

[edição não verificada][edição não verificada]
Conteúdo apagado Conteúdo adicionado
tradução
ajustes (finais?)
Linha 1:
As [[Ajuda:Como criar predefinições|predefinições]] são uma ferramenta muito poderosa do [[w:MediaWiki|MediaWiki]], mas é possível cometer erros muito facilmente, mesmo entre os usuários mais experientes. Por este motivo, as predefinições mais complexas devem ser acompanhadas de uma '''página para testes''' e alguns '''[[w:Especial:Busca/Caso de teste|casosexemplos depara testetestes]]''' para evitar ''bugs'' e outros problemas.
 
== Em que tipo de predefinições isto deve ser usado? ==
Linha 15:
Além disso, a predefinição não deve ter blocos <code><nowiki><includeonly></nowiki></code> e <code><nowiki><noinclude></nowiki></code> demais. Idealmente haveria apenas um bloco <code><nowiki><includeonly></nowiki></code>, colocado ao final da página da predefinição, contendo a {{tl|Documentação}} da predefinição.
 
== Como criar as subpáginas /testesTestes e /casosExemplos depara testetestes ==
 
1: Suponha que a sua predefinição se chama <code>Predefinição:X</code>. Crie uma subpágina chamada <code>Predefinição:X/Testes</code> e outra com o nome <code>Predefinição:X/Exemplos para testes</code>. Quando estas páginas estão presentes, a documentação inserida com a {{tl|Documentação}} fornece ligações para tais páginas automaticamente. Note que apenas a primeira letra de "'''T'''estes" e "'''E'''xemplos para testes" está em maiúscula.
 
2: Copie apenas o código (tudo que não estiver entre as marcações <code><nowiki><noinclude></nowiki></code>) da sua <code>Predefinição:X</code> para <code>Predefinição:X/Testes</code> e adicione o seguinte no final da última linha (na mesma linha):
:<code style="display:table; line-height:1.2em;">&lt;noinclude><br><br><nowiki>{{templateAviso/Testes sandboxcom noticepredefinições}}</nowiki><br>&lt;/noinclude></code>
 
Em outras palavras, o resultado deve ser:
 
:<code style="display:table; line-height:1.2em;"><span style="background-color: #FFFF66">[-- Código da predefinição --]</span>&lt;noinclude><br><br><nowiki>{{templateAviso/Testes sandboxcom noticepredefinições}}</nowiki><br>&lt;/noinclude></code>
 
'''Note!''' O código da predefinição deve começar imediatamente antes e literalmente encostar na marcação <code>&lt;noinclude></code>. Qualquer espaço em branco ou quebra de linha entre o código da predefinição e a marca <code>&lt;noinclude></code> pode fazer com que a predefinição renderize espaços ou quebras de linha indesejáveis quando for utilizada.
 
3: Copie alguns exemplos de inclusão de (<nowiki>{{</nowiki>'''X''' | .... }}</nowiki>) das páginas para a sua <code>Predefinição:X/Exemplos para testes</code>. Na página com os exemplos para testetestes, duplique cada exemplo e para uma cópia de cada exemplo substitua <code>X</code> por <code>X/Testes</code>. Isto é feito para que você possa comparar o resultado antigo com o novo resultado da predefinição próximos um do outro no futuro. Finalmente, adicione a seguinte linha ao início da página com os exemplos. Não faz diferença quantas linhas em branco você irá colocar em torno dela:
:<code style="display:table; line-height:1.2em;"><nowiki>{{templateAviso/Exemplos testpara casestestes noticecom predefinições}}</nowiki></code>
 
4: Agora o código wiki a <code>Predefinição:X/Exemplos para testes</code> irá se parecer com isto:
<pre>
{{Aviso/Exemplos para testes com predefinições}}
{{template test cases notice}}
 
{{X | foo |Algo}}
{{X/sandbox Testes| fooAlgo}}
 
{{X |Algo barmais}}
{{X/sandbox Testes|Algo barmais}}
</pre>
 
4b: Para que fique fácil de identificar as diferenças entre as duas versões da predefinição, você pode usar a [[Predefinição:Exemplos para testetestes]]. Então os exemplos que realmente foram alterados ao se editar a página de testes serão realçados de modo que você possa ter certeza de que cada mudança foi realmente intencional.
 
== Como usar as páginas posteriormente ==
Linha 59:
* [[w:Predefinição:Teste]]
* [[w:en:Wikipedia:High-risk templates]]
* [[wPredefinição:en:Template:templateAviso/Testes sandboxcom noticepredefinições]] – A ser inserida no final das páginas de teste das predefinições.
* [[wPredefinição:en:Template:templateAviso/Exemplos para testtestes casescom noticepredefinições]] – A ser inserida no topo das páginas com exemplos para testes.
 
[[Categoria:Predefinições|{{PAGENAME}}]]