9.9 Publish a poem to LaTeX or PDF

The muse-poem module makes it easy to attractively publish and reference poems in the following format, using the "memoir" module for LaTeX publishing. It will also markup poems for every other output style, though none are nearly as pretty.

     Title
     
     
     Body of poem
     
     
     Annotations, history, notes, etc.

Once a poem is written in this format, just publish it to PDF using the poem-pdf style. To make an inlined reference to a poem that you've written – for example, from a blog page – there is a "poem" tag defined by this module.

     <poem title="name.of.poem.page">

Let's assume the template above was called name.of.poem.page; then the above tag would result in this inclusion.

     ** Title
     
     > Body of poem

John Wiegley uses this module for publishing all of the poems on his website, which are at http://www.newartisans.com/johnw/poems.html.

Styles provided

poem-latex

Publish a poem in LaTeX form.

poem-pdf

Publish a poem to a PDF document.

chapbook-latex

Publish a book of poems in LaTeX form.

chapbook-pdf

Publish a book of poems to a PDF document.

Options provided

muse-poem-latex-header

Header used for publishing LaTeX poems.

This may be text or a filename.

muse-poem-latex-footer

Footer used for publishing LaTeX files.

This may be text or a filename.

muse-poem-markup-strings

Strings used for marking up poems.

These cover the most basic kinds of markup, the handling of which differs little between the various styles.

muse-chapbook-latex-header

Header used for publishing a book of poems in LaTeX form.

This may be text or a filename.

muse-chapbook-latex-footer

Footer used for publishing a book of poems in LaTeX form.

This may be text or a filename.

muse-poem-chapbook-strings

Strings used for marking up books of poems.

These cover the most basic kinds of markup, the handling of which differs little between the various styles.