Ir para o conteúdo

Predefinição:Texto de exemplo/doc

De Wiki TokuDrive

{{#invoke:Message box|mbox}}

A predefinição {{Texto de exemplo}} faz parte de uma família de predefinições usada para destacar exemplos em páginas de ajuda, documentação e outras páginas internas da Wikipédia. Essas predefinições não devem ser usadas em artigos.

Uso

O primeiro parâmetro contém o texto a ser formatado:

{{Texto de exemplo|Exemplo}}

Se o texto contiver um sinal de igual (=), indique explicitamente o primeiro parâmetro, deste modo:

{{Texto de exemplo}}

O parâmetro título, também aceito como title ou titulo, acrescenta uma dica exibida ao passar o cursor sobre o exemplo:

{{Texto de exemplo|Exemplo}}

O conteúdo dessa dica deve ser texto simples, sem marcação wiki.

Variantes

As predefinições da família distinguem exemplos corretos, incorretos, desaconselhados e neutros. Há três formas tipográficas: a padrão, em negrito e monoespaçada. Há também variantes próprias para exemplos em bloco e para texto incorreto riscado.”

Por WP:ACESSIBILIDADE, a cor não deve ser a única forma de indicar se um exemplo é correto ou incorreto. Quando isso não estiver claro pelo contexto, identifique-o também no próprio texto com expressões como «correto», «incorreto», «não use», «evite» ou «desaconselhado». Para que a distinção não dependa apenas da percepção das cores, são úteis as variantes que também alteram a tipografia, por exemplo usando fonte monoespaçada. Isso é importante tanto para pessoas com deficiência na percepção de cores quanto para leitores que utilizem tecnologias assistivas.

Os atalhos antigos, derivados dos nomes em inglês, são mantidos por compatibilidade.

Predefinição Atalho Atalho legado Uso
{{Texto de exemplo}} {{TE}} {{Xt}} Exemplo correto ou recomendado
{{Texto de exemplo incorreto}} {{!TE}} {{!xt}} Exemplo incorreto ou que não deve ser seguido
{{Texto de exemplo desaconselhado}} {{TED}} {{Xtd}} Exemplo desaconselhado ou obsoleto
{{Texto de exemplo neutro}} {{TEN}} {{Xtn}} Exemplo neutro, sem indicar recomendação ou reprovação
{{Texto de exemplo em negrito}} {{NTE}} {{Bxt}} Exemplo correto ou recomendado em negrito
{{Texto de exemplo em negrito incorreto}} {{!NTE}} {{!bxt}} Exemplo incorreto em negrito
{{Texto de exemplo em negrito desaconselhado}} {{NTED}} {{Bxtd}} Exemplo desaconselhado em negrito
{{Texto de exemplo em negrito neutro}} {{NTEN}} {{Bxtn}} Exemplo neutro em negrito
{{Texto de exemplo monoespaçado}} {{MTE}} {{Mxt}} Exemplo correto ou recomendado em fonte monoespaçada
{{Texto de exemplo monoespaçado incorreto}} {{!MTE}} {{!mxt}} Exemplo incorreto em fonte monoespaçada
{{Texto de exemplo monoespaçado desaconselhado}} {{MTED}} {{Mxtd}} Exemplo desaconselhado em fonte monoespaçada
{{Texto de exemplo monoespaçado neutro}} {{MTEN}} {{Mxtn}} Exemplo neutro em fonte monoespaçada
{{Texto de exemplo em bloco}} {{TEB}} {{Xt2}}

Exemplo correto ou recomendado em bloco

{{Texto de exemplo incorreto em bloco}} {{!TEB}} {{!xt2}}

Exemplo incorreto em bloco

{{Texto de exemplo incorreto riscado}} {{!TER}} {{!xts}} Exemplo incorreto riscado

Parâmetros

<syntaxhighlight lang="wikitext" inline style="display
none;" />|1=
Texto a ser formatado.
<syntaxhighlight lang="wikitext" inline style="display
none;" />|título=
Texto exibido como dica ao passar o cursor sobre o exemplo.

<templatedata> { "description": "Formata um texto como exemplo em páginas de ajuda, documentação e outras páginas internas da Wikipédia.", "params": { "1": { "label": "Texto", "description": "Texto a ser apresentado como exemplo.", "type": "content", "suggested": true }, "título": { "label": "Título", "description": "Texto simples exibido como dica ao passar o cursor sobre o exemplo.", "type": "string", "aliases": [ "title", "titulo" ] } }, "paramOrder": [ "1", "título" ], "format": "inline" } </templatedata>

Ver também

  • {{Ênfase negativa}} — para avisos ou advertências negativas de alta visibilidade; ao contrário desta família, não representa um exemplo, mas dá ênfase semântica ao próprio conteúdo.