If you have ever read Getting Started with Documentation Insight, you should know how to browse and document source code in Delphi. In this tutorial, let’s see how to use Documentation Insight Enterprise version to produce rich documentation files with only a few steps.
1. Open an existing project or a project group in RAD Studio
5. In the next step, we can customize the header and footer template. If we would like to generate documentation for code elements in the implementation section, just check the first option.
Note: The templates must be valid. You may use the following variables: <%TopicTitle%>, <%Title%>,<%Author%>,<%Summary%>,<%Comment%>,<%Copyright%>
6. Publish options
At last, we may choose the output documentation types and their corresponding location. The locations are relative to current documentation project.
Tick, tick, tick… It Succeeded!
* Web pages
Online Documentation Sample: http://www.devjetsoftware.com/demos/spring4d/
* Microsoft Help 2 file
When you click the hyperlink of MSHelp2 file (Single .HxS file), the file will be automatically registered and Documentation Insight will use Microsoft Documentation Explorer (dexplore.exe) to browse the help file.
The help file will be automatically integrated into your local RAD Studio Documentation (2005-XE2).
* Help & Manual
Help & Manual is a well-known help authoring software. Documentation Insight can extract documentation from your source code and generate H&M files so that you may merge it into your own H&M project. Then you can customize the template in H&M and publish them together to produce uniform help files and deliver to your customers. (H&M also supports various formatting e.g. Web page, CHM, PDF, RTF, E-Books.)
Applying a H&M skin and publish to a CHM file like this:
Can’t wait to generate documentation? Try Documentation Insight!