Using DITA Quick Start Guide to G&D's DITA Future

Total Page:16

File Type:pdf, Size:1020Kb

Using DITA Quick Start Guide to G&D's DITA Future Giesecke & Devrient Using DITA Quick start guide to G&D's DITA future Version 1.0 Printed on 24th November 2015 Helmut Scherzer (Editor) Giesecke & Devrient / IBM Prinzregentenstr. 159 81677 Munich PO Box 80 07 29 Fon: +49 89 4119 2084 Mobile: +49 174 313 9891 mail: [email protected] http://www.gi-de.com http://www.hscherzer.de ID No.100.25003.230 © Copyright 2014 by Giesecke & Devrient Prinzregentenstr. 159 81677 Munich PO Box 80 07 29 This document as well as the information or material contained is copyrighted. Any use not explicitly permitted by copyright law requires prior testconsent of Giesecke & Devrient GmbH. This applies to any reproduction, revision, translation, storage on microfilm as well as its import and processing in electronical systems, in particular. Trademarks ezRead™ is a registered trademark of Giesecke Devrient GmbH, München. Java™ is a registered trademark of Oracle system IBM™ is a registered trademark of IBM Corp. Using DITA Table of Contents Table of Contents Tables ........................................................................................................................................................................... 6 Figures ......................................................................................................................................................................... 7 1 Installing the DITA environment ......................................................................................................... 9 1.1 Installing the command line interface ............................................................................................................... 10 1.2 Installing the DITA toolchain ............................................................................................................................. 11 1.3 oxygen installation ............................................................................................................................................ 12 1.4 oxygen configuration ......................................................................................................................................... 14 1.5 AHF installation ................................................................................................................................................. 17 1.6 AHF configuration ............................................................................................................................................. 17 1.7 Installing a plugin .............................................................................................................................................. 17 1.8 ezRead Installation ........................................................................................................................................... 17 2 Processing the DITA-OT ......................................................................................................................... 19 2.1 Using the command line ................................................................................................................................... 19 2.2 Running DITA with command line ..................................................................................................................... 20 2.3 Configuring oxygen for DITA-OT ....................................................................................................................... 21 2.3.1 Additional parameters ............................................................................................................................. 30 2.3.1.1 Default figure link text .................................................................................................................... 30 2.4 Running oxygen scenarios ............................................................................................................................... 31 2.5 How DITA is processed... .................................................................................................................................. 33 2.6 PDF post processing ........................................................................................................................................ 33 3 Important Topics ......................................................................................................................................... 35 3.1 Using figures ..................................................................................................................................................... 35 3.2 Basic figure aspects .......................................................................................................................................... 35 3.2.1 image-width ............................................................................................................................................. 36 3.2.2 Wrap text around figures ......................................................................................................................... 37 3.3 Working with the Glossary ................................................................................................................................ 37 3.3.1 Creating a local glossary from a master list ............................................................................................ 38 3.4 Working with equations ..................................................................................................................................... 38 4 DITA-OT extensions ................................................................................................................................... 39 4.1 Extensions on the paragraph. ........................................................................................................................... 39 4.2 Extensions on section ....................................................................................................................................... 40 4.3 oxygen Annotations .......................................................................................................................................... 41 4.4 Extensions to tables .......................................................................................................................................... 42 4.4.1 Repeat table header ................................................................................................................................ 42 4.5 Extensions to fig/image ..................................................................................................................................... 43 4.5.1 Creating Figures From Visio .................................................................................................................... 43 4.5.2 Links within graphics ............................................................................................................................... 46 4.5.3 Tryout figures ........................................................................................................................................... 49 4.6 Extension to links .............................................................................................................................................. 52 4.6.1 Linking figures and tables ........................................................................................................................ 53 4.6.2 Trying out links ........................................................................................................................................ 54 IBM / G&D Confidential 3 Table of Contents Using DITA 4.6.3 ezRead auto-linking ................................................................................................................................ 55 4.7 Extensions to Notes .......................................................................................................................................... 56 4.8 Extensions to lists ............................................................................................................................................. 57 4.9 Extensions to Mini-Toc ...................................................................................................................................... 58 4.10 New page ....................................................................................................................................................... 59 4.11 Keep Lines together ........................................................................................................................................ 60 4.12 Extension on the title element ......................................................................................................................... 60 5 Managing the front page ........................................................................................................................ 61 5.1 First page layout ............................................................................................................................................... 61 5.2 Company Logo ................................................................................................................................................. 61 5.3 Security Class ................................................................................................................................................... 62 5.4 Watermark .......................................................................................................................................................
Recommended publications
  • Publishing Pdfs from DITA
    Publishing PDFs from DITA Benefits and Limitations of XSL‐FO Benefits Introduction Low entry cost XSL‐FO is an XML language Scott Prentice, President of Leximation, Inc. FO markup language is largely based on CSS Specializing in FrameMaker plugin development as well as Designed to work for all written human languages structured FrameMaker conversions, consulting, and development. FrameMaker user/developer since 1991. Limitations Developed DITA‐FMx, a FrameMaker plugin for efficient XSL‐FO coding is expensive and complicated DITA authoring and publishing. Tables that span pages may not break as expected Developer of custom Help systems and creative/functional No way to render elements on one page in relation to web applications. another page Coined the term “A I R Help” in 2007 after learning about Difficult to apply balanced vertical spacing on a page Adobe’s new AIR technology. Processors may use extensions to implement features, so the Interested in creating innovative ways to provide user FO stylesheets may not be portable between processors assistance that is actually used. Apache FOP What is DITA (briefly) Open Source / Free DITA ‐ Darwin Information Typing Architecture Java application, runs on ʺanyʺ platform An XML format for authoring in a topic oriented structure Default PDF output option provided with the DITA‐OT Highly reusable and modular Rendering engine uses XSL‐FO DITA topics can be easily rearranged and reused for Requires XSL‐FO developer to maintain stylesheets different deliverable types Supports
    [Show full text]
  • Xmlmind XSL Utility - Online Help
    XMLmind XSL Utility - Online Help Hussein Shafie, XMLmind Software <[email protected]> February 23, 2021 Table of Contents 1. Overview ................................................................................................................................ 1 2. Running XMLmind XSL Utility ............................................................................................... 3 2.1. System requirements ..................................................................................................... 3 2.2. Installation ................................................................................................................... 3 2.3. Contents of the installation directory .............................................................................. 3 2.4. Starting XMLmind XSL Utility ..................................................................................... 4 2.5. XMLmind XSL Utility as a command-line tool .............................................................. 5 3. Converting an XML document to another format ....................................................................... 6 3.1. Canceling the current conversion process ....................................................................... 7 4. Changing the parameters of a conversion .................................................................................. 8 5. Specifying a conversion ......................................................................................................... 10 5.1. Specifying the conversion
    [Show full text]
  • Markup UK 2021 Proceedings
    2021 Proceedings A Conference about XML and Other Markup Technologies Markup UK 2021 Proceedings 2 Markup UK 2021 Proceedings 3 Markup UK 2021 Proceedings Markup UK Sister Conferences A Conference about XML and Other Markup Technologies https://markupuk.org/ Markup UK Conferences Limited is a limited company registered in England and Wales. Company registration number: 11623628 Registered address: 24 Trimworth Road, Folkestone, CT19 4EL, UK VAT Registration Number: 316 5241 25 Organisation Committee Geert Bormans Tomos Hillman Ari Nordström Andrew Sales Rebecca Shoob Markup UK 2021 Proceedings Programme Committee by B. Tommie Usdin, David Maus, Syd Bauman – Northeastern University Alain Couthures, Michael Kay, Erik Digital Scholarship Group Siegel, Debbie Lapeyre, Karin Bredenberg, Achim Berndzen – <xml-project /> Jaime Kaminski, Robin La Fontaine, Abel Braaksma – Abrasoft Nigel Whitaker, Steven Pemberton, Tony Peter Flynn – University College Cork Graham and Liam Quin Tony Graham – Antenna House Michael Kay – Saxonica The organisers of Markup UK would like to Jirka Kosek – University of Economics, thank Antenna House for their expert and Prague unstinting help in preparing and formatting Deborah A. Lapeyre – Mulberry the conference proceedings, and their Technologies generosity in providing licences to do so. David Maus – State and University Library Hamburg Antenna House Formatter is based on the Adam Retter – Evolved Binary W3C Recommendations for XSL-FO and B. Tommie Usdin – Mulberry Technologies CSS and has long been recognized as Norman Walsh – MarkLogic the most powerful and proven standards Lauren Wood – XML.com based formatting software available. It is used worldwide in demanding applications Thank You where the need is to format HTML and XML into PDF and print.
    [Show full text]
  • XSL-FO by Dave Pawson Publisher
    XSL-FO By Dave Pawson Publisher : O'Reilly Pub Date : August 2002 ISBN : 0-596-00355-2 Pages : 282 Table of • Contents • Index • Reviews Reader • Reviews Extensible Style Language-Formatting Objects, or XSL-FO, is a set of tools developers and web designers use to describe page printouts of their XML (including XHTML) documents. XSL-FO teaches you how to think about the formatting of your documents and guides you through the questions you'll need to ask to ensure that your printed documents meet the same high standards as your computer-generated content. 777 Copyright Preface Who Should Read This Book? What Does This Book Cover? Motivation Organization of This Book What Else Do You Need? Conventions Used in This Book How to Contact Us Acknowledgments Chapter 1. Planning for XSL-FO Section 1.1. XML and Document Processing Section 1.2. Choosing Your Print Production Approach Section 1.3. Choosing Tools Section 1.4. The Future for XSL-FO Chapter 2. A First Look at XSL-FO Section 2.1. An XSL-FO Overview Section 2.2. Related Stylesheet Specifications Section 2.3. Using XSL-FO as Part of XSL Section 2.4. Shorthand, Short Form, and Inheritance Chapter 3. Pagination Section 3.1. Document Classes Section 3.2. The Main Parts of an XSL-FO Document Section 3.3. Simple Page Master Section 3.4. Complex Pagination Section 3.5. Page Sequences Chapter 4. Areas Section 4.1. Informal Definition of an Area Section 4.2. Area Types Section 4.3. Components of an Area Section 4.4.
    [Show full text]
  • DITA Open Toolkit 2.0 This Document Describes the DITA Open Toolkit Project—What the Project Is, and How to Use the Site
    DITA Open Toolkit 2.0 This document describes the DITA Open Toolkit project—what the project is, and how to use the site. What is the DITA Open Toolkit? The DITA Open Toolkit, or DITA-OT for short, is a set of Java-based, open source tools that provide processing for DITA maps and topic content. You can download the OT and install it for free on your computer to get started with topic-based writing and publishing. The DITA-OT is licensed under the CPL 1.0 and Apache 2.0 open source licenses. Note: While the DITA Standard itself is owned and developed by OASIS, the DITA Open Toolkit is an independent, open source implementation of the standard. Key output formats for the toolkit include: XHTML PDF (formerly known as PDF2) ODT (Open Document Format) Eclipse Help TocJS (XHTML with a JavaScript frameset) HTML Help Java Help Eclipse Content (normalized DITA plus Eclipse project files) Word RTF (with some limitations) Docbook Troff Toolkit documentation There are two primary sources for documentation about the toolkit. Stable documentation about toolkit usage, parameters, and project management can be found on this page, using the navigation panel on the left. New information about the latest toolkit builds, plans for the next release, and other changing information can be found on the DITA-OT landing page at the dita.xml.org site (link below). That site also contains the release notes for all upcoming and previous releases. Related concepts Distribution packages Related information Main DITA-OT page at dita.xml.org Project News for DITA Open Toolkit Shortcuts to important information DITA-OT stable release DITA-OT latest development build Getting Started with the DITA Open Toolkit The Getting Started Guide is designed to provide a guided exploration of the DITA Open Toolkit.
    [Show full text]
  • Xmlmind DITA Converter Manual
    XMLmind DITA Converter Manual Hussein Shafie XMLmind Software 35, rue Louis Leblanc 78120 Rambouillet France Phone: +33 (0)9 52 80 80 37 [email protected] www.xmlmind.com/ditac/ May 14, 2021 XMLmind DITA Converter Manual Table of Contents List of Figures ............................................................................................................................................. ii List of Tables ............................................................................................................................................. iii Introduction ................................................................................................................................................. iv Part I. Using XMLmind DITA Converter .............................................................................. 1 Chapter 1. Installing XMLmind DITA Converter ......................................................................... 2 1. Contents of the installation directory ...................................................................................... 3 Chapter 2. Getting started ................................................................................................................ 6 1. Using the ditac command-line utility ...................................................................................... 6 Chapter 3. The ditac command-line utility ................................................................................... 14 Chapter 4. XSLT stylesheets parameters .....................................................................................
    [Show full text]
  • Ntent Copyright © 2011 Anthony Self
    Content copyright © 2011 Anthony Self. This content is licensed under the Creative Com- mons Attribution-Noncommercial 3.0 Unported License (http://creativecommons.org/ licenses/by-nc/3.0/) with exceptions noted in the following paragraphs. Contributed samples are owned by their creators, who are credited in the text. Cover design copyright © 2011 Scriptorium Publishing Services, Inc. Scriptorium Press, Scriptorium Publishing Services, and the Scriptorium Press logo are trademarks of Scripto- rium Publishing Services, Inc. All other trademarks used herein are the properties of their respective owners and are used for identification purposes only. Every effort was made to ensure this book is accurate. However, the author and Scriptorium Publishing Services assume no responsibility for errors or omissions, or for use of information in this book. The author and Scriptorium Publishing Services assume no responsibility for third-party content referenced in this book. Published by Scriptorium Press, the imprint of Scriptorium Publishing Services, Inc. For information, contact: Scriptorium Publishing Services, Inc. PO Box 12761 Research Triangle Park, NC 27709-2761 USA Attn: Scriptorium Press www.scriptorium.com/books [email protected] ISBN: 978-0-9828118-1-8 Cover design by Alan S. Pringle and David J. Kelly Index by Tony Self The author developed the source files for the content in DITA. With the exception of the title page and copyright notice, page layout in this book is from Scriptorium’s DITA PDF plugin processed by the Antenna
    [Show full text]
  • Oxygen XML Editor 12.2
    Oxygen XML Editor 12.2 Oxygen XML Editor | TOC | 3 Contents Chapter 1: Introduction................................................................................17 Key Features and Benefits of Oxygen XML Editor ..............................................................................18 Chapter 2: Installation..................................................................................21 Installation Requirements.......................................................................................................................22 Platform Requirements...............................................................................................................22 Operating System.......................................................................................................................22 Environment Requirements........................................................................................................22 JWS-specific Requirements.......................................................................................................22 Installation Instructions..........................................................................................................................23 Windows Installation..................................................................................................................23 Mac OS X Installation................................................................................................................24 Linux Installation.......................................................................................................................24
    [Show full text]
  • Oxygen XML Author Eclipse Plugin 17.1
    Oxygen XML Author Eclipse Plugin 17.1 Notice Copyright Oxygen XML Author plugin User Manual Syncro Soft SRL. Copyright © 2002-2015 Syncro Soft SRL. All Rights Reserved. All rights reserved. No parts of this work may be reproduced in any form or by any means - graphic, electronic, or mechanical, including photocopying, recording, taping, or information storage and retrieval systems - without the written permission of the publisher. Products that are referred to in this document may be either trademarks and/or registered trademarks of the respective owners. The publisher and the author make no claim to these trademarks. Trademarks. Many of the designations used by manufacturers and sellers to distinguish their products are claimed as trademarks. Where those designations appear in this document, and Syncro Soft SRL was aware of a trademark claim, the designations have been rendered in caps or initial caps. Notice. While every precaution has been taken in the preparation of this document, the publisher and the author assume no responsibility for errors or omissions, or for damages resulting from the use of information contained in this document or from the use of programs and source code that may accompany it. In no event shall the publisher and the author be liable for any loss of profit or any other commercial damage caused or alleged to have been caused directly or indirectly by this document. Link disclaimer. Syncro Soft SRL is not responsible for the contents or reliability of any linked Web sites referenced elsewhere within this documentation, and Syncro Soft SRL does not necessarily endorse the products, services, or information described or offered within them.
    [Show full text]
  • DITA Open Toolkit User Guide
    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
    [Show full text]
  • <Oxygen/> XML Editor 11.2 User Manual for Eclipse
    <oXygen/> XML Editor 11.2 User Manual for Eclipse SyncRO Soft Ltd. <oXygen/> XML Editor 11.2 User Manual for Eclipse SyncRO Soft Ltd. Copyright © 2002-2009 SyncRO Soft Ltd. All Rights Reserved. <oXygen/> XML Editor User Manual Copyright © 2009 Syncro Soft SRL All rights reserved. No parts of this work may be reproduced in any form or by any means - graphic, electronic, or mechanical, including photocopying, recording, taping, or information storage and retrieval systems - without the written permission of the publisher. Products that are referred to in this document may be either trademarks and/or registered trademarks of the respective owners. The publisher and the author make no claim to these trademarks. While every precaution has been taken in the preparation of this document, the publisher and the author assume no responsibility for errors or omissions, or for damages resulting from the use of information contained in this document or from the use of programs and source code that may accompany it. In no event shall the publisher and the author be liable for any loss of profit or any other commercial damage caused or alleged to have been caused directly or indirectly by this document. Many of the designations used by manufacturers and sellers to distinguish their products are claimed as trademarks. Where those designations appear in this book, and SyncRO Soft Ltd., was aware of a trademark claim, the designations have been printed in caps or initial caps. While every precaution has been taken in the preparation of this book, the publisher assumes no responsibility for errors or omissions, or for damages resulting from the use of the information contained herein.
    [Show full text]
  • DITA Open Toolkit 1.8.4 This Document Describes the DITA Open Toolkit Project—What the Project Is, and How to Use the Site
    DITA Open Toolkit 1.8.4 This document describes the DITA Open Toolkit project—what the project is, and how to use the site. What is the DITA Open Toolkit? The DITA Open Toolkit, or DITA-OT for short, is a set of Java-based, open source tools that provide processing for DITA maps and topic content. You can download the OT and install it for free on your computer to get started with topic-based writing and publishing. The DITA-OT is licensed under the CPL 1.0 and Apache 2.0 open source licenses. Note: While the DITA Standard itself is owned and developed by OASIS, the DITA Open Toolkit is an independent, open source implementation of the standard. Key output formats for the toolkit include: XHTML PDF (formerly known as PDF2) ODT (Open Document Format) Eclipse Help TocJS (XHTML with a JavaScript frameset) HTML Help Java Help Eclipse Content (normalized DITA plus Eclipse project files) Word RTF (with some limitations) Docbook Troff Toolkit documentation There are two primary sources for documentation about the toolkit. Stable documentation about toolkit usage, parameters, and project management can be found on this page, using the navigation panel on the left. New information about the latest toolkit builds, plans for the next release, and other changing information can be found on the DITA-OT landing page at the dita.xml.org site (link below). That site also contains the release notes for all upcoming and previous releases. Related concepts Distribution packages Related information Main DITA-OT page at dita.xml.org Project News for DITA Open Toolkit Shortcuts to important information DITA-OT stable release DITA-OT latest development build Getting Started with the DITA Open Toolkit The Getting Started Guide is designed to provide a guided exploration of the DITA Open Toolkit.
    [Show full text]