View source for Template:Poetically break lines/doc

{{Documentation subpage}}
{{Template shortcut|pbl}}
{{Uses TemplateStyles|Template:Poetically break lines/styles.css}}
{{Never substitute}}

'''{{tl|Poetically break lines}}''' is a template designed to format poetry simply and reliably. It differs from {{tl|Poem quote}} in two significant ways: it does not add spacing around the poem that sets it apart as “block quote”, and it automatically provides hanging indentation when lines are so long that they wrap. This is an advantage in a few specific instances, such as when a poem is part of a table or when a few lines are much longer than the rest. The hanging indent is intentionally large so that they are not confused with lines that are intentionally indented as part of the poem's form.

== Usage ==
;Syntax
: <syntaxhighlight lang="wikitext">{{Poetically break lines|Line 1
Line 2
Line 3
...}}</syntaxhighlight>

An example follows, using columns as a width-limiting factor:

;The Dream

{{columns-start|num=3}}
{{column}}
{{Poetically break lines|
Dear love, for nothing less than thee
Would I have broke this happy dream;
⁠&emsp;It was a theme
For reason, much too strong for fantasy.
Therefore thou waked'st me wisely; yet
My dream thou brokest not, but continued'st it.
Thou art so true that thoughts of thee suffice
To make dreams truths, and fables histories;
Enter these arms, for since thou thought'st it best,
Not to dream all my dream, let's act the rest.}}
{{column}}
{{Poetically break lines|
As lightning, or a taper's light,
Thine eyes, and not thy noise waked me;
⁠&emsp;Yet I thought thee
—For thou lovest truth—an angel, at first sight;
But when I saw thou saw'st my heart,
And knew'st my thoughts beyond an angel's art,
When thou knew'st what I dreamt, when thou knew'st when
Excess of joy would wake me, and camest then,
I must confess, it could not choose but be
Profane, to think thee any thing but thee.}}
{{column}}
{{Poetically break lines|
Coming and staying show'd thee, thee,
But rising makes me doubt, that now
⁠&emsp;Thou art not thou.
That love is weak where fear's as strong as he;
'Tis not all spirit, pure and brave,
If mixture it of fear, shame, honour have;
Perchance as torches, which must ready be,
Men light and put out, so thou deal'st with me;
Thou camest to kindle, go'st to come; then I
Will dream that hope again, but else would die.}}
{{columns-end}}

By default the template adds some margins to the poem (the same margins used by {{tl|Numbered verses}}). Use the {{tjp|margin:}} parameter to set different values – e.g. {{tjp|margin: 0}} or {{tjp|margin: 1em auto}} (same syntax of the CSS <code>margin</code> property).

==See also==
{{Quotation templates}}

<includeonly>{{Sandbox other||
<!-- Categories below this line -->
[[Category:Typing-aid templates]]
}}</includeonly>