Predefinição:Ppoem

Documentação da predefinição[ver] [editar] [histórico] [purgar]

Uso

Ppoem (Proper Poem)

Parâmetros

• 1 o poema em si
• gutter left (esquerda), right (direita) or both (ambos). Use quando houver número de linha our verso e estas não ocorrem na primeira ocorrência desta predefinição .
• class quaisquer classes extras a serem aplicadas na div do poema
• align alinhamento da div do poema.
• style quaisquer estilos extras a serem aplciados na div do poema
• lang o código de idioma do poema, caso seja necessário especificar (ex. fr ou la).

Special syntax:

• Linhas que iniciam com >> são alinhadas à direita.
• Linhas que iniciam com <> são centralizadas.
• Linhas que terminam com >>> XXX possuem um número de linha “XXX” à direita, depois da margem.
• Linhas que iniciam com XXX <<< possuem um número de linha/verso “XXX” à esquerda, além da margem esquerda.
• Linhas que iniciam com {class} têm aplicada uma classe HTML ws-poem-class.
• Espaços em branco antes do verso são convertidos em  
• Dois-pontos (:) antes do verso são convertidos em  

É possível controlar estrofes com um sintaxe semelhante:

• Linhas em branco dão início a uma nova estrofe na liha seguinte.
• Estrofes prefixadas com {classe} possuem classe HTML ws-poem-class aplicada a toda a estrofe.
• Estrofes prefixadas com >> são alinhas em bloco à direita.
• Estrofes prefixadas com <> são alinhadas em bloco no centro.

Exemplo

{{ppoem|
1 <<< {{di|E}}m certo dia, á hora, á hora
Da meia-noite que apavora,
Eu, cahindo de somno e exausto de fadiga,
Ao pé de muita lauda antiga,
      De uma velha doutrina, agora morta,
      Ia pensando, quando ouvi á porta
      Do meu quarto um soar devagarinho,
E disse estas palavras taes:
«É alguem que me bate á porta de mansinho; >>> 5
::::::{raven_green} «Ha de ser isso e nada mais.»
>> {{sc|The Raven}}

{raven_green}
2 <<< Esta estrofe tem a classe <code>raven_green</code> aplicada
A toda a estrofe.

>>
Esta estrofe é alinhada à direita
Assim

<>
E esta estrofe é centralizada em bloco
Assim

<> ''Fim''>>
Esta estrofe é alinhada à direita
Assim

<>
E esta estrofe é centralizada em bloco
Assim

>> {{sc|O Corvo}}

<> ''Fim''
}}

1 Em certo dia, á hora, á horaDa meia-noite que apavora,Eu, cahindo de somno e exausto de fadiga,Ao pé de muita lauda antiga,      De uma velha doutrina, agora morta,      Ia pensando, quando ouvi á porta      Do meu quarto um soar devagarinho,E disse estas palavras taes:5«É alguem que me bate á porta de mansinho;      «Ha de ser isso e nada mais.»

2 Esta estrofe tem a classe raven_green aplicadaA toda a estrofe.

Esta estrofe é alinhada à direitaAssim

E esta estrofe é centralizada em blocoAssim

O Corvo

Fim

As linhas têm um recuo suspenso padrão de 4em, que é aproximadamente consistente com a maioria das poesias impressas.

Exemplo

{{block center|width=25em|style=border:1px solid red;|
{{ppoem|
Em certo dia, á hora, á hora
         Da meia-noite que apavora,
Eu, cahindo de somno e exausto de fadiga,
         Ao pé de muita lauda antiga,
      De uma velha doutrina, agora morta,
      Ia pensando, quando ouvi á porta
      Do meu quarto um soar devagarinho,
         E disse estas palavras taes:
«É alguem que me bate á porta de mansinho;
         «Ha de ser isso e nada mais.»
}}
}}

Em certo dia, á hora, á hora         Da meia-noite que apavora,Eu, cahindo de somno e exausto de fadiga,         Ao pé de muita lauda antiga,      De uma velha doutrina, agora morta,      Ia pensando, quando ouvi á porta      Do meu quarto um soar devagarinho,         E disse estas palavras taes:«É alguem que me bate á porta de mansinho;         «Ha de ser isso e nada mais.»

Ele pode ser desativado atribuindo qualquer valor a no_hi.

