O'Reilly logo

DocBook 5: The Definitive Guide by Richard L. Hamilton, Norman Walsh

Stay ahead with the world's most comprehensive technology and business learning platform.

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, tutorials, and more.

Start Free Trial

No credit card required

Name

literallayout — A block of text in which line breaks and whitespace are to be reproduced faithfully

Synopsis

literallayout ::= (infodb.titleforbidden.info, ((text | lineannotation | Bibliography inlines | Computer-output inlines | Error inlines | Graphic inlines | GUI inlines | Indexing inlines | Keyboard inlines | Linking inlines | Markup inlines | Math inlines | Object-oriented programming inlines | Operating system inlines | Product inlines | Programming inlines | Publishing inlines | Technical inlines | Ubiquitous inlines | User-input inlines)* | textobject))

Attribute synopsis

Common attributes and common linking attributes.

Additional attributes:

  • class (enumeration) = “monospaced” | “normal”

  • continuation (enumeration) = “continues” | “restarts”

  • linenumbering (enumeration) = “numbered” | “unnumbered”

  • startinglinenumber (integer)

  • language

  • xml:space (enumeration) = “preserve”

Description

A literallayout is a verbatim environment. Unlike the other verbatim environments, it does not have strong semantic overtones and may not imply a font change.

Processing expectations

This element is displayed “verbatim”; whitespace and line breaks within this element are significant.

Unlike programlisting and screen, which usually imply a font change, literallayout does not. How spaces are to be represented faithfully in a proportional font is not addressed by DocBook.

In DocBook V3.1, the class attribute was added to give users control over the font used in literallayouts. If the class attribute is specified ...

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, interactive tutorials, and more.

Start Free Trial

No credit card required