example

example — A formal example, with a title.

Synopsis

Attributes

Common attributes and common linking attributes.

Additional attributes:

  • floatstyle
  • label
  • At most one of:
    • width (nonNegativeInteger)
    • pgwide (enumeration)
      • “0”
      • “1”

Additional Constraints

  • example must not occur in the descendants of example
  • figure must not occur in the descendants of example
  • table must not occur in the descendants of example
  • equation must not occur in the descendants of example
  • caution must not occur in the descendants of example
  • important must not occur in the descendants of example
  • note must not occur in the descendants of example
  • tip must not occur in the descendants of example
  • warning must not occur in the descendants of example

Description

An example is a formal example with a title. Examples often contain programlistings or other large block elements. Frequently, they are given xml:ids and referenced from the text with xref or link.

Processing expectations

Formatted as a displayed block.

DocBook does not specify the location of the example within the final displayed flow of text; it may float or remain where it is located.

A list of examples may be generated at the beginning of a document.

If a label is specified, that label will be used for identifying the example and in generated cross-references. If unspecified, examples are often, but not always, numbered.

If a width is specified, formatters may use this value to determine scaling or rotation.

Attributes

Common attributes and common linking attributes.

floatstyle

Specifies style information to be used when rendering the float

label

Specifies an identifying string for presentation purposes

pgwide

Indicates if the element is rendered across the column or the page

Enumerated values:
“0”

The element should be rendered in the current text flow (with the flow column width).

“1”

The element should be rendered across the full text page.

width

Specifies the width (in characters) of the element

Parents [+]

This element occurs in 73 elements.

Children [+]

This element contains 64 elements.

Examples

  1 <article xmlns='http://docbook.org/ns/docbook'>
  2 <title>Example example</title>
    
  4 <example xml:id="ex.dssslfunction">
    <title>A DSSSL Function</title>
  6 <programlisting>
    (define (node-list-filter-by-gi nodelist gilist)
  8   ;; Returns the node-list that contains every element of the original
      ;; nodelist whose gi is in gilist
 10   (let loop ((result (empty-node-list)) (nl nodelist))
        (if (node-list-empty? nl)
 12 	result
    	(if (member (gi (node-list-first nl)) gilist)
 14 	    (loop (node-list result (node-list-first nl)) 
    		  (node-list-rest nl))
 16 	    (loop result (node-list-rest nl))))))
    </programlisting>
 18 </example>
    
 20 </article>
Example 25. A DSSSL Function
  1 
  2 (define (node-list-filter-by-gi nodelist gilist)
      ;; Returns the node-list that contains every element of the original
  4   ;; nodelist whose gi is in gilist
      (let loop ((result (empty-node-list)) (nl nodelist))
  6     (if (node-list-empty? nl)
    	result
  8 	(if (member (gi (node-list-first nl)) gilist)
    	    (loop (node-list result (node-list-first nl)) 
 10 		  (node-list-rest nl))
    	    (loop result (node-list-rest nl))))))
Last revised by Norman Walsh on 9 Jun 2011 (git hash: 8b56299e266638d7740ab38b86833eeafed584e9)