Extension:Poem/zh

Poem扩展允许在Wiki文本中轻松格式化诗歌或类似的文段. 一旦该扩展被开启，您可以将任何文本段落放在标签内，这将导致以下效果：


 * All newlines are preserved by converting them into tags
 * The block of text is enclosed in 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 tag

The extension preserves wikilinks, bolding, etc. if they are present in the poem.

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  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 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 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.

Problems and solutions

 * Variables and ParserFunctions do work inside the ... container, but NOT within the  tag itself ; this prevents templates with code such as .
 * One workaround is to use  ... instead.
 * Another way is to use the  magic word:.
 * NB: this would however seem not to work with the "compact" option.