44.9 Gathering files for an HTML project: an example

Suppose your file structure looks like this:

D:\AllDocs\CSS              CSS files for all HTML projects
D:\MyDoc                    DITA files, projects file
D:\MyDoc\Graphics           Graphics
D:\MyDoc\HTML               DITA2Go output files and project configuration file

And you want the files for your HTML project assembled as follows:

D:\MyDoc\HTML\_wrap          HTML files should be copied here
D:\MyDoc\HTML\_wrap\images   Graphics files should be copied here
D:\MyDoc\HTML\_wrap\styles   CSS files should be copied here

Your projects file (.prj, in D:\MyDoc with your DITA files) would specify D:\MyDoc\HTML as the path for DITA2Go to use for output. D:\MyDoc\HTML is also where your project configuration file is located.

To get all the files where you want them, in the configuration file you would specify the following: 

Section

Setting

[Automation]
WrapPath=.\_wrap 

A location relative to the project directory. You could just as well use the absolute path: WrapPath=D:\MyDoc\HTML\_wrap. Notice the backslashes here, which are required for Windows.

CopyCssFrom=D:\AllDocs\CSS 

Where to find the CSS files for this project. Path separators are backslashes.

CopyGraphicsFrom=D:\MyDoc\Graphics

Where to find graphics for this project. Path separators are backslashes.

GraphCopyFiles=*.jpg *.gif 

Files you want from the CopyGraphicsFrom directory.

[CSS]
CssPath=.\styles 

Where CSS files should be relative to the HTML files that use them (that is, relative to the WrapPath directory). DITA2Go converts backslashes to forward slashes before writing these references in the HTML files.

[Graphics]
GraphPath=.\images 

Where the graphics should be relative to the HTML files that reference them (that is, relative to the WrapPath directory). DITA2Go converts backslashes to forward slashes before writing these references in the HTML files.

Previous Topic:  44.8 Placing CSS or XSL files for assembly

Next Topic:  44.10 Gathering and processing Help-system files

Parent Topic:  44. Producing deliverable results

Sibling Topics:

44.1 Understanding DITA2Go pre- and post-processing

44.2 Activating and logging production of deliverables

44.3 Understanding path values for deliverables

44.4 Clearing out old files before converting

44.5 Gathering additional files before converting

44.6 Assembling files for distribution

44.7 Placing graphics files for distribution

44.8 Placing CSS or XSL files for assembly

44.10 Gathering and processing Help-system files

44.11 Archiving deliverables

44.12 Placing deliverables in a shipping directory

44.13 Postprocessing separately from converting