The Source Rendition Feature provides the ability to represent a limited set of typographic properties of a source document using inline attributes.
Although it is expected that document authors will use generic styling mechanisms for representing the source document (primarily CSS), this feature is provided for use when CSS alone may not be sufficient.
This feature makes use of names and values drawn from CSS where applicable for compatibility, but direct translation of the attributes and functionality to CSS is not guaranteed.
This feature is maintained by the ANSI/NISO Z39.98 advisory committee under the auspices of NISO.
The keywords "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this section are to be interpreted as described in RFC2119.
The namespace of all attribute components defined by this feature is:
http://www.daisy.org/ns/z3998/authoring/features/rend/
This resource directory represents version
1.0 of the Source Rendition feature:
This release may not be the most recently published (current) version of the Source Rendition feature. The current version should always be obtained from the static URI: http://www.daisy.org/z3998/2012/auth/features/rend/current/
This feature must be identified as
rend in Z39.98-AI document feature declarations.
The canonical identity URI is:
http://www.daisy.org/z3998/2012/auth/features/rend/1.0/
This version of the feature is compliant with the Z39.98-2012 Specification.
The normative
RelaxNG schema for version
1.0 of the Source Rendition feature is
z3998-feature-rend.rng.
Note - this feature schema does not represent an entire document model; it is intended for inclusion in host profiles.
This feature makes the following components available for inclusion in host profiles:
rend:symbol
rend:prefix
(ordered
list)
rend:prefix
(unordered
list)
rend:prefix
(list
item)
rend:prefix
This section defines processing agent behaviors that extend the default behaviors defined in Processing agent conformance definition.
If the processing agent supports this feature and the client has activated processing of components defined by this feature, then the processing agent must process all encountered components defined by this feature in accordance with the semantics defined in definitions below.
If the processing agent
supports this feature and the client has
deactivated processing of components defined by this feature, then the processing agent must employ the
Ignore or
Discard behaviors as defined below. The
Ignore behavior is the default; the
Discard behavior must only be employed when client has explicitly instructed the processing agent to do so.
(Note that a document transformation where all or some of the CSS-compatible expressions defined by this feature are moved to an external CSS stylesheet does
not comprise an example of the the
Discard behavior.)
If a processing agent recognizes but does not support this feature, it must employ one of the following behaviors:
Upon encountering a document instance with this feature enabled, the processing agent issues a notification, and then aborts the processing.
While traversing the document tree and encountering an attribute in the feature namespace, the processing agent ignores the attribute, and continues the traversal.
While traversing the document tree and encountering an attribute in the feature namespace, the processing agent discards the attribute, and continues the traversal.
The
abort behavior is the default; the
ignore and
discard behaviors must only be employed when the processing agent is explicitly instructed to do so by the client.
Processing agents that employ the
ignore or
discard behaviors should issue a notification.
If a processing agent does not recognize this feature, it must, as dictated in Processing agent conformance definition, abort processing and issue an error message.
The component definitions provided below follow the conventions used in Core Modules.
The Source Rendition Feature provides support for the representation of a limited set of typographic/stylistic properties of a source document.
| Name | Default attribute model | Default content model | Default usage context |
|---|---|---|---|
rend:linebreak
|
Phrase.attrib |
empty
|
Phrase.class |
| Name | Default values | Default usage context |
|---|---|---|
rend:symbol
|
text
|
transition |
rend:prefix
|
'decimal' | 'decimal-leading-zero' | 'lower-alpha' | 'lower-greek' | 'lower-latin' | 'lower-roman' | 'upper-alpha' | 'upper-greek' | 'upper-latin' | 'upper-roman '
|
Ordered lists |
rend:prefix
|
'none' | 'box' | 'check' | 'circle' | 'diamond' | 'disc' | 'hyphen' | 'square'
|
Unordered lists |
rend:prefix
|
text
|
item |
rend:prefix
|
text
|
note and annotation |
linebreak element
The
linebreak element represents a forced line ending.
The
ln
element should be used whenever the text content represents discrete lines.
| Local name |
rend:linebreak
|
|---|---|
| Namespace |
http://www.daisy.org/ns/z3998/authoring/features/rend/
|
| Default usage context | Phrase.class |
| Default attribute model | Phrase.attrib |
| Default content model |
empty
|
| Optionality | This element must not be omitted when activating this module. |
The
rend:symbol attribute specifies the textual symbol used to represent a context break in the source document.
As an alternative to
rend:symbol, the
src attribute
may be used to include an image symbol. Note that allowed media types in the
src attribute are limited to the same set as the media types allowed on the
object element. The
rend:symbol and
src attributes must not occur simultaneously on the same element.
| Local name |
rend:symbol
|
|---|---|
| Namespace | None |
| Default usage context | transition |
| Default value(s) |
text
|
| Optionality | This attribute must not be omitted when activating this module. |
The
rend:prefix attribute specifies the symbol used as prefixes to the
item children of an ordered
list in the source document.
The semantics of the allowed values of this attribute are defined by the CSS list-style-type property.
The value specified in
rend:prefix is inherited by any descendant
lists, unless such descendant
lists specify a
rend:prefix attribute themselves. In terms of the
CSS cascade, values provided here must be considered as of author origin.
For more specialized symbols than the ones supported by the
rend:prefix attribute on
list, the
rend:prefix attribute on item can be used.
| Local name |
rend:prefix
|
|---|---|
| Namespace | None |
| Usage context | Ordered lists |
| Usage context alterability | This usage context is fixed, and must not be altered when activating this module. |
| Value(s) |
'decimal' | 'decimal-leading-zero' | 'lower-alpha' | 'lower-greek' | 'lower-latin' | 'lower-roman' | 'upper-alpha' | 'upper-greek' | 'upper-latin' | 'upper-roman '
|
| Value alterability | The defined value(s) or datatype(s) are fixed, and must not be altered when activating this module. |
| Optionality | This attribute must not be omitted when activating this module. |
The
rend:prefix attribute specifies the symbol used as prefixes to the
item children of an unordered
list in the source document.
The semantics of the allowed values of this attribute are defined by the CSS list-style-type property.
The value specified in
rend:prefix is inherited by any descendant
lists, unless such descendant
lists specify a
rend:prefix attribute themselves. In terms of the
CSS cascade, values provided here must be considered as of author origin.
For more specialized symbols than the ones supported by the
rend:prefix attribute on
list, the
rend:prefix attribute on item can be used.
| Local name |
rend:prefix
|
|---|---|
| Namespace | None |
| Usage context | Unordered lists |
| Usage context alterability | This usage context is fixed, and must not be altered when activating this module. |
| Value(s) |
'none' | 'box' | 'check' | 'circle' | 'diamond' | 'disc' | 'hyphen' | 'square'
|
| Value alterability | The defined value(s) or datatype(s) are fixed, and must not be altered when activating this module. |
| Optionality | This attribute must not be omitted when activating this module. |
The
rend:prefix attribute specifies the symbol used as a prefix to the content of the list
item element.
The occurrence of this attribute results in the prefix inheritance, as set by the
prefix attribute on a
list ancestor, ceases to be active, for this
item, any following
item siblings, and any child
lists.
To specify prefix symbols common to multiple list items, see
rend:prefix
and
rend:prefix
.
| Local name |
rend:prefix
|
|---|---|
| Namespace | None |
| Usage context | item |
| Usage context alterability | This usage context is fixed, and must not be altered when activating this module. |
| Default value(s) |
text
|
| Optionality | This attribute must not be omitted when activating this module. |
The
rend:prefix attribute specifies the characters or symbols that prefix an element.
This variant is intended for use where the attribute and its value carry no special semantics or processing requirements, such as for values that prefix notes and annotations.
| Local name |
rend:prefix
|
|---|---|
| Namespace | None |
| Default usage context | note and annotation |
| Default value(s) |
text
|
| Optionality | This attribute must not be omitted when activating this module. |
| Schema | Language |
|---|---|
| z3998-feature-rend.rng | RelaxNG |
Activation of this module depends on the linking and datatypes modules also being activated.
Refer to the Z39.98-AI community portal for information on available software tools.
The below list represents the modules at the time of version 1.0 of this feature.
The occurrence of the keywords "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in documentation fields embedded in these modules are to be interpreted as described in RFC2119.