How do I customize the way my documentation looks?
Table of Contents
The DOC xPress and DOC xPress Server templates are used to lend form and reason to the output. They are fully customizable and control what information is included in the documentation.
For users that are just beginning to learn how to customize their templates, it is recommended that they first read through the introduction before continuing. After completing the introduction, the document control, structure map, and templates pages can provide users with a more detailed description of the functions present within the DOC xPress template documentation generation.
By default, the templates are stored within a folder in the installation directories for Pragmatic Workbench and Workbench Server. Below can be found the two default install locations:
• DOC xPress
o C:\Program Files (x86)\Pragmatic Works\Pragmatic Workbench\DOC xPress Templates
• DOC xPress Server
o C:\Program Files (x86)\Pragmatic Works\Workbench Server\DOC xPress Web Services\DefaultTemplates
Modification of the DOC xPress templates are not officially supported by Pragmatic Works and this cannot be stressed enough. While we do provide documentation and guidance within the help documentation, any modification to the DOC xPress templates is taken at the risk of the user.
Because of this, users are encouraged to back up the DOC xPress templates folder before beginning any modification work. At this time, the only assistance Pragmatic Works Support may offer is in the restoration of the template files to their original state.
• *.template files – control the general layout of an object and the properties that are displayed within that object's page
• defaultTemplate.documentControl – This file is responsible for setting what is and is not displayed within templates and Structure Maps using output type flags that are set in the Generate Documentation dialog box.
• StructureMap.*.xml – Controls the overall structure of the root object within a Solution Layout. If a valid Structure Map cannot be found then the StructureMap.Default.xml will be used, which is a data dump.
• TemplateImage – This folder contains small (16x16) and large (32x32) icons for many of the major templates. To add additional TemplateImages, the images must be saved within the TemplateImage folder in the following syntax: <template key><size>
o template key – The key of the template file that you wish to include, as described in the templates Page( ) function.
o size – Whether this template image is the small (16x16) or large (32x32) version of the icon
If you plan to use custom templates, please ensure that you take a back-up of the existing templates and point the templates folder to a new location with DOC xPress. You cannot edit the templates, lookups, document control, structure maps, images, or template images in the default folder and must first copy them into a new template location.
Additionally, you may be required to change the template and structure map files from Read-Only before being able to edit them.