xml.schema.z3998-book-1.0.mod.z3998-feature-description.rng Maven / Gradle / Ivy
The DIAGRAM Description Feature
The DIAGRAM Description feature supports traditional long descriptions and also includes markup for including summaries and simplified language descriptions. It also allows the embedding of simplified image versions of the source and also tactile printing-ready equivalents.
The age and/or education level of the intended audience can be set in the description metadata.
This feature makes available a single public element: the description element. Other components defined in this feature are intended for use augmenting this element.
This feature inherits elements, attributes and additional features from the Z39.98-2012 Core Modules .
Markus Gylling
[email protected]
2011
2012
DAISY Consortium
This module is licensed under a Creative Commons Attribution 3.0 license, a copy of which is available at
http://creativecommons.org/licenses/by/3.0/
For complete licensing information, please refer to the LICENSE file that came with this distribution, a copy of which is also available from the DAISY web site at
www.daisy.org
2012-12-19
MGy
Initial version
The description element is the root container element for a description. It consists of an optional container element for metadata information (the head ) and a required container for the different description types and alternate image renditions (the body ). The language of the description can be specified by attaching an xml.lang attribute to the description element. If the description will be made available in a standalone context (i.e., in which its language cannot be inherited from a host content document), the language should always be specified. The DIAGRAM Description profile provides the ability to compile one or more description elements into a single document for distribution (e.g., to accompany an EPUB). When storing a description in a standalone context, the Description feature namespace http://www.daisy.org/ns/z3998/authoring/features/description/ should be declared on the description element using the xmlns namespace association mechanism defined in refXMLNamespaces . Although not required, the prefix d is recommended.
The document-like model choice for description
The description head element contains meta information about the enclosing description element. The meta information in the description head element should not be treated as document content, but may be used for display and other purposes when rendering descriptions. Although all metadata is optional, descriptions should, at a minimum, include an identifier, the intended reader age and/or school grade level. See the DIAGRAM Descriptions Vocabulary for a set of predefined RDF properties. Properties from other RDF vocabularies can also be included, provided their prefix is declared. If age and grade-level metadata is omitted, the containing description should be assumed to be applicable to all readers.
The description body element contains the accessible description forms that readers can select from depending on their needs. The description body must minimally contain the primary description of the associated content in a child longdesc element. The description body may also optionally compliment the primary description with a briefer summary and a simplified language representation . The body of the description can also be used to carry alternative images for readers unable to adequately interact with the source image. The tactile element can be used to include a tactile image and accompanying tour , and the simplifiedImage element can be used to include images more accessible to various reader needs.
The summary element contains a shorter, more succinct version of the primary description in the longdesc element.
The summary element must neither be empty nor contain only whitespace.
The longdesc element contains the primary description of the associated image, graphic or visually-oriented structure. The longdesc should contain a comprehensive explanation of the referenced item. See the summary element for information on how to include a compact description.
The longdesc element must neither be empty nor contain only whitespace.
The simplifiedLanguageDescription element contains a simplified language version of the primary description in the longdesc element.
The simplifiedLanguageDescription element must neither be empty nor contain only whitespace.
The tactile element contains an alternative tactile image. The element may contain one or more identical images for different production methods (e.g., one for swell paper production and another for stereolithograph printing). The tactile image may also include an explanatory tour . This specification does not place any restrictions on the format used to represent the tactile image, but images should be final-form representations for output rendering by end users. The role attribute should be used to differentiate the production use for each image.
The tour element is associated with a tactile graphic or a simplified alternative image, and provides orientation. In addition, the tour can explain how to explore the tactile or simplified image.
The simplifiedImage element contains a simplified version of the source image. The element may contain one or more identical images in different formats. The simplified image may also include an explanatory tour .
© 2015 - 2025 Weber Informatics LLC | Privacy Policy