Structured Lists (ol, ul, li)
Description
ePublisher attempts to replicate source content markup and layout in HTML. However, in some cases, it is more important to produce HTML lists (structured ol, ul, li) entries rather than preserve certain aspects of the source content.
List Families
This project attempts to solve the structured HTML list issue at the format level. The means the change must be implemented for each desired ePublisher output.
The changes required involve:
Transforms\content.xsl Transforms\list.xsl Transforms\pages.fti Transforms\pages.xsl
The changes add the following Paragraph properties:
Property Name |
Function |
list-entry-type |
Defines a new list item (li) or appends to an existing one. |
list-family |
Brands a paragraph as being part of a particular list group. |
list-level |
Defines a list item's level. Automatic option available, may not be reliable. |
list-type |
Present options are "ordered" and "unordered". |
To use it, identify paragraph styles that require structured HTML lists and fill in the relevant details. Paragraphs that do not have list information defined will behave as before (generally rendered in a two-celled table or via <div>s and <span>s).
2013-04-23
Structured Lists.2013-04-23.zip
Attached project support Sun JavaHelp 2.0 (original target for this changes) and WebWorks Reverb. Reverb changes were pull largely by mechanically moving the JavaHelp 2.0 changes over.
LIMITATIONS: This code supports 2 list levels at a time. Not sure if code can handle more list levels than that. Does not address definition lists, etc. Code works in certain cases, so review output before shipping with these changes.