Quebras de página

O template funciona através de quebras de página e produz um único contêiner de poema (diferente da tag <poem>).

Os parâmetros start e end controlam como as seções se conectam. Cada um tem quatro opções: open/close (padrão), follow, stanza e same-line:

• Para a primeira seção, use start=open (ou simplesmente omita o parâmetro)
• Para uma seção que termina uma estrofe, use end=stanza, e inicie a próxima com start=stanza
• Para uma seção que não termina uma estrofe (então a próxima seção continua na mesma estrofe), a primeira define end=follow e a seguinte usa start=follow
• Para uma linha que continua na página seguinte, a primeira seção define end=same-line e a próxima usa start=same-line
• Para a última seção, use end=close (ou omita)

Isso significa que o parâmetro end de uma seção e o start da próxima devem sempre coincidir. Também significa que, para um poema simples em uma única seção, você não precisa usar start nem end.

Por exemplo, para um template que abrange quatro páginas:

Exemplo

{{ppoem|end=follow|
Esta é a primeira
página e a estrofe
}}

{{ppoem|start=follow|end=stanza|
continua nesta página.

Mas então, a segunda
página termina no final
de uma estrofe.}}

{{ppoem|start=stanza|end=same-line|
E a página seguinte
é uma nova estrofe.
Então há uma linha realmente longa
}}

{{ppoem|start=same-line|end=close|
''que continua para a próxima página.''

E por fim linhas
normais até o fim.
}}

Esta é a primeirapágina e a estrofe continua nesta página.

Mas então, a segundapágina termina no finalde uma estrofe.

E a página seguinteé uma nova estrofe.Então há uma linha realmente longa que continua para a próxima página.

E por fim linhasnormais até o fim.

Na página namespace, o template sempre abre e fecha as tags ppoem, então ele aparecerá corretamente tanto na página quanto no domínio principal (desde que quaisquer ppoems adjacentes nas páginas anterior/seguinte usem parâmetros start e end correspondentes).

Capitulares

Conteúdos flutuantes, como {{dropinitial}}, devem ser colocados normalmente:

Exemplo

