Extension:Poem/zh

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


 * 所有的换行符都会保留，它们将会转换为标签
 * 文本块包含在标签中（以及一个带有“poem”类的div标签）
 * 行首的冒号转换为1em的缩进
 * 保留行首的空格，不再调用标签

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

-{zh-hans:示例; zh-hant:範例;}-


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. (That is to say, it allows for more compact markup, not for a more compact output.)

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.