About the grocery shopping sample

The grocery shopping sample, which is downloadable from http://dita-ot.sourceforge.net/SourceForgeFiles/doc/user_guide.html, is a simple DITA project that includes seven topics: an overview topic, two concepts, two tasks, and two reference topics. The project also includes a map that aggregates the files and links them meaningfully using a relationship table. Ant scripts that process to all DITA Open Toolkit targets are also provided.

Before you begin to use the grocery shopping sample files, we recommend creating two directories in your root directory called DITASAMPLE_GROCERY_SOURCE and DITASAMPLE_GROCERY_OUTPUT (Windows examples would be C:/DITASAMPLE_GROCERY_SOURCE and C:/DITASAMPLE_GROCERY_OUTPUT) and then copying into them both the grocery shopping sample files DITASAMPLE_GROCERY_SOURCE. Your directory structure should then look like this:

The grocery shopping sample assumes you are already familiar with the garage sample provided as both a project model as well as a tool to verify your DITA Open Toolkit installation, and that you have processed the garage sample as described in Processing (building) and publishing DITA documents.

Creating and processing the grocery shopping sample

You will be working in the DITASAMPLE_GROCERY_SOURCE directory, which contains a number of subdirectories.

Files in the template subdirectory provide you with a starting point for each file in your grocery shopping project. The first step in each task in this chapter is to copy a file from the template directory to the working directory. Then edit the "working" version of the file, as instructed.

If you need help along the way, you can use the files in the completed directory for reference.

The Ant scripts (in the ant_scripts directory) assume you will process (build) the "working" version of the files. Ant scripts that build the "completed" files are also provided.

If you follow the instructions in this chapter and the next ("Creating Maps") you will have your own working version of the sample, which you can modify to try and test DITA and Toolkit features not included in the sample files.