Community Central
Community Central
No edit summary
mNo edit summary
Tag: Help
Line 1: Line 1:
  +
{{Enabled by default}}
{{Extension infobox
 
  +
| name = Poem
 
| author =
 
* Nikola Smolenski
 
* Brion Vibber
 
* Steve Sanbeg
 
| link = [[mw:Extension:Poem|MediaWiki.org]]
 
| desc = {{int:poem-desc}}
 
| default = yes
 
}}
 
 
{{tocright}}
 
{{tocright}}
 
The '''poem extension''' allows for easy inclusion of poems and similar material on articles, by simply putting them between <code>&lt;poem>&lt;/poem&gt;</code> tags, instead of adding <code>&lt;br&gt;</code> to the end or <code>:</code> to the beginning of every line.
 
The '''poem extension''' allows for easy inclusion of poems and similar material on articles, by simply putting them between <code>&lt;poem>&lt;/poem&gt;</code> tags, instead of adding <code>&lt;br&gt;</code> to the end or <code>:</code> to the beginning of every line.
Line 95: Line 87:
 
[[vi:Trợ giúp:Thơ]]
 
[[vi:Trợ giúp:Thơ]]
 
[[zh:Help:詩歌]]
 
[[zh:Help:詩歌]]
  +
 
[[Category:Help]]
 
[[Category:Help]]
  +
[[Category:Extensions]]

Revision as of 09:49, 15 September 2021

This extension is enabled by default on Fandom.

The poem extension allows for easy inclusion of poems and similar material on articles, by simply putting them between <poem></poem> tags, instead of adding <br> to the end or : to the beginning of every line.

How it works

The extension preserves wikilinks, bolding, etc. if they are present in the poem, as well as lines that begin with spaces. Note that the spaces will be rendered in whatever font is being used and will have different widths based on the font.

Beginning a line with a colon (:) will wrap the line in a <span class="mw-poem-indented" style="margin-left: 1em;"> tag with a left margin of +1em for each colon. You may use the mw-poem-indented class to apply additional styling to indented lines.

A simple example

The following text in Source mode:

<poem>
In Xanadu did [[wikipedia:Kubla Khan|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>

renders as:

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.

Styling a poem

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: <poem style="text-align: center; border: 2px dashed #2f6fab; background-color: #eeeeee; color: #000; padding: 1em;">

Styling example

The following text in Source mode:

<poem style="text-align: center; border: 2px dashed #2f6fab; background-color: #eeeeee; color: #000; padding: 1em;">
The limerick packs laughs anatomical
Into space that is quite economical.
But the good ones I’ve seen
So seldom are clean
And the clean ones so seldom are comical.
</poem>

renders as:

The limerick packs laughs anatomical
Into space that is quite economical.
But the good ones I’ve seen
So seldom are clean
And the clean ones so seldom are comical.

"Compact" option

Normally, the parser renders each poem in a paragraph (<p> tag) inside the <div>. Occasionally this is not desired; using the compact option (<poem compact>) suppresses paragraphs in the poem, to allow adjacent compact poems to blend together.

See also

Further help and feedback