About the garage sample

The garage sample, which is located in the ditaot/doc/ot-usergide/MY_DITA_SOURCE/samples directory of the Toolkit source distribution, is a set of DITA source files containing concepts and tasks related to organizing and doing tasks in a garage. The sample map files allow the topics to be published as either a hierarchy or a sequence. The sample also includes Ant scripts to allow you to publish to all supported target environments.

Before you begin to use the sample files (which include both the garage sample and the grocery shopping sample), we recommend creating two directories in your root directory called MY_DITA_SOURCE and MY_DITA_OUTPUT (Windows examples would be C:/MY_DITA_SOURCE and C:/MY_DITA_OUTPUT) and then copying both the garage and grocery shopping sample files from the ditaot/samples directory to MY_DITA_SOURCE. Your directory structure should then look like this:

The garage sample includes Ant scripts that process to all supported target environments. A filtering (conditional processing) script is also included: garage_filtering_xhtml.xml. This script filters out (excludes) all files having to do with oil or snow, which are tagged with the "otherprops" attribute. Running this script produces a hierarchically organized output file with four of the topics excluded.