Handlers control how RoboHelp works with XML files and style sheets.
When importing an XML file into an existing project, the handler determines its appearance. When creating XML output, the handler determines how the topics and projects are converted into XML.
When you import an XML file, you can choose one of the predefined handler files or a customized handler file. Predefined handler files include:
Import DocBook As Topics Imports the selected DocBook files as HTML topics.
Import XHTML (*.XML) Imports the selected XHTML files as HTML topics.
Import XML (CSS/XSL) If the selected XML file has an associated style sheet (.CSS or .XSL), this handler imports the XML file as an HTML topic, complete with formatting. If the selected XML file lacks an associated style sheet, this handler converts the XML file to a HTML file, without any display control.
This import option also allows you to select advanced import options. You can import the XML file as text flow or tree flow. You can also select a customized .CSS or .XSL file.
Note: Imported customized handlers are also listed.
When you create XML output, you can choose one of these predefined handler files:
Export Project To DocBook Exports the entire XML project to DocBook format. Advanced options:
Content Only Exports only the meaningful content (text and data) contained in the project. This includes inline and block text, images, normal links, table, lists, and so on. No DHTML effects are included.
Export Exports the entire project contents (text and data and its related display format). All DHTML effects are included.
Export Project To XHTML Exports the XML project to XHTML format. All topics are converted to XHTML files.
Export Topics To DocBook Exports only the topics to DocBook format. Advanced options:
Content Only Exports only the meaningful topic content (text and data). This includes inline and block text, images, normal links, table, lists, and so on. No DHTML effects are included.
Export Exports the entire topic content (text/data and its related display format). All DHTML effects are included.
Export Topics To XHTML Exports only the topics to XHTML format.
You can create your own XML handlers or customize existing ones by using the HDF Editor. It allows you to create or edit handler files so you can modify the way in which XML is imported and output.