SilvaDocumentPatches readme

This product contains patches to SilvaDocument that add more features and functionality than is provided in SilvaDocument. This product mainly deals with functionality enhancements of the SilvaDocument's forms-based editor/xmlwidgets, but has some additional features that go beyond this.

1. The first element of a sub-item (e.g. li, table cell) is only rendered without surrounding tags if it is of type 'p' and is the only child. Previous behaviour always rendered it without the '

   ' tag, which makes the html inconsistent and styling more difficult.

2. Silva tables no longer have with=100%
3. custom_row_heading widget added to the table editor. This is a table cell that spans all columns, and functions like a normal row's table cells. e.g. it can have nested elements, not just text.
4. Publically rendered documents can have their titles suppressed by setting 'suppress_title' in either request.other or model.
5. Support for a typographical_characters service. A typochars tool was added when kupu was released, but it contains a static set of xml entities. With this service, managers can add arbitrary xml entities, and they immediately become available inside kupu and in the 'notes' panel of paragraphs, simple lists, and dlists.
6. Support for class and style attributes of all silva markup allowed inside paragraphs
7. Support for element inside paragraphs. This element is really only useful when Tropos (not available yet) is installed.
8. Some of the patches in this product aren't supported in kupu. When using kupu to edit documents containing features provided in this product, it's behavior is unexpected, and may remove elemenets it don't know about. To get around this, a patch is provided for kupu that effectively 'turns off' kupu when these features are present in a document.
9. To achieve (7), the Document class is patched to allow products to add non-cacheable-elements, and elements that aren't supported in kupu. See __init__.py for more details.
10. New widgets:
    • conditional widget - Conditionally render content based on the return value of a python script located in the nearest 'source' zope folder.
    • hr - horizontal rule widget
11. External Sources are allowed inside table cells, complex list items.