Predefinição:Markupv/doc

Esta é uma subpágina de documentação para a Predefinição:Markupv.
Ela contém informações sobre o seu uso, categorias, bem como todo o conteúdo que não faz parte da predefinição original.

Uso

Esta predefinição é usada para apresentar marcação ou código em um formato vertical acima da saída renderizada.

Parâmetros:

markup ou m: Conteúdo da célula Marcação
renders ou r: Conteúdo da célula Renderiza como
title ou t: Título da tabela; o padrão é nenhum
margin: Definir margem esquerda da tabela em em
width: Largura da tabela; o padrão é 90%
style: Folhas de estilos em cascatas (F.E.C.^[a]) adicionais para a tabela

A célula Marcação é pré-formatada com <pre> para reter novas linhas e espaços, mas estilizada para permitir que o conteúdo seja agrupado dentro da célula. Geralmente, é desejável escapar do conteúdo da célula Marcação para que a marcação seja exibida agrupando a marcação em <nowiki>. Não é tecnicamente possível adicionar esse recurso à predefinição.

Na célula Renderização, o conteúdo geralmente é a marcação sem escape copiada da célula Marcação. Há casos em que isso pode diferir:

Se a primeira linha incluir marcação wiki que deve começar em uma nova linha como #, * ou ; então use <nowiki /> antes da primeira linha.
A marcação de cabeçalho, como ==, é exibida no índice (tabela de conteúdo (T.D.C.^[b]) da página; use {{Fake heading}} para contornar tal efeito.
Ao usar {{Reflist}} sem outros parâmetros, use {{Reflist|close=1}} para garantir que a lista de referência seja fechada.
Algumas predefinições colocarão a página em uma categoria de manutenção, o que geralmente é indesejado:
- Em vez de {{Carece de fontes}}, use {{Carece de fontes falso}}.
Algumas predefinições podem ter verificações de erros que colocam a página em uma categoria de manutenção.
- Predefinições Citation Style 1 [en] podem suprimir a categoria de manutenção configurando |template doc demo=true.

Exemplos

O seguinte meta-exemplo usa a {{Markupv}} para criar um exemplo de uso da marcação <score>...</score>:

{{Markupv|title=Exemplo:
|markup=<nowiki><nowiki><score>\relative c' { c( b~ c b c b c b c~ c)}</score></nowiki></nowiki>
|renders=<score>\relative c' { c( b~ c b c b c b c~ c)}</score>
}}

Ele gera:

Exemplo:
Marcação	<score>\relative c' { c( b~ c b c b c b c~ c)}</score>
Renderização	$\relative c' { c( b~ c b c b c b c~ c)}$

Limitações

Se você não agrupar o conteúdo da célula de marcação em <nowiki>, qualquer marcação de predefinição não terá escape, ela será expandida.

Este exemplo mostra a marcação para {{Tl|tag}}:

Marcação	<span style="white-space:nowrap;">{{</span>[[Predefinição:tag\|tag]]<span style="white-space:nowrap;">}}</span>
Renderização	{{Tl\|tag}}

As entidades da linguagem de marcação de hipertexto (L.M.Ht.^[c]) são analisadas na célula de marcação

Marcação	–
Renderização	–

Para contornar isso, substitua o & por & então &nbsp; vai aparecer como  

Exemplos

Exemplos simples:

Marcação	'''Texto em negrito'''
Renderização	Texto em negrito

Marcação	''Texto em itálico''
Renderização	Texto em itálico

Exemplo complexo:

Observe que o segundo argumento para {{Markupv}} usa {{Fake heading}} e {{Carece de fontes falso}}.

Marcação

A rápida raposa marrom pula sobre o cachorro preguiçoso.{{#tag:ref|Uma nota de rodapé.<ref>Uma referência para a nota de rodapé.</ref>|group=nb}} A vaca pulou sobre a lua.{{Carece de fontes}}

== Notas ==
{{Reflist|group=nb}}

== Referências ==
{{Reflist}}

Renderização

A rápida raposa marrom pula sobre o cachorro preguiçoso.^{[nb 1]} A vaca pulou sobre a lua.^{[carece de fontes]}

Notas

↑ Uma nota de rodapé.^[1]

Referências

↑ Uma referência para a nota de rodapé.

Com título:

Raposas e cachorros
Marcação	A rápida raposa marrom pula sobre o cachorro preguiçoso.
Renderização	A rápida raposa marrom pula sobre o cachorro preguiçoso.

Quando uma predefinição é incluída em {{Código}}, ela mostra a linguagem de marcação de hipertexto (L.M.Ht.^[c]) renderizada:

Marcação	{{Citar livro \|último=White \|primeiro=T. H. \|título=The book of Merlyn \|ano=1977}}
Renderização	White, T. H. (1977). The book of Merlyn. [S.l.: s.n.]

Marcação	{{Código\|{{Citar livro \|último=White \|primeiro=T. H. \|título=The book of Merlyn \|ano=1977}}}}
Renderização	`<cite class="citation book">White, T. H. (1977). ''The book of Merlyn''. [S.l.: s.n.]</cite><span title="ctx_ver=Z39.88-2004&rfr_id=info%3Asid%2Fpt.wikipedia.org%3APredefini%C3%A7%C3%A3o%3AMarkupv%2Fdoc&rft.aufirst=T.+H.&rft.aulast=White&rft.btitle=The+book+of+Merlyn&rft.date=1977&rft.genre=book&rft_val_fmt=info%3Aofi%2Ffmt%3Akev%3Amtx%3Abook" class="Z3988"><span style="display:none;"> </span></span>`

Ver também

{{Markup}}: marcações lado a lado
{{Markup2}}: marcações com marcadores e recuos
{{Markupv}}: marcações acima e abaixo

Notas

↑ do inglês C.S.S. – cascading style sheets
↑ do inglês T.O.C. – table of content
↑ ^a ^b do inglês Ht.M.L. – hypertext markup language

[5] Uma nota de rodapé.^[1]

[4] Uma referência para a nota de rodapé.

[css-1] ês C.S.S. – cascading style sheets

[toc-2] ês T.O.C. – table of content

[html-3] ês Ht.M.L. – hypertext markup language

[a]

[b]

[c]

[nb 1]

[1]