Description
This element holds text that is to be presented in a special manner, or was copied from another source, or is independent of the main narrative flow, so could be placed in a "side-box" when presented:
<para>As Shakespear said: <extract type="quote"><para>To be or not to be, that is the question</para></extract>,
which is reasonable enough!</para>
As Shakespear said:
"to be or not to be, that is the question"
, which is reasonable enough!
The extract may conclude with a
<source> element that identifies the source of the extract.
Note that this element should not be used for poetry, because the
<poem> element is intended for this more specialised form of extract.
Note that prior to version 1.8 extracts, or sideboxes, with titles could only be coded as a section containing only a <title> element and an <extract> element. Exctracts with titles should now be coded by placing a <title> element within an <extract> element.
Parent Elements
The elements listed below may directly contain this element.
They are "parent" elements. Elements in referenced groups are included, up to two levels of group nesting.
Model Diagram
The DTD model for this element:
--+(sequence)
|
title (optional) -- (TEXT and elements)
|
|--+(repeatable choice)
| |
| |-- para -- (TEXT and elements)
| |
| |-- chemeqn -- (elements)
| |
| |-- unnumchemeqn -- (elements)
| |
| |-- formula -- (TEXT and elements)
| |
| |-- compound -- (elements)
| |
| |-- structure
| |
| |-- matheqn -- (elements)
| |
| |-- unnummatheqn -- (elements)
| |
| |-- simplelist -- (elements)
| |
| |-- itemizedlist -- (elements)
| |
| |-- orderedlist -- (elements)
| |
| |-- deflist -- (elements)
| |
| |-- address-text -- (TEXT and elements)
| |
| |-- comment -- TEXT
|
source (optional) -- (TEXT and elements)
DTD Definition
The DTD contains the following element and attribute definitions
(note that embedded links are to definitions within the DTD page of this guide):
<!ELEMENT extract (title?, (para |
chemeqn | unnumchemeqn | formula | compound |
structure | matheqn | unnummatheqn |
simplelist | itemizedlist | orderedlist | deflist |
address-text | comment)+, source?)>
<!ATTLIST extract
sidebox (no | yes) "no"
type (block | indent | quote | doublespace |
other) #IMPLIED
%a-group-CommonIDAttrs;>
.
Defined in DTD section
Block-level Content : Paragraphs
General Attributes (shared with other elements)
Local Attributes (defined for this element alone)
Description
This attribute indicates whether or not the content is part of the main narrative flow of the article. If this attribute is used and given the value "yes", then it is independent text that can be placed in a "side box".
Specification
This attribute is required but has a default value of "no". The allowed values are "no" and "yes".
DTD Definition
sidebox (no | yes) "no"
.
Description
This attribute holds a value that provides a hint on how to format the extract. The possible values are:
| |
- |
"block" - format as a block of text (break a surrounding paragraph into preceding and following blocks)
|
| |
- |
"indent" - format as a block, and also indent this block
|
| |
- |
"quote" - format the block appropriated for quoted text (perhaps add quotation marks around the content)
|
| |
- |
"doublespace" - format text with additional spaces between words and lines
|
Specification
This attribute is not required. The allowed values are "block", "indent", "quote", "doublespace" and "other".
DTD Definition
type (block | indent | quote | doublespace |
other) #IMPLIED .