Template:Verse/doc

This is a documentation subpage for Template:Verse.
It contains usage information, categories and other content that is not part of the original template page.

This template uses a <span> element for formatting.
Block-based templates and paragraph breaks cannot be nested inside it.

See H:DIVSPAN for details.

This template uses TemplateStyles:

Template:Verse/styles.css

This template is used on approximately 6,700 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them.

Template for creating an anchor for verses:

chapter (or parameter 1), the chapter the verse belongs to
verse (or parameter 2), the verse being linked to
color (or colour, or parameter 3), over-ride the green colour of the verses
notext, define as blank to over-ride the display of the verse number
align, use to control positioning

Positioning

When the "align" parameter is unset, the verse number appears inline:

{{verse||1|}} Now I am become Death, the destroyer of worlds.

¹ Now I am become Death, the destroyer of worlds.

align

When the align=left, the verse number is set to the margin:

{{verse||1|align=left}} Now I am become Death, the destroyer of worlds.

¹ Now I am become Death, the destroyer of worlds.

This is useful when use in poems, as it can be floated out of the way of the poem's structure, and doesn't affect the start of the line. You probably need to use a div class such as "indented-page" (designed for this case) or even "prose" to keep the text's left margin away from the verse number:

<div class=indented-page><poem>
{{verse||1|align=left}} To see a world in a grain of sand,
{{verse||2|align=left}} And heaven in a wild flower;
{{verse||3|align=left}} To hold infinity in the palm of your hand,
{{verse||4|align=left}} And eternity in an hour.
</poem></div>

¹ To see a world in a grain of sand,
² And heaven in a wild flower;
³ To hold infinity in the palm of your hand,
⁴ And eternity in an hour.

When the align=float, the verse number is left floated to the margin:

{{verse||2|align=float}} She weepeth sore in the night,

² She weepeth sore in the night,

This option is useful in poems where the verse number needs to be closer to the text, because other items appear in the margin, or where the verse number would otherwise overlap the text:

:{{overfloat left|align=right|padding=1em|{{hebrew|ב}}}}{{verse|1|2|align=float}}She weepeth sore in the night,
:And her tears are on her cheeks;
:She hath none to comfort her
:Among all her lovers;

ב²She weepeth sore in the night,

And her tears are on her cheeks;

She hath none to comfort her

Among all her lovers;

Anchoring

This template creates anchors based on the chapter and verse supplied.

To use this tool for navigation, type [[Article name#Chapter:Verse]], like this: Bible (King James)/Genesis#4:5