ZedAI OutOfSpineContentModule
From zedwiki
Contents |
Introduction
This page lists various out-of-spine elements found in various grammars. This list is intented to be used as a basis to decide what we need in our own out-of-spine module.
Note: The list may very well be incomplete.
DTBook
- prodnote, see http://www.daisy.org/z3986/structure/SG-DAISY3/part2-block.html#prodnote
- sidebar, see http://www.daisy.org/z3986/structure/SG-DAISY3/part2-block.html#sidebar
DocBook 5
Admonition elements
- caution: A note of caution, see http://www.docbook.org/tdg5/en/html/caution.html
- important: An admonition set off from the text, see http://www.docbook.org/tdg5/en/html/important.html
- note: A message set off from the text, see http://www.docbook.org/tdg5/en/html/note.html
- tip: A suggestion to the user, set off from the text, see http://www.docbook.org/tdg5/en/html/tip.html
- warning: An admonition set off from the text, see http://www.docbook.org/tdg5/en/html/warning.html
Publishing elements
- sidebar: A portion of a document that is isolated from the main narrative flow, see http://www.docbook.org/tdg5/en/html/sidebar.html
RNIB Book DTD
See http://www.daisy.org/zw/Book_elements for more information about these elements.
- box: This is a boxed section of text, and can occur between paragraphs, etc. It can begin with a heading (head), followed by paragraphs, table, figure or graphic, and enddetails
Design Issues and Options
Options
- Use one generic element (box or similar), and use @role to refine (@role=sidebar, @role=tip, etc). This makes the abstract module natively extensible, and individual profiles may enumerate a set of values to use, relevant for the profile context
- ?
Issues
- Is the term box a risk/misnomer as it may put focus on the graphical layout, rather than the out-of-spine nature of the element? This module must be clearly separated vis-a-vis elements that are in-spine but have been layouted with a graphical box (for this we should refer to relevant in-spine elements, and CSS)
