DITA Help Technologies Guide (DEVELOPMENT REVIEW 3Jan2011) | TOC | 2
Total Page:16
File Type:pdf, Size:1020Kb
DITA Help Technologies Guide (DEVELOPMENT REVIEW 3jan2011) | TOC | 2 Contents Introduction......................................................................................................................................4 Editorial Preface....................................................................................................................................................4 DITA and User Assistance.....................................................................................................................................5 De®nition of DITA Help.......................................................................................................................................5 Contributors...........................................................................................................................................................5 Document History.................................................................................................................................................6 Help Delivery Technologies.............................................................................................................7 Adobe AIR-based Help.........................................................................................................................................7 Browser-based Help..............................................................................................................................................8 MadCap DotNet Help..........................................................................................................................................10 Eclipse Help........................................................................................................................................................10 IDPF EPUB Deliverable......................................................................................................................................11 Java Help.............................................................................................................................................................12 Microsoft HTML Help........................................................................................................................................12 Microsoft Viewer 1.0 Help..................................................................................................................................13 Microsoft WinHelp..............................................................................................................................................14 Omni Systems OmniHelp....................................................................................................................................14 Oracle Help..........................................................................................................................................................14 PDF Deliverable..................................................................................................................................................15 PTC Arbortext DMP Help...................................................................................................................................16 Quadralay WebWorks Help.................................................................................................................................16 UNIX Man Pages................................................................................................................................................16 Wiki.....................................................................................................................................................................17 Help Development Tools................................................................................................................18 DITA Open Toolkit..............................................................................................................................................18 DITA-OT: PDF........................................................................................................................................18 DITA-OT: Browser-based Help...............................................................................................................18 DITA-OT: Eclipse Help...........................................................................................................................33 DITA-OT: DITA for Publishers Plug-in..................................................................................................45 DITA-OT: Microsoft HTML Help..........................................................................................................46 DITA-OT: Leximation AIR Help Plug-in................................................................................................51 Adobe FrameMaker.............................................................................................................................................54 Adobe RoboHelp.................................................................................................................................................55 Converting DITA Content to WebHelp using RoboHelp........................................................................55 DITA Exchange...................................................................................................................................................55 JustSystems XMetaL...........................................................................................................................................55 MadCap Blaze.....................................................................................................................................................55 MadCap Flare......................................................................................................................................................56 Omni Systems DITA2Go....................................................................................................................................56 SyncRO Soft Ltd Oxygen 12.x Editor.................................................................................................................56 | TOC | 3 PTC Arbortext Digital Media Publisher..............................................................................................................63 Quadralay ePublisher..........................................................................................................................................69 SDL XPP.............................................................................................................................................................69 WinANT Echidna................................................................................................................................................69 WinANT Options Supporting HTML-Based Output..............................................................................70 WinANT Options Supporting Microsoft HTML Help ...........................................................................72 XMLMind DITA Converter................................................................................................................................74 Help Development Techniques......................................................................................................75 Developing Custom DITA-based Help Systems.................................................................................................75 Developing DITA-based Help for Existing Help Environments.........................................................................75 DHTML Effects in HTML Generated from DITA..............................................................................................76 Dynamic Rendering of DITA into XHTML........................................................................................................78 JavaScript-Based Context Sensitive Help...........................................................................................................79 Resources........................................................................................................................................83 | Introduction | 4 Introduction When DITA was ®rst described to the world in the article Introduction to the Darwin Information Typing Architecture by Don Day, Michael Priestley, and Dave A. Schell, speci®c reference was made to Help in the opening de®nition: ªand for using that content in delivery modes such as online help.º DITA was designed with Help systems in mind. Indeed, from the release of OASIS DITA 1.0, the DITA Open Toolkit has supported various forms of Help output. However, Help is a somewhat amorphous term; it means different things to different people. Early adopters of DITA found that while Help documents in common formats like Microsoft HTML Help, HTML and Eclipse Help could be created, some of the accustomed features were absent. Popups couldn©t be easily implemented, window layouts couldn©t be easily de®ned, and a tri-pane HTML output seemed impossible. Most importantly, context-sensitivity for most Help formats didn©t seem to be supported. The OASIS DITA Help Subcommittee was formed to address some of the perceived shortcomings of DITA for authoring Help content. The Subcommittee will recommend changes to the DITA standard to further improve functionality in time for DITA 1.3. In the interim, this DITA Help Technologies