28.6.1 Retaining file paths in interfile links

By default, DITA2Go removes paths from interfile links in your DITA files. If your HTML files will be maintained in a directory structure identical to the structure used for the DITA files from which they are generated, you must direct DITA2Go to retain the paths in all interfile links, and then move the output files after conversion.

To retain file paths in interfile links:

[HTMLOptions]
; RemoveFilePaths = Yes (default, strip hyperlink and xref paths)
;  or No
RemoveFilePaths = No

When RemoveFilePaths=Yes (the default), DITA2Go places all HTML files in the project directory, regardless of where the originating DITA files are located. Links work as created, regardless of the original directory structure. A problem arises only if both of the following are true:

Note:  You might still get link errors for links between DITA files, especially if you are using the CodeStore property (see §37.9.3 Surrounding or replacing text with code or macros); however, the links should work.

When RemoveFilePaths=No, you must place HTML output files in a directory structure on the target system that is identical to your DITA directory structure. This means that after conversion, you must move HTML files from the project directory to other directories that correspond in name and relative position to the directories where the DITA files are located.

Previous Topic:  28.6 Linking to other files and other DITA2Go projects

Next Topic:  28.6.2 Enabling links to renamed or relocated files

Parent Topic:  28.6 Linking to other files and other DITA2Go projects

Sibling Topics:

28.6.2 Enabling links to renamed or relocated files