DITA Open Toolkit User Guide Fourth Edition - December 3, 2007 - DITA Open Toolkit 1.4.1 OpenTopic | TOC | 3 Contents Abstract................................................................................................................................13 Chapter 1: Introduction................................................................................15 About DITA (Darwin Information Typing Architecture).......................................................................16 About DITA Open Toolkit (DITA OT)...................................................................................................16 About this document..............................................................................................................................17 Chapter 2: Key concepts (DITAdemystified)..............................................19 Documentation lifecycle.........................................................................................................................20 Traditional lifecycle....................................................................................................................20 Typical DITA lifecycle...............................................................................................................20 Technology trends in the documentation lifecycle.....................................................................21 Creating and managing content..................................................................................................22 Processing and publishing......................................................................................................................23 Processing and publishing overview..........................................................................................23 About XML................................................................................................................................24 About DTDs...............................................................................................................................26 About schemas...........................................................................................................................26 About XSLT...............................................................................................................................27 About XPath...............................................................................................................................27 About Java..................................................................................................................................28 Project components................................................................................................................................28 Source files.................................................................................................................................29 Processing files...........................................................................................................................31 Output files.................................................................................................................................33 Chapter 3: Getting started............................................................................37 Phase 1: Planning and setting up your environment..............................................................................38 Phase 2: Setting up.................................................................................................................................38 Phase 3: Implementing...........................................................................................................................38 Chapter 4: Getting information (general)...................................................39 General information...............................................................................................................................40 Tools and downloads..............................................................................................................................40 Training and education...........................................................................................................................40 Consulting..............................................................................................................................................41 Standards, releases.................................................................................................................................42 Usage......................................................................................................................................................43 4 | OpenTopic | TOC User groups............................................................................................................................................43 Conferences............................................................................................................................................43 Chapter 5: Evaluating DITA and DITA Open Toolkit...............................45 The DITA authoring/production framework..........................................................................................46 Use cases................................................................................................................................................48 Use case template...................................................................................................................................49 Chapter 6: Installing and upgrading DITA Open Toolkit..........................51 System requirements and supported applications..................................................................................52 Installation overview..............................................................................................................................54 DITA Tookit distributions...........................................................................................................54 Upgrade considerations..............................................................................................................54 Installation considerations..........................................................................................................55 Installing your DITA authoring tool.......................................................................................................55 Installing the Java SDK (JDK)...............................................................................................................55 Installing the JDK on Windows..................................................................................................55 Installing the JDK on Linux.......................................................................................................56 Installing the DITA Tookit full package distribution.............................................................................56 Installing the DITA Tookit small package distribution..........................................................................58 Installing the small package on Windows..................................................................................58 Installing the small package on Linux........................................................................................61 Installing on Mac OS..............................................................................................................................63 Directories and files in the ditaot directory............................................................................................63 Installing the optional tools....................................................................................................................64 Installing the HTML Help compiler on Windows......................................................................64 Installing FOP on Windows........................................................................................................65 Installing the JavaHelp processor on Windows..........................................................................65 Installing FOP on Linux.............................................................................................................65 Installing the JavaHelp processor on Linux...............................................................................66 DITAblogs (installing and upgrading)....................................................................................................66 Chapter 7: DITA Open Toolkit plug-ins......................................................67 About DITA Open Toolkit plug-ins........................................................................................................68 Installing the plug-ins.............................................................................................................................68 Installing the Idiom FO plug-in..................................................................................................69 DITAblogs (plug-ins).............................................................................................................................69 For more information (plug-ins).............................................................................................................69 Chapter 8: Setting up your working environment......................................71 Configuring your authoring tool to use the Toolkit catalog...................................................................72