Plantilla:Ppoem

Documentació de la plantilla [ mostra ] [ modifica el codi ] [ mostra l'historial ] [ refresca ]

Descripció

Aquesta plantilla, el funcionament de la qual es troba a Mòdul:Ppoem, està dissenyada per a millorar, simplificar i estandarditzar la construcció de texts escrits en vers.

Paràmetres

• 1: versos als quals donar format

Els següents paràmetres son opcionals:

• gutter left, right u both. Feu servir això si els números de línia o de vers que utilitzeu no apareixen en la primera crida de la plantilla (es determina automàticament si ho fan).
• class: classes addicionals per al «div» "exterior".
• align: aliniament del text (per exemple center)
• style: estils addicionals extra per al «div» "exterior".
• lang: codi d'idioma (per exemple, fr or la, etc.)

Sintaxi especial

• Les línies que comencen amb >> s'alinien a la dreta.
• Les línies que comencen amb <> queden centrades.
• Les línies que acaben amb >>> XXX tenen un número de línia "XXX" a la seva dreta, després del marge dret.
• Les línies que comencen amb XXX <<< tenen un número de vers o de línia "XXX" al costat esquerre, després del marge esquerre.
• Les línies que comencen amb +XX> queden indentades XX línies. Es pot fer servir +> en lloc de +1>.
• Els espais inicials queden convertits en  .
• Els dos punts inicials queden convertits en  .

Podeu controlar les estrofes amb una sintaxi semblant:

• Les línies en blanc comencen una nova estrofa.
• Les estrofes prefixades amb {class} tenen una classe HTML anomenada ws-poem-class i aplica a tota les estrofes següents. Això s'aconsegueix mitjançant estils «TemplateStyles CSS» (alguns dels quals estan definits a Plantilla:Ppoem/styles.css).
• Les estrofes prefixades amb >> queden aliniades en bloc a la dreta.
• Les estrofes prefixades amb <> queden centrades.

{{ppoem|
1 <<< Once upon a midnight dreary, while I pondered, weak and weary,
Over many a quaint and curious volume of forgotten lore,
"While I nodded, nearly napping, suddenly there came a tapping,
 As of some one gently rapping, rapping at my chamber door.
"'Tis some visiter," I muttered, "tapping at my chamber door— >>> 5
::::::{handwriting} Only this, and nothing more."
>> {{sc|El Corb}}

{smallcaps}
2 <<< Aquesta estrofa té la classe <code>smallcaps</code> aplicada
A tota l'estrofa.
+>I aquesta línia reprèn l'anterior.

>>
Aquesta estrofa queda aliniada en bloc a la dreta
Aixís

<>
I aquesta estrofa queda centrada
Aixís

>> {{sc|El Corb}}

<> ''Fi del text''
}}

1 Once upon a midnight dreary, while I pondered, weak and weary,
Over many a quaint and curious volume of forgotten lore,
"While I nodded, nearly napping, suddenly there came a tapping,
 As of some one gently rapping, rapping at my chamber door.
5"'Tis some visiter," I muttered, "tapping at my chamber door—
      Only this, and nothing more."
El Corb

2 Aquesta estrofa té la classe smallcaps aplicada
A tota l'estrofa.
A tota l'estrofa.I aquesta línia reprèn l'anterior.

Aquesta estrofa queda aliniada en bloc a la dreta
Aixís

I aquesta estrofa queda centrada
Aixís

El Corb

Fi del text

Els versos tenen un sagnat sortint de 4 em per defecte, la qual cosa és més o menys coherent amb la majoria de la poesia impresa:

{{bloc centre|width=25em|style=border:1px solid red;|
{{ppoem|
Once upon a midnight dreary, while I pondered, weak and weary,
Over many a quaint and curious volume of forgotten lore,
While I nodded, nearly napping, suddenly there came a tapping,
As of some one gently rapping, rapping at my chamber door.
"'Tis some visiter," I muttered, "tapping at my chamber door—
::::::Only this, and nothing more."
}}
}}

Once upon a midnight dreary, while I pondered, weak and weary,
Over many a quaint and curious volume of forgotten lore,
While I nodded, nearly napping, suddenly there came a tapping,
As of some one gently rapping, rapping at my chamber door.
"'Tis some visiter," I muttered, "tapping at my chamber door—
      Only this, and nothing more."

Pot quedar deshabilitat afegint qualsevol valor al paràmetre no_hi.

Salts de pàgina

La plantilla funciona a través de salts de pàgina i produeix un únic contenidor de «poem» (a diferència de l'etiqueta <poem>).

Els paràmetres start i end controlen com s'ajunten les seccions. Cadascuna té quatre opcions: open/close (per defecte), follow, stanza i same-line:

• Per a la primera secció, useu start=open (o res)
• Per a la secció que termina una estrofa (en anglès, «stanza»), useu end=stanza, i comenceu la següent amb start=stanza
• Per aquella secció que acaba una estrofa (i, per tant, a continuació segueix la mateixa estrofa), la primera secció quedarà com end=follow i la següent necessitarà start=follow.
• Per una línia que continua a la següent pàgina, la primera secció ha de quedar com end=same-line i la següent usarà start=same-line.
• Per a la darrera secció, caldrà fer servir end=close (o res).

Això significa que el paràmetre end d'una secció i el paràmetre start de la següent han de ser el mateix. I això també significa que per un únic poema en una única secció no caldrà ni start ni end.

Per exemple, per a una plantilla que arreplega el contingut de quatre pàgines:

{{ppoem|end=follow|
Això es la primera pàgina
i la primera estrofa
}}

{{ppoem|start=follow|end=stanza|
continua en aquesta segona pàgina.

Però llavors, la segona
pàgina acaba coincidint amb el final de
una estrofa.}}

{{ppoem|start=stanza|end=same-line|
I la tercera pàgina
comença una estrofa nova
i llavors hi ha una llarga
}}

{{ppoem|start=same-line|end=close|
''línia que continua al llarg de la quarta pàgina.''

I finalment, línies
fins al final.
}}

Això es la primera pàgina
i la primera estrofa
continua en aquesta segona pàgina.

Però llavors, la segona
pàgina acaba coincidint amb el final de
una estrofa.

I la tercera pàgina
comença una estrofa nova
i llavors hi ha una llarga línia que continua al llarg de la quarta pàgina.

I finalment, línies
fins al final.

En l'espai de noms «Pàgina», la plantilla sempre obre i tanca les etiquetes «ppoem», de manera que apareixerà correctament tant a la pàgina com a l'espai de noms principal.

Caplletres

El contingut flotant, com les caplletres ({{Caplletra}}, es comporta sense cap variació:

{{ppoem|
{{Caplletra|B|image=Examination and confession-b24926760-025.jpg|imgsize=80px}}EHOLD these acts and scan them well
behold their pervers way:
These left the lord, these did his truth
which shold have ben their stay.

{{Caplletra|B}}EHOLD these acts and scan them well
behold their pervers way:
These left the lord, these did his truth
which shold have ben their stay.

{{Caplletra|B|fl="}}EHOLD these acts and scan them well
behold their pervers way:
These left the lord, these did his truth
which shold have ben their stay.
}}

<span class="dropinitial" style="margin-right:0.1em; color:#000000; background-color:
#FFFFFF; border:1px solid
#FFFFFF; ">BEHOLD these acts and scan them well
behold their pervers way:
These left the lord, these did his truth
which shold have ben their stay.

<span class="dropinitial" style="margin-right:0.1em; color:#000000; background-color:
#FFFFFF; border:1px solid
#FFFFFF; ">BEHOLD these acts and scan them well
behold their pervers way:
These left the lord, these did his truth
which shold have ben their stay.

<span class="dropinitial" style="margin-right:0.1em; color:#000000; background-color:
#FFFFFF; border:1px solid
#FFFFFF; ">BEHOLD these acts and scan them well
behold their pervers way:
These left the lord, these did his truth
which shold have ben their stay.

Claus

L'ús de claus és compatible amb aquesta plantilla (fent servir >>> per a text flotant a la dreta):

{{ppoem|
No Place so Sacred from such Fops is barr'd,
Nor is ''Paul's Church'' more safe than ''Paul's Church-yard'':
Nay, run to ''Altars''; ''there'' they'll talk you dead;
For ''Fools'' rush in where ''Angels'' fear to tread.
Distrustful ''Sense'' with modest Caution speaks; >>> {{Clau|3|d}}
It still ''looks home'', and ''short Excursions'' makes;
But ''ratling'' Nonsense in full ''Vollies'' breaks;
}}

No Place so Sacred from such Fops is barr'd,
Nor is Paul's Church more safe than Paul's Church-yard:
Nay, run to Altars; there they'll talk you dead;
For Fools rush in where Angels fear to tread.
$\left.{\begin{matrix}\\\\\end{matrix}}\right\rbrace$Distrustful Sense with modest Caution speaks;
It still looks home, and short Excursions makes;
But ratling Nonsense in full Vollies breaks;

Comparació amb <poem>

A continuació hi ha una comparació entre el resultat d'usar aquesta plantilla i el de l'etiqueta <poem> (o <br/>s afegits manualment, la qual cosa és equivalent), tal com es visualitzaria en format EPUB en un e-reader.

Amb l'etiqueta <poem> o amb <br/>:

Amb {{ppoem}} es visualitzen les indentacions i els aliniaments sense trencar els paràgrafs:

Avantatges i desavantatges

Avantatges:

• Sintaxi simple per a la majoria de casos.
• Gestiona la sagnat sortint
• Semànticament més correcte: les línies són «span»s, i les estrofes són «paràgrafs», els poemes són «div»s
• Permet continuar una línia en un salt de pàgina (cosa que no es pot fer amb <poem>)
• Es combina en un sol element fins i tot quan es transclou des de múltiples pàgines.
• Copia i enganxa com a línies separades.
• Permet exportacions amb coherència.
• Centrat automàtic de blocs (cosa que no es pot fer amb <poem> perquè els elements separats no tenen la mateixa amplada).
• Classes CSS molt fàcils d'aplicar a línies o estrofes

Desavantatges:

• Cal tenir cura de fer coincidir els paràmetres start i end a les pàgines implicades.
• De vegades, les caplletres poden introduir funcionaments inesperats.
• Com que es tracta d'una sola plantilla i no es pot dividir, els versos han d'escapar els caràcters = i |.