Wikipédia:Predefinições de testes e exemplos para testes
As predefinições são uma ferramenta muito poderosa do MediaWiki, mas é muito fácil cometer erros, mesmo sendo um usuário mais experiente. Por este motivo, as predefinições mais complexas devem vir acompanhadas de uma página para testes e alguns exemplos para testes para prevenir bugs.
Em que tipo de predefinições isto deve ser usado?
[editar código-fonte]É recomendado usar o padrão de exemplos para testes nas predefinições que utilizam ParserFunctions e que geram resultados bastante diferentes dependendo dos parâmetros que são passados, ou que têm muitos casos em um operador #switch
.
Para as caixas de navegação cujo resultado é quase sempre o mesmo em cada página que as utiliza, o benefício pode não valer o esforço e o tempo adicional de se criarem os exemplos para testes.
É claro que toda predefinição que seja incluída em milhares de páginas deve ser testada antes de se fazer uma edição.
Como criar as subpáginas /Testes e /Exemplos para testes
[editar código-fonte]- Suponha que a sua predefinição se chama
Predefinição:X
. Crie uma subpágina chamadaPredefinição:X/Testes
. Se a predefinição principal estiver utilizando a predefinição{{Documentação}}
, pode fazer isso a partir do link que aparece na parte inferior da caixa de documentação azul. Outra alternativa é digitar o nome no campo de pesquisa, ou diretamente na barra de URL do seu navegador. Note que apenas a primeira letra de "Testes" está em maiúscula. - Copie todo o conteúdo da predefinição principal, incluindo os elementos
<noinclude>
e a predefinição{{Documentação}}
, se estiver presente, cole-o na janela de edição da subpágina de testes, e salve a página. Seu sumário de edição deverá ser algo como "criação da versão de testes da Predefinição:X"- Nota: se você utilizar o link para "espelho" na parte inferior da baixa de documentação azul, elementos como
<noinclude>
, e o seu conteúdo, ficarão faltando. É melhor simplesmente copiar e colar manualmente.
- Nota: se você utilizar o link para "espelho" na parte inferior da baixa de documentação azul, elementos como
- Crie outra subpágina com o nome
Predefinição:X/Exemplos para testes
. - Coloque a predefinição
{{Aviso para a página de exemplos de uma predefinição}}
no topo da página, inclua alguns exemplos para testes (ver abaixo) e salve a página. - Insira o seu código experimental na
Predefinição:X/Testes
. Para testar o seu código, salve a página, e vá para a página de exemplos para testes. Frequentemente você precisará purgar a página /Exemplos para testes para ver resultados atualizados; há um link para isso na predefinição{{Aviso para a página de exemplos de uma predefinição}}
. Depois de purgar a página, compare os resultados da predefinição principal com os da versão de testes, e se tudo estiver correto, pode atualizar a predefinição principal. No entanto, esteja ciente de que podem estar faltando alguns testes e de que alguns códigos só podem ser testados em certos domínios ou certas páginas.
Como usar as páginas posteriormente
[editar código-fonte]- Sincronize a página de testes da predefinição a partir do código original da predefinição (ou seja, execute o passo 2 explicado anteriormente);
- Divirta-se editando a página de testes
- Verifique os exemplos para testes
- Se parecer que tudo está como deveria, copie o código da página de testes para a predefinição verdadeira.
Se você prefere não comparar o resultado novo com o antigo como foi descrito anteriormente, é recomendado que você use um navegador que possua abas e abrir a subpágina com os exemplos antes de alterar a página de testes da predefinição, e outra depois de alterar a página de testes. Isto o ajudará a se certificar de que as mudanças estão sendo comparadas adequadamente.
Exemplos
[editar código-fonte]Teste com outros usuários - {{test-mode}}
[editar código-fonte]Se você estiver satisfeito com as alterações que fez na versão de testes, e com o que os exemplos para testes mostram, você pode considerar {{test-mode}}
. Isso permitirá que vários usuários naveguem pelas páginas da Wikipédia com a versão de testes de sua predefinição, e ainda assim não afetar ninguém mais que esteja exibindo tais páginas.
Ver também
[editar código-fonte]{{Aviso para a página de testes de uma predefinição}}
– Para inserir na parte inferior das páginas /Testes.{{Aviso para a página de exemplos de uma predefinição}}
– Para inserir no início das páginas /Exemplos para testes.{{template regression tests notice}}
– Para inserir no topo das páginas de /Testes de regressão.{{test-mode}}
– permite que os editores com "test-mode" ativado vejam as páginas da Wikipédia com a predefinição de testes em vez das versões públicas.- Predefinição:Teste – página de testes para predefinições
- Wikipédia:Predefinições em alto risco