An xmlbased technical documentation authoring and publishing architecture michael priestley, gretchen hargis, and susan carpenter t his column examines emerging technologies of interest to technical communicators to help them identify those that are worthy of further investigation. The dita map and mapgroup domain elements organize topics into hierarchies, groups, and relationships. Darwin information typing architecture dita, first introduced by ibm in 2001, is an xml data model that is designed to support a more structured approach to authoring and publishing content. If you have created a book as a dita map document, you can publish the book in responsive html5 with framemaker as shown in this tutorial. The map element describes the relationships among a set of resources, such as dita topics. Converting content to dita isnt a small undertaking, because youll essentially have to retag everything with the dita markup. The dita ot pdf plugin generator is developed as a spare time project by jarno elovirta and is available for use free of charge. This is the new home for the dita for publishers project migrated from its original home on sourceforge. Embed a pdf document into the pdf file you generate from your dita map. Jan 21, 2010 overall, i think practical dita is a useful book for readers who want to dip their toes into the dita stream and get started. Aug 05, 20 dita is seeing increasing use outside of the original computer software and hardware sectors from which it was born. Immediate download and read free dita best practices.
Dita maps are documents that organize topics and other resources into structured collections of information. It is intended neither as an endorsement of any technol. The dita map and map group domain elements organize topics into hierarchies, groups, and relationships. The publishing for dita workshop provides attendees with a handson walkthrough of the essential dita fundamentals, programming skills, and dita open toolkit configurations required to style and publish dita xml source. This second edition covers the dita open toolkit, version 2, including customizing the dita 1. Describes the dita map and topic authoring commands as well as the enhanced dita publishing features. One of the speakers i met for the first time was professor carlos evia, ph. Supports fop via the foppdfimages plugin and antenna house. These are not necessarily examples of good topicbased authoring or proper use. Publish dita topic or map in the context of a dita root map. A roadmap for writing, editing, and architecting in dita ibm press book by clicking the link above. Rightclick the dita map folder, and from the menu that displays, click open map editor. With a few simple changes, its possible to give the ditaots default pdf output much of your own look and feel. The darwin information typing architecture or document information typing architecture dita is an xml data model for authoring and publishing.
Dec 20, 2011 if youre a writer, editor, information architect, manager, or consultant who evaluates, deploys, or uses dita, this book will guide you all the way to success. The audio and video content included with this enhanced ebook can be viewed only using ibooks on an ipad, iphone, or ipod touch. Leigh whites book, dita for print, has become the goto reference for building a print customization plugin for the dita open toolkit. The dita package includes xslt stylesheets that enable you, with a single command, to transform all the documents referenced by a map to html and build a table of contents that links to all of them. Comments on discussion boards from them will be hidden by default. The dita map displays in the document structure pane in the dita map editor of the astoria workbench.
The flat physical map represents one of many map types available. Information architects content strategists information developers for both publications and training publications and training managers upcoming workshop. Open the book from the dita map document, dita map example. The element is a map specialization used to describe the relationships among a set of dita topics intended to be configured as a. Welcome joann hackos president, comtech services, inc. Provide unique short descriptions for reused topics 103. Publish dita topic or map in the context of a dita root. A dita map is a container for topics used to transform a collection of content into a publication. These books serve primarily as realistic test documents used to exercise the ditatoindesign process, but they also serve more generally as nontrivial, interesting, unencumbered sample dita documents that can be used for demonstration. The bookmap element is a map specialization used to describe the relationships among a set of dita topics intended to be configured as a traditional book.
I truly like to read this book computers and internet. Dita writer blog, resource, interviews and news relating to. Open the book from the dita map document, ditamapexample. The element describes the relationships among a set of resources, such as dita topics. If you need to develop a dita proof of concept for your organization, these.
Madonna ciccone, an american entertainer who uses dita as one of her stagealbum personalities, for the song erotica constantina di. When output as html or html help, the dita imagemap converts to the html equivalent, allowing you to designate a linkable area or region over an image. A map can include relationship tables reltables that define hyperlinks between topics. Doesnt work with map based page sequence generation, which is the default behavior from dita ot 2. For example, consider the following chapter in a map. Can now specify map and topic generation details on elements since these are usually the same for all instances of a given topic or map type. Look at dita, zamboanga del sur, region 9, philippines from different perspectives. Dita specification the darwin information typing architecture dita specification defines both a a set of document types for authoring and organizing topicoriented information. Dita publishing module an optional addon to quark xml author, the dita publishing module embeds and enhances the dita open toolkit to assemble and publish dita documents in multiple formats including print, web, and various help formats chm and eclipse. Provide short descriptions for links to nondita content 105.
A roadmap for writing, editing, and architecting in dita ibm press book. The book is published by scriptorium press, a specialist publisher for the technical communication industry the author. Maps can reference topics or other maps, and can contain a variety of content types and metadata. One of those areas where dita has taken off is in the healthcare technology sector, and recently i had the pleasure to interview mike kocik, who is the information architect at carestream, where he has ledread more. This is the video enhanced ebook version of the print title. Maps express these relationships in a single common format that can be used for different outputs. It could have used another editing pass, a little more meat, in particular some detailed examples, and the print formatting reveals some of the limitations in the current version of the dita open toolkit. Overall, i think practical dita is a useful book for readers who want to dip their toes into the dita stream and get started. This will prevent dita from sending you messages, friend request or from viewing your profile. The dita maps manager is displayed each time you open a.
The package also includes a stylesheet for merging all the documents referenced by a map into a single dita file. This plugin therefore disables map based page sequence generation. Like ditamaps, bookmaps are containers for structure and context metadata, and do not. The advent of the extensible markup language xml and rapid adoption of topicbased content standards like dita have forced us to separate content from format and end our addiction to desktop publishing. When working with large projects and multiple dita map files, you can easily find. The oasis dita technical committee and the oasis dita adoption technical committee 1. Dita maps have unique attributes that are designed to control the way that relationships are interpreted for different output purposes.
Dita uses hierarchy and specialization, the darwin part of dita, categorization of information information typing in a coherent structure. After a brief overview of the dita framework, course lectures and exercises focus on the key pieces of a dita publishing. Generating dita from word using the toolkit plugin. Tools publish book in responsive html5 from dita map. It is an open standard that is defined and maintained by the oasis dita technical committee the name derives from the following components. Watch video demonstrations to see how to implement some of the advanced features of dita discussed in this book. Dec 01, 2010 the dita specification provides specialized map types. The oasis dita technical committee and the oasis dita adoption technical committee. Setting up an ant script for running the wordtodita transform.
Dita has an imagemap element, which supports the basic functionality of the html clientside image map markup. A roadmap for writing, editing, and architecting in dita ibm press book online at best prices in india on. I am new to this forum and to dita, and i tried to use the element however when i did the validation, it told me that there is no declaration found for the element. Best practices for authors, a book for technical communicators working within the darwin information typing architecture the book. The ditaot pdf plugin generator is developed as a spare time project by jarno elovirta and is available for use free of charge. Dita is seeing increasing use outside of the original computer software and hardware sectors from which it was born. Oasis dita architectural specification commitee draft 01.
The build workbook from map command creates a framemaker book file that contains all of the files referenced in the current dita map and all submaps. These placeholders instructs the dita processing software to automatically. Dita maps specify hierarchy and the relationships among the topics. There are some automated ways of converting content, but if your source content isnt already in a dita friendly format, for example, if you have lots of topics that combine lists and concepts, or that have nested subsections thirdlevel headers, the conversion. The dita for publishers word to dita and dita to indesign tools. There are some automated ways of converting content, but if your source content isnt already in a dita friendly format, for example, if you have lots of topics that combine lists and concepts, or that have nested subsections thirdlevel headers, the. I want to create a template for a dita map which will also include a regular dita file and possible a nested map as well. Values specified on specific style mappings override the values on. Refer to this file by the following public identifier or an appropriate system identifier public oasisdtd dita bookmapen delivered as file bookmap. I tried to use the dita element and it said that no declaration found for element bookmap forum. Ditafmx is a plugin and set of structure applications that let you create and edit dita xml files in framemaker. The limited edition frame was originally part of an exclusive worldwide edition of 1,000 pieces. These are not necessarily examples of good topicbased authoring or proper use of dita we will leave that for others to decide.
A few years ago i was at the dita north america conference just when the idea of lightweight dita was being floated for the first time at a conference. Publish book in responsive html5 from dita map how to publish my book in responsive html5 from a dita map document with framemaker. Three or four days inperson, or, eight 2hour sessions online fee. Provide short descriptions for links to non dita content 105. Darwin information typing architecture dita resources. A dita map describes the relationships among a set of dita topics. Displaying topic titles in the dita map view ixiasoft. Dita for print second edition xml press ebook store. Dita has 125 books on goodreads, and is currently reading the book thief by markus zusak and a column of fire by ken follett. Maps consist of references to topics, maps, and other resources organized into hierarchies, groups, and tables. This workshop title is available both inperson and online. This book is truly helpful as well as definitely add to our information after reading it.
The author is tony self, a technical writer with 30 years. Dita writer blog, resource, interviews and news relating. This work book is not intended to be used for publishing, but facilitates the use of framemakers builtin book processing commands such as spell checking and searching at the book level. Doubleclicking a file reference that is listed in a dita map, opens that file in the editor. Dita darwin information typing architecture is an xmlbased, endtoend architecture for authoring, producing, and deli vering information often called content as discrete, typed topics. Sep 10, 2012 you can use dita maps to plan your project create a dita map before you begin writing to help plan the topics you need for your deliverable. You can use dita maps to plan your project create a dita map before you begin writing to help plan the topics you need for your deliverable. Dita celebrates 20 years as an industry vanguard with the release of its most innovative offering to date. The bookmap element is a map specialization used to describe the relationships among a set of dita topics intended to be configured as a. The problem is that the topic might use conkeyrefs so it cannot be published on its own, it somehow would need to be published by specifying also as a co.