Oxygen XML Author 12.2 Oxygen XML Author | TOC | 3 Contents Chapter 1: Introduction................................................................................11 Key Features and Benefits of Oxygen XML Author .............................................................................12 Chapter 2: Installation..................................................................................13 Installation Requirements.......................................................................................................................14 Platform Requirements...............................................................................................................14 Operating System.......................................................................................................................14 Environment Requirements........................................................................................................14 Installation Instructions..........................................................................................................................14 Eclipse Plugin.............................................................................................................................15 Obtaining and Registering a License Key..............................................................................................16 Named User License Registration..............................................................................................16 Named User License Registration with Text File.......................................................................17 How Floating (Concurrent) Licenses Work................................................................................17 License Registration with an Activation Code...........................................................................22 Unregistering the License Key...............................................................................................................22 Upgrading the Oxygen XML Author Application..................................................................................22 Upgrading the Eclipse Plugin.....................................................................................................22 Checking for New Versions....................................................................................................................23 Uninstalling the Application...................................................................................................................23 Uninstalling the Eclipse plugin..................................................................................................23 Chapter 3: Getting Started...........................................................................25 Getting Help...........................................................................................................................................26 Supported Types of Documents..............................................................................................................26 Perspectives............................................................................................................................................26 Oxygen XML Perspective .........................................................................................................27 Oxygen Database Perspective ...................................................................................................30 Chapter 4: Editing Documents.....................................................................33 Working with Unicode...........................................................................................................................34 Opening and Saving Unicode Documents..................................................................................34 Opening and Closing Documents...........................................................................................................34 Creating New Documents..........................................................................................................34 Saving Documents......................................................................................................................38 Opening and Saving Remote Documents via FTP/SFTP ..........................................................38 Opening the Current Document in a Web Browser....................................................................42 4 | Oxygen XML Author | TOC Closing Documents....................................................................................................................42 Viewing File Properties..............................................................................................................42 Editing XML Documents.......................................................................................................................42 Associate a Schema to a Document...........................................................................................43 Streamline with Content Completion.........................................................................................46 Validating XML Documents......................................................................................................53 Document Navigation.................................................................................................................61 Grouping Documents in XML Projects.....................................................................................64 Working with XML Catalogs.....................................................................................................67 Formatting and Indenting Documents (Pretty Print)..................................................................68 Viewing Status Information........................................................................................................69 XML Editor Specific Actions.....................................................................................................69 Handling Read-Only Files......................................................................................................................72 Chapter 5: Authoring in the Tagless Editor................................................73 Authoring XML Documents Without the XML Tags............................................................................74 General Author Presentation..................................................................................................................75 Author Views..............................................................................................................................76 The Author Editor.......................................................................................................................81 Review........................................................................................................................................93 Profiling / Conditional Text........................................................................................................95 Chapter 6: Author for DITA.......................................................................101 Creating DITA Maps and Topics..........................................................................................................102 Editing DITA Maps..............................................................................................................................102 Editing Actions.........................................................................................................................104 Creating a Map.........................................................................................................................105 Validating DITA Maps.............................................................................................................105 Create a Topic in a Map............................................................................................................106 Organize Topics in a Map.........................................................................................................106 Create a Bookmap....................................................................................................................106 Create a Subject Scheme..........................................................................................................107 Create Relationships Between Topics......................................................................................107 Advanced Operations...............................................................................................................108 Transforming DITA Maps and Topics..................................................................................................111 Available Output Formats.........................................................................................................111 Configuring a DITA Transformation........................................................................................113 Running a DITA Map ANT Transformation............................................................................114 Customizing a DITA Scenario..................................................................................................114 Set a Font for PDF Output Generated with Apache FOP.........................................................120 DITA-OT Customization......................................................................................................................120