13.10.12 Verse blocks in LaTeX export

The LaTeX export back-end accepts four attributes for verse blocks: ‘:lines’, ‘:center’, ‘:versewidth’ and ‘:latexcode’. The three first require the external LaTeX package ‘verse.sty’, which is an extension of the standard LaTeX environment.

:lines

To add marginal verse numbering. Its value is an integer, the sequence in which the verses should be numbered.

:center

With value ‘t’ all the verses on the page are optically centered (a typographic convention for poetry), taking as a reference the longest verse, which must be indicated by the attribute ‘:versewidth’.

:versewidth

Its value is a literal text string with the longest verse.

:latexcode

It accepts any arbitrary LaTeX code that can be included within a LaTeX ‘verse’ environment.

A complete example with Shakespeare’s first sonnet:

#+ATTR_LATEX: :center t :latexcode \color{red} :lines 5
#+ATTR_LATEX: :versewidth Feed’st thy light’s flame with self-substantial fuel,
#+BEGIN_VERSE
From fairest creatures we desire increase,
That thereby beauty’s rose might never die,
But as the riper should by time decease
His tender heir might bear his memory
But thou, contracted to thine own bright eyes,
Feed’st thy light’s flame with self-substantial fuel,
Making a famine where abundance lies,
Thyself thy foe, to thy sweet self too cruel.
Thou that art now the world’s fresh ornament,
And only herald to the gaudy spring,
Within thine own bud buriest thy content,
And, tender churl, mak’st waste in niggardly.
Pity the world, or else this glutton be,
To eat the world’s due, by the grave and thee.
#+END_VERSE