Exibir código-fonte para Predefinição:Texto de exemplo/doc

{{Subpágina de documentação}}

A predefinição {{tlx|{{ROOTPAGENAME}}}} 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:

{{tlx|Texto de exemplo|Exemplo}}

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

{{tlx|Texto de exemplo|1{{=}}a = b}}

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

{{tlx|Texto de exemplo|Exemplo|título=Explicação do 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.

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

== Parâmetros ==

; {{parâmetro|1}}
: Texto a ser formatado.

; {{parâmetro|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 ==

* {{lp|Ê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.

<includeonly>
<!-- Categorias abaixo desta linha, por favor; interwikis no Wikidata -->
[[Categoria:!Predefinições de formatação de exemplos]]
</includeonly>