Help & Manual 5 - User Help

Publishing from your application

Hide Navigation Pane

Publishing from your application

Previous topic Next topic No directory for this topic Expand/collapse all hidden text  

Publishing from your application

Previous topic Next topic Topic directory requires JavaScript JavaScript is required for expanding text JavaScript is required for the print function  

If you follow the rules and syntax of the Help & Manual XML Language you can generate Help & Manual projects directly from your application and publish them to any supported output format without ever opening Help & Manual.

This can be useful for producing things like automated program code documentation for which you do not need to edit the project in Help & Manual. Of course, you can also edit the projects you generate from your application manually with Help & Manual later if you want.

Note that Help & Manual Professional is required for this because the Standard version cannot read or write uncompressed XML project files.

Generating projects programmatically

To write topics and projects directly, either from your application or manually, you need to follow the rules and syntax of the Help & Manual XML Language, which are documented in detail in the file Helpman_XML_ref.chm. This file can be found in the Help & Manual program directory.

The best way to get started is to work through this tutorial on the Help & Manual User forum:

Creating Content from Scratch with XML

You need to be a forum member to access this section. Registration is free and without any obligations, just click on Register in the forum header and follow the instructions displayed.

Auto-publishing after you generate

After generating your project from your application you can then publish it automatically with batch commands, following the instructions in the other topics in this chapter. You don't need to open Help & Manual to do this  provided you don't want to edit the content before publishing the entire process can be fully automated.

Note that this is only possible if you create an entire XML project, including a full, valid .hmxp project file. You cannot compile individual XML topic files programmatically with this method.