The grocery shopping sample, which is located in the ditaot/doc/ot-userguide/MY_DITA_SOURCE/samples directory of the Toolkit source distribution, 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 the XHTML, HTML Help, and PDF2 targets are also provided.
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 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 MY_DITA_SOURCE/samples/groceryshopping directory, which contains a number of subdirectories.
Your directory structure should look like this:
Files in the template directory 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 could modify to try and test other DITA features.