Extensión:Poem
Poem Estado de lanzamiento estable |
|
---|---|
![]() |
|
Implementación | Etiqueta |
Descripción | Adds <poem> tag for poem formatting |
Autor(es) | Nikola Smolenskidiscusión |
Última versión | actualizaciones continuas |
MediaWiki | 1.25+ |
Cambios de la base de datos | No |
Licencia | Creativo Commons Cero v1.0 Universal |
Descarga | |
<poem> |
|
Traduce el Poem extensión si es disponible en translatewiki.net | |
Asuntos | Tareas abiertas · Reportar un bug |
El Poema la extensión facilitar formatear poemas y material similar dentro Wikitext.
Once the extension is enabled, you can put any block of text within <poem>
</poem>
tags, which has the following effects:
- All newlines are preserved by converting them into
<br />
tags
- The block of text is enclosed in
<p>...</p>
tags (as well as a div of class "poem")
- Colons at the beginning of a line are converted into 1 em indentation
- Spaces at the beginning of a line are preserved and no longer invoke the
<pre>
tag
The extension preserves wikilinks, bolding, etc. if they are present in the poem.
Usage
Example
Input text | Output |
---|---|
<poem> In [[Wikipedia:Xanadu|Xanadu]] did Kubla Khan A stately pleasure-dome decree: Where Alph, the sacred river, ran Through caverns measureless to man Down to a sunless sea. So twice five miles of fertile ground With walls and towers were girdled round: And there were gardens bright with sinuous rills, Where blossomed many an incense-bearing tree; And here were forests ancient as the hills, Enfolding sunny spots of greenery. </poem> |
In Xanadu did Kubla Khan |
Example with indentation
Input text | Output |
---|---|
<poem> Une terre au flanc maigre, âpre, avare, inclément Où les vivants pensifs travaillent tristement, ::Et qui donne à regret à cette race humaine Un peu de pain pour tant de labeur et de peine ; ::Des hommes durs, éclos sur ces sillons ingrats ; Des cités d’où s’en vont, en se tordant les bras, ::La charité, la paix, la foi, sœurs vénérables ; L’orgueil chez les puissants et chez les misérables ; </poem> |
Une terre au flanc maigre, âpre, avare, inclément |
Style
The poem text is wrapped in a div, which has no style by default; but inherits any style or class option passed to the poem.
For example, while indented text can be used for simple examples to prevent filling and draw a nice blue box, it can be hard to read in some cases, since long lines aren't broken. A similar, but somewhat better effect can be obtained with:
<poem style="border: 2px solid #d6d2c5; background-color: #f9f4e6; padding: 1em;">
When applied to the above example, the result is as follows:
In Xanadu did Kubla Khan
A stately pleasure-dome decree:
Where Alph, the sacred river, ran
Through caverns measureless to man
Down to a sunless sea.
So twice five miles of fertile ground
With walls and towers were girdled round:
And there were gardens bright with sinuous rills,
Where blossomed many an incense-bearing tree;
And here were forests ancient as the hills,
Enfolding sunny spots of greenery.
"compact" option
Applying the <poem>
tag with the compact option to a text of more than two lines, every line becomes a separate paragraph.
(This seems to be a bug, as it is opposite to what the term suggests.)
Subsequent use of the <poem>
tag with the compact option, with up to two newlines in between, gives just a single newline between texts, not a new paragraph.
Thus, applied to texts of more than two lines each, every line becomes a separate paragraph, except that the last line of each text and the first line of the next text are combined into one paragraph.
Input | Output | Input | Output |
---|---|---|---|
<poem> One, Two. </poem> <poem> Three? Four! </poem> |
One, Three? |
<poem compact> One, Two. </poem> <poem compact> Three? Four! </poem> |
One,
Two. Three?
Four! |
Input | Output | Input | Output |
---|---|---|---|
<poem> One, Two. Extra. </poem> <poem> Three? Four! Extra. </poem> |
One, Three? |
<poem compact> One, Two. Extra. </poem> <poem compact> Three? Four! Extra. </poem> |
One,
Two. Three?
Four! |
Problems and solutions
- Variables and ParserFunctions do work inside the <poem> ... </poem> container, but NOT within the <poem ... > tag itself ; this prevents templates with code such as <poem style="{{{1}}}">.
- One workaround is to use <div style="{{{1}}}"><poem> ... </poem></div> instead.
- Another way is to use the
#tag
magic word: {{#tag:poem| ... |style="{{{1}}}"}}.- NB: this would however seem not to work with the "compact" option.
Input (inside OK, within not OK) | Output |
---|---|
<poem style="{{{1|border: 1px solid Black;}}}">
One,
{{{2|Two.}}}
</poem>
|
One, |
Input (both inside and within OK) | Output |
<div style="{{{1|border: 1px solid Black;}}}"><poem>
One,
{{{2|Two.}}}
</poem></div>
|
One, |
{{#tag:poem| One, {{{2|Two.}}} |style="{{{1|border: 1px solid Black;}}}" }} |
One, |
Installation
- Si usas Vagrant , instala con
vagrant roles enable poem --provision
- Instalación manual
- Descarga y extrae los archivos en el directorio «
Poem
» dentro del directorioextensions/
existente. - Añade el siguiente código a tu LocalSettings.php (preferiblemente al final):
wfLoadExtension( 'Poem' );
Hecho – Navega a Special:Version en tu wiki para verificar que la apariencia se haya instalado correctamente.
Para quienes usan MediaWiki 1.24 o versiones anteriores:
Estas instrucciones describen la nueva forma de instalar extensiones usando wfLoadExtension()
.
Si necesitas instalar esta extensión en versiones anteriores (MediaWiki 1.24 y anteriores), debes usar lo siguiente en lugar de wfLoadExtension( 'Poem' );
:
require_once "$IP/extensions/Poem/Poem.php";
![]() | Esta extensión está siendo usada en uno o más proyectos de Wikimedia. Esto significa probablemente que la extensión es estable y funciona lo suficientemente bien como para ser usada en sitios con gran cantidad de visitas. Puedes buscar el nombre de esta extensión en los archivos CommonSettings.php e InitialiseSettings.php de Wikimedia para ver dónde se instala. Encontrarás la lista completa de extensiones instaladas en un wiki en particular en la página Special:Version del wiki. |