Elaboration on how the generate.outer.copy parameter functions.
- The DITA map is in a directory that is a peer to directories that contain referenced objects.
- The DITA map is in a directory that is below the directories that contain the referenced objects.
maps topics imagesThe DITA map is in the maps directory, the topics are in the topics directory, and the images are in the images directory.
Setting the generate.outer.copy parameter to 1
A-test --- dita.list --- dita.xml.properties --- index.html --- commonltr.css --- commonrtl.cssThe index.html file contains the navigation structure, but all the links are broken, since no XHTML files were built for the topics.
How do you fix this? By specifying a value of 2 or 3 for the generate.outer.copy parameter.
Setting the generate.outer.copy parameter to 2
- The generate.outer.copy parameter is set to 2.
- The output.dir parameter is set to C:\A-test.
C:\A-test --- dita.list --- dita.xml.properties --- index.html --- commonltr.css --- commonrtl.css ... C:\images ... C:\topics
The links in the output all work properly. However, depending on how many other directories are located at the same level of your build system as the output directory, it might not be easy gather all the output together if you need to copy it elsewhere.
Setting the generate.outer.copy parameter to 3
C:\A-test --- images\ --- maps\ --- topics\The index.html file is in the maps directory, and the CSS and other files are located in the output directory, C:\A-test. Copying the output directory is simplified.