----------------------------------------------------------------- Helpcontent displayed in a browser directly from XML ----------------------------------------------------------------- This README shows how to display Helpcontent2 XML pages (XHP) directly rendered in a modern browser. ----------------------------------------------------------------- Background ----------------------------------------------------------------- The XML files must be transformed into HTML files with the help of a style sheet file (XSL). In the current helpcontent2, the processing is done in xmlhelp/ module, an ancient XSLT processor developed circa 2005 (OpenOffice.org 1.5) Modern browsers such as Firefox, Chrome and Rekonq are capable to execute the transformation direcly in the client, by getting an URL that returns a XML file that contains the reference of the necessary XSL style sheet. How to display Helpcontent2 in a browser 1. Open the browser 2. Open the file index.html in source/ folder 3. Navigate in pages ----------------------------------------------------------------- File descriptions ----------------------------------------------------------------- default.css: ------------- the cascading style sheet for HTML formatting. online_transform.xsl: -------------------- the XSL transform file. Transform XHP files into HTML files. This file is a modification of xmlhelper/util/main_transform.xsl, which was designed for xmlhelp XSL processor. help.js ------- This javascript file: 1. modifies href attributes in of #DisplayArea to handle &DbPAR and &System params 2. picks the bookmarks file and displays in #BottomLeft
area. 3. Reads URL params. ----------------------------------------------------------------- New ‘Object’ tag ----------------------------------------------------------------- The filter online_transform.xsl now support the tag defined for XHP files to allow a generic object in the browser. The tag now maps to the folowing HTML5 tags: Maps to HTML5