preformat-type

Type of Preformatted Text

Type of content contained in the <preformat> element (for example, shape poetry, ASCII art, hand-created tabulations using tabs and spaces, etc.).

Usage

Many journal tag sets make distinctions among different types of preformatted text (some by means of attributes, others with distinct elements). In this Tag Set, there are two elements to handle preformatted material:
  • the <code> to hold computer programs, tagged XML documents, samples of XML DTDs or schemas, etc., and the
  • <preformat> element, which contains non-code material such as ASCII art, man-machine dialogs, tabular material made with tabs and whitespace, and formatted poetry.
. The distinctions between different types of preformatted text can be preserved using the @preformat-type attribute, for example, by recording the content type of the text, such as “ascii-art”.

Used on Element: <preformat>

ValueMeaning
Text, numbers, or special charactersA word or phrase that describes the content or names the type of content for the <preformat> element, for example, “man-machine” for a man-machine dialog interaction or “poetry” for an e.e.cummings formatted textual poem.
Restriction@preformat-type is an optional attribute; there is no default.

Suggested usage

Although designed to accept any text as its value, potential values for this attribute might include:
poetry
Poems
ascii
ASCII art
man-machine
A man-machine dialog, such as an error message and response
tabular
Tabular structures created by using spacing and tabs rather than tagging the row and column content

Example

 ...
<preformat preformat-type="dialog" xml:space="preserve"
position="anchor">
C:\users\lap make
  'make' is not recognized as:
    - an internal or external command
    - an operable program
    - a batch file
</preformat>
...