{{ppoem|
{{Capitular|A|ficheiro=InicialA.svg|tamanho=50px}}s armas e os Barões assinalados,
Que da Ocidental praia Lusitana,
Por mares nunca de antes navegados,
Passaram ainda além da Taprobana,
Em perigos e guerras esforçados,
Mais do que prometia a força humana,
E entre gente remota edificaram
Novo Reino, que tanto sublimaram.

{{Capitular|A}}s armas e os Barões assinalados,
Que da Ocidental praia Lusitana,
Por mares nunca de antes navegados,
Passaram ainda além da Taprobana,
Em perigos e guerras esforçados,
Mais do que prometia a força humana,
E entre gente remota edificaram
Novo Reino, que tanto sublimaram.

{{Capitular|A|fl="}}s armas e os Barões assinalados,
Que da Ocidental praia Lusitana,
Por mares nunca de antes navegados,
Passaram ainda além da Taprobana,
Em perigos e guerras esforçados,
Mais do que prometia a força humana,
E entre gente remota edificaram
Novo Reino, que tanto sublimaram.
}}

s armas e os Barões assinalados,Que da Ocidental praia Lusitana,Por mares nunca de antes navegados,Passaram ainda além da Taprobana,Em perigos e guerras esforçados,Mais do que prometia a força humana,E entre gente remota edificaramNovo Reino, que tanto sublimaram.

As armas e os Barões assinalados,Que da Ocidental praia Lusitana,Por mares nunca de antes navegados,Passaram ainda além da Taprobana,Em perigos e guerras esforçados,Mais do que prometia a força humana,E entre gente remota edificaramNovo Reino, que tanto sublimaram.

"As armas e os Barões assinalados,Que da Ocidental praia Lusitana,Por mares nunca de antes navegados,Passaram ainda além da Taprobana,Em perigos e guerras esforçados,Mais do que prometia a força humana,E entre gente remota edificaramNovo Reino, que tanto sublimaram.

Chaves

Linhas entre chaves funcionam como esperado (usando a sintaxe >>> para alinhamentos à direita):

Exemplo

{{ppoem|
Tinir de ferros… estalar de açoite…
Legiões de homens negros como a noite,
Horrendos a dançar…
Negras mulheres, suspendendo às tetas
Magras crianças, cujas bocas pretas >>> {{brace2|3|r}}
Rega o sangue das mães…
Outras, moças, mas nuas e espantadas…
}}

Tinir de ferros… estalar de açoite…Legiões de homens negros como a noite,Horrendos a dançar…Negras mulheres, suspendendo às tetas$\scriptstyle {\left.{\begin{matrix}\ \\\\\ \ \end{matrix}}\right\}\,}$Magras crianças, cujas bocas pretasRega o sangue das mães…Outras, moças, mas nuas e espantadas…

Largura da calha (gutter)

Alguns poemas têm números de linha muito longos. Nesse caso, a largura padrão da calha, de 2em, pode não ser suficiente. É possível modificar a largura das calhas usando o CSS baseado em índice e definir um padding maior à esquerda ou à direita dos elementos .ws-poem-line relevantes.

Poemas com calha à esquerda são identificados pela classe .ws-poem-left-gutter no contêiner principal do poema, adicionada automaticamente quando se usa a sintaxe <<< ou quando gutter é definido como left ou both. As calhas à direita (sintaxe >>> ou gutter definido como right ou both) funcionam da mesma forma.

No caso abaixo, cada poema em um determinado volume que possui gutter à esquerda tem o padding das linhas aumentado para 3em:

/* Aumentar o gutter porque os números de linha têm até 4 dígitos */
.ws-poem-left-gutter .ws-poem-line {
	padding-left: 3em;
}

Comparação com <poem>

A seguir está uma comparação entre a saída deste template e a da tag <poem> (ou <br/> manual, que é equivalente), quando renderizados como EPUB em um e-reader.

Com a tag poem/<br/>:

Com {{ppoem}}, há recuos suspensos e alinhamento à direita sem causar quebra de parágrafo:

Vantagens

• Sintaxe simples para casos comuns
• Lida com recuo suspenso, resolvendo o problema de novas linhas ambíguas
• Semanticamente mais correto: versos são spans, estrofes são parágrafos, poemas são divs
• Permite continuar uma linha através de uma quebra de página (impossível com <poem>)
• Combina tudo em um único elemento mesmo quando transcluído de múltiplas páginas
• Copiar e colar preserva as linhas separadas
• Exporta de forma coerente
• Centralização automática em bloco (o que não é possível com <poem> porque os elementos separados não têm a mesma largura)
• Muito fácil aplicar classes CSS a versos ou estrofes
• Substituição direta da tag <poem>

Desvantagens

• É preciso atenção ao casar os parâmetros start e end entre páginas.
• Capitulares podem às vezes forçar quebra antecipada da linha (contornável adicionando comprimento à primeira linha, como com {{em}}).
• Por ser um único template e não poder ser dividido, poemas precisam escapar caracteres = e |^[1]

Notas

1. Exceto se isso se tornar uma extensão.

Dados do Template

This is the TemplateData for this template used by TemplateWizard, Editor Visual and other tools.

TemplateData for Ppoem

Formata um poema de maneira adequada

Parâmetros do modelo[Editar dados da predefinição]

Este modelo prefere a formatação em linha dos parâmetros.

Parâmetro		Descrição	Tipo	Estado
1	1	O conteúdo do poema Exemplo Em certo dia, á hora, á hora / Da meia-noite que apavora, / Eu, cahindo de somno e exausto de fadiga,	Conteúdo	obrigatório
start	start	Tipo de início: um entre open, stanza, follow, same-line. Se não for "open", deve usar o mesmo valor que o parâmetro "end" do ppoem anterior. Exemplo stanza	Linha	sugerido
end	end	Tipo de fechamento: um entre close, stanza, follow, same-line. Se não for "close", o próximo ppoem deve usar o mesmo valor no parâmetro "start". Exemplo stanza	Linha	sugerido
lang	lang	Código de idioma a aplicar a todo o poema Valores sugeridos en fr grc la es de ang enm it Exemplo la	Linha	opcional
class	class	Classes CSS a serem adicionadas ao poema inteiro. Use para estilizar todo o poema via CSS. Exemplo chapter-head-poem	Linha	opcional

Veja Também

• en:Help:Poetry