<LML /> 2.0 - Poetry Markup Module

specification

Author: Dr. O. Hoffmann (German web-page)

This module belongs to the Literature Markup Language Version 2.0

Changes

The elements sm, caesura and enjambement are new in LML 2.0.

Element-Index

Complete Element and Attribute Index

Poetry

Poetry is in general text with specific requirements for the presentation of rhythmic or rhymed content. Elements intended to contain a complete poetic text or a larger or more complex poetic fragment like poetry, poem, lyrics, dialogue may contain metadata and descriptive content like the date of creation and the name of the author as well, additionally it may contain prose elements embedding prose content related to the poetic content.

poetry

Description

Type: Block

A generic element to contain poetic content.

Relations

poem

Description

Type: Block

An element to contain a poem (not more than one poem).

Relations

lyrics

Description

Type: Block

An element to contain lyrics (not more than the lyrics of one song) and may contain a related notation of the music as well.

Relations

st

Description

Type: Block

An element representing a strophe or a stanza or a group of verse lines of a poetic text. In general it is expected, that st contains only verse lines as content, represented by the element sl. In case of lyrics is may contain sm as well. Especially an st does not contain another st, poem, lyrics, poetry etc. Within a dialogue, an st may contain the elements sp or directive too additionally to sl elements.

Relations

sl

Description

Type: Block

An element representing a strophe line or verse line of a poetic text. In general it is expected, that sl appears as content of a poem, lyrics, st or dialogue element. Especially an sl does not contain another sl, st, poem, lyrics, poetry etc.

It is expected, that text within one verse line is identifiable to belong to this line. Especially for visual presentation within a limited space this requires some indication of an undesired line break, which appears in some formats.

Relations

sm (v2)

Description

Type: Block

This elements is intended as children of lyrics st and is a container for the representation of the music or melody staff or stave related to the lyrics corresponding to one line sl. Typically this will contain content from another language, maybe only graphics, for example done with SVG. Either this content it directly embedded as a fragment or referenced with a link. The sm can be used additionally to sl or it can contain both a line of lyrics and the related stave to ensure, that the relation between text and stave items is conserved.

Poetry Samples

dialogue

Description

Type: Block

An element containing a dialogue fragment in a poetic form as in a drama or a song for more than one person. Typically the content consists of the elements directive, sp, st, sl.

Relations

directive

Description

Type: Block (inline)

An element containing (stage) directives in a dialogue fragment. This is a specific case of prose or metadata content within poetry content and provides more information within a drama about the appearance of a scene. This can be combined with prose elements inside or simply be used to contain descriptive prose text.

If the directive is within sl, l or p the directive is inline, else block.

This is the same as directive from conversation, but appears within the element dialogue.

Relations

sp

Description

Type: Block (inline)

An element containing information about the currently speaking person in a dialogue fragment. This is a specific case of prose or metadata content within poetry content. Typically it contains the name of the speaker as prose text and this element is directly followed by st or sl elements containing the poetic text message of this speaker. If an sp element follows directly on an sp element, this indicates the previous speaker to be speechless. If there is no previous speaker for sl or st elements, this means that the speaker is anonymous from the off, but this should be avoided by the author.

If the sp is within sl, l or p the sp is inline, else block.

The words spoken by the speaking person can be marked up in a sibling element ds for general direct speech, but within a dialogue this can be implicated as well from the sp indicating a speaker.

This is the same as sp from conversation, but appears within the element dialogue.

Relations

Dialogue Samples

caesura (v2)

Description

Type: Inline

A caesura typically appears within a strophe line sl to indicate some additional small break; marks the point at which a metrical line may be divided. The element can be empty, representing the caesura itself or can contain one or more characters or symbols '-' or ',' or fixed additional whitespace as a caesura.

Relations

enjambement (v2)

Description

Type: Inline

An enjambement indicates a discrepancy between content and line structure of a poem. It appears at the end of a strophe line sl to indicate, that the content continues in the next line. The element can be empty, representing the enjambement itself or can contain one or more characters or symbols like '-' or a hyphen, if the enjambement appears within a word.

Relations

Example for caesura and enjambement

<st xml:lang="de">
<sl>Grütze reiben <caesura>-</caesura> Gnome bleiben</sl>
<sl>Mag auch die Sonne scheinen <caesura>-</caesura> Elfen weinen!</sl>
<sl>Die Zwerge grimmen in der Finster<enjambement>-</enjambement></sl>
<sl>nis, pinkeln dabei in den Ginster.</sl>
</st>