28.6.2 Enabling links to renamed or relocated files

You might run into situations where the names of DITA files are not usable for HTML files. For example, files on UNIX systems must not have spaces in their names. And for HTML Help, the use of underscores in names seems to manifest defects.

Note:  To stay out of trouble, restrict file names to letters and digits only, no spaces or other characters. See §1.1.2 File, directory, and path names.

If you need to rename HTML files after DITA2Go produces them, you must tell DITA2Go the names (and possibly the file paths) to use for the renamed files in links. This step is essential if any links exist between the renamed files and other files in the project, or other files in another directory. For example:

[XrefFiles]
; original filename (no ext) = html filename (no ext, path OK)
Code1 = ../codes/federal/Code1
Cover = 00begin

Note:  Even if you rename a file in [XrefFiles], DITA2Go goes by the original DITA name in all other sections of the configuration file.

Entries in [XrefFiles] replace the href link to the file named on the left of the equals sign (base name) with the path and name on the right. Therefore you can also use this method to provide paths to files that will be relocated to a directory different from the main project directory.

Previous Topic:  28.6.1 Retaining file paths in interfile links

Next Topic:  28.7 Linking to external destinations

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

Sibling Topics:

28.6.1 Retaining file paths in interfile links