Most xml editing platforms today can be enhanced to give the user a supercharged. After a brief overview of the dita framework, course lectures and exercises focus on the key pieces of a dita publishing. Three or four days inperson, or, eight 2 hour sessions online fee. It added structured learning, creation of learning objects with dita, which will be compatible with elearning standards such as scorm. Deb bissantz and jacquie samuels dita adoption technical committee. This article is published under the creative commons attributionshare alike license. Dec 07, 2011 framemaker 10 is an easy to use tool for creating and publishing xml content including dita 1. To compare the features provided by ditafmx with those provided by various versions of framemaker, see framemaker dita feature comparison. Dita expert eliot kimber takes you inside the dita xml standard, explaining the architecture and technology that make dita unique. Ditarelated classes and properties are added to the content engine when you install the dita publishing extensions addon. Describes the dita map and topic authoring commands as well as the enhanced dita publishing features. In addition to flexibility with output, dita also gave us the ability to break up the book into lots of. But vazquez concentrates on software documentation and includes information about dita 1.
How to create publications using dita maps easydita. This course enables you to see the final results of what you have learned in the preceding courses. Introduction to dita, the dita concept topic type, the dita task topic type, the dita reference and glossary topic types, using dita maps and bookmaps, introduction to reuse in dita, and. Books on learning dita technical writing is easy medium.
Dita darwin information typing architecture archives. Prototype project should not be the first book you want to convert. Topicbased writing for technical communication and the web, by mark baker october 20 links. Fm look into using the remove all overrides command to clean up files. The dita rendition engine uses the dita open toolkit to transform dita content topics and maps into pdf. Conveniently, we already have infrastructure for publishing dita content to pdf, epub, and kindle although we have made a lot of changes over the last few months. Also allows publishing a single branch of content multiple times with distinct filter profiles. Volume 1 of his twovolume exploration of dita starts with a handson explanation of endtoend dita processing that will get you up and running fast. Refer to this file by the following public identifier or an appropriate system identifier public oasisdtd dita bookmapen delivered as file bookmap. The topic references therefore are labeled according to the book components they point to, such as booktitle, frontmatter, chapter, and appendix. The books does provides a comprehensive highlevel overview of the technical aspects of dita tags, topic types, dita maps.
Jan 19, 2017 requirement 2, reuse, is satisfied by three dita features. Xmlmind dita converter, an alternative to using the dita open toolkit. Then, he explores the dita architecture, explaining maps and topics, structural patterns, metadata, linking and addressing, keys and key references, relationship tables, conditional processing. Setting up an ant script for running the wordto dita transform. The toolkit supports all versions of the oasis dita specification, including 1. Nested topics not getting topicref tunnel parameter 3. In the first part of the book you can find some guided exercise is referenced at oxygen xml editor chapter 6 and 7 explain the topic type and dita map the book. Dita best practices is a very pragmatic book, which gets you up and running with dita very quickly. For each element in the allinclusive edition, this section presents the content model and a list of parent elements that can contain that element.
Generating epubs and kindle books from dita content. Define and develop any dita specializations with publishing expert, develop constraints that meet the dita model. The dita for publishers word to dita and dita to indesign tools. Very few dita howto books exist and the ones that do pale in comparison to this one. Ditafmx generates pdfready framemaker book and files from a dita map plugin for framemaker providing enhanced dita authoring and publishing features supports framemaker versions 7. It is intended neither as an endorsement of any technol. This does not refer to the epub and kindle electronic versions of the book, but to the future webbased version of the book to be made available in two years time, when the whole book will become open source. The topic references therefore are labeled according to the book components they point to, such as book title, front matter, chapter, and appendix. Provides generalpurpose dita map, topic, and domain specializations for the publishing industry, as well as supporting processors e.
A specialised ditamap, called bookmap, is now part of the base dita specification. Then i can use these familiar names as the link references in my dita documentation. Same topic used in two publications pub 1 map pub 2 map topic c topic a. Introduction to dita, the dita concept topic type, the dita task topic type, and the dita reference and glossary topic types. It is an open standard 1 that is defined and maintained by the oasis dita technical committee. A dita map is a container for topics used to transform a collection of content into a publication.
Dec 01, 2010 the darwin information typing architecture dita 1. Dita implementation darwin information typing architecture. The autofm script instructs framemaker to use the ditafmx mapto book process to create a book and chapter files from the dita map. We pay cash for books, textbooks, cds, lps, videos and dvds daily. Dita reuse challenges and responses moving from books to. Half price books has new and used books, textbooks, music, movies and more both online and in stores. This section contains nonnormative information, including topics about new features in dita 1. A formally defined book means one with covers, formal notices, front matter notices. Bookmaps are a specialisation of the base dita map information type. Conditional publishing based on the use of a val file is. The online version of the dita style guide will have links to the dita language reference. The publication map map type integrates the publication map and publication metadata domains into a map document type. It serves both as a general publication map type and as an example of how to integrate and configure the publication map and publication metadata domains.
Part 1 explains various notions of topics that make up the information content of a dita conforming document. Audience conditional processing attribute used for conditional publishing audience dita 1. Generates graphviz graphs of the map structure and backofthe book index graphs xslt apache 2. Prioritization conditional processing attribute for conditional publishing. It did help that i struggled through dita best practices and dita style guide before reading this book. It should be short enough to address a single subject or answer a single question but long enough to make sense on its own and be authored as a selfcontained unit.
Title dita open toolkit user guide fourth edition, december 17, 2007. Ibm filenet p8 dita publishing supports the dita language specification v1. Nonetheless, the two books together provide a good foundation for then more easily learning how dita will be used in your organization. Audience conditional processing attribute used for conditional publishing. Oct 27, 2014 download dita for publishers for free. Adobe framemaker 2017 release easily author and publish multilingual technical content across mobile, web, desktop, and print. It will be included in all of the core content maps distributed by oasis map, base map, book map, classification map. It is an open standard that is defined and maintained by the oasis dita. The dita bookmap specialization represents the key markup requirements for managing dita content through bookoriented publication. The darwin information typing architecture or document information typing architecture dita is an xml data model for authoring and publishing. Before the session is finished, they will use their new template to publish dita xml content to word and pdf from dita 1. 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.
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. Using xml documentation addon for adobe experience. We encourage you to complete the other classes before taking this class. It is an open standard that is defined and maintained by the oasis dita technical committee the name derives from the following components. Theres no two ways around itmost people are being really dumb with their content and unfortunately, they dont even realize it. In addition to flexibility with output, dita also gave us the ability to break up the book into lots of small files and then to work on those files simultaneously. The learning subcommittee may decide whether to include it in learningmap or learningbookmap. A publisher may use a number like this one to identify a book for tracking purposes. A root map defines the context for key reference resolution, and that context must be shared by all references. Framemaker is an easy but powerful tool for creating and. Dita open toolkit is a vendorindependent, opensource implementation of the dita standard, released under the apache license, version 2. Dita fmx generates pdfready framemaker book and files from a dita map plugin for framemaker providing enhanced dita authoring and publishing features supports framemaker versions 7. Both dita and docbook are both mature, feature rich, document types, so which one to choose.
Map to book output can be generated at any location in the file system. Content models for each element in the allinclusive edition, this section presents the content model and a list of parent elements that can contain that element. The bookmap specialization of ditamap supports standard book production for collections of dita topics. A element where you can specify the author of the document, the date of publication, etc. Using dita maps and bookmaps learning dita free dita. Location in another map where the current map is anchored. A map structure application is provided that allows for creation and editing of both dita 1. Each attendee will be provided with a usb memory stick from which they will install a 30day trial version of dita inprint. Dita fmx is a plugin and set of structure applications that let you create and edit dita xml files in framemaker. Creates fm book and components from dita map save to pdf from fm book. This document was last revised or approved by the oasis darwin information typing. A user guide to the darwin information typing architecture including dita 1. Expandable dita map topics for quick viewing of content.
Licensing edition, release, and usage of this document and related materials is regulated by a common public license. Part 2 looks at the architectural extras like linking between documents or metadata. Originally designed for technical publications, dita is being used for a variety of document types including marketing materials, policies and procedures, customer communications, and many others. The autofm script instructs framemaker to use the dita fmx map to book process to create a book and chapter files from the dita map. Generating dita from word using the toolkit plugin. If i ever change the drupal node, changing it in the keyref map will update every instance throughout the documentation.
This new 2011 edition of the bestselling introduction to dita includes dita 1. When saved to disk, the resulting dita map file is completely ditacompliant, although within the framemaker authoring environment some additional elements are added to provide a more efficient authoring experience. Darwin information typing architecture dita is an international xml standard for writing and delivering information. Im a novice with dita, this is the first book about dita that i bought in the book is referenced about oxygen xml editor. Ditafmx is a plugin and set of structure applications that let you create and edit dita xml files in framemaker. The element is a map specialization used to describe the relationships among a set of dita topics intended to be configured as a traditional book. Demo of adobe framemaker, justsystems xmetal, and oxygen xml with dita maps. A new glossary entry element provides a flexible semantic structure to store terminology information, and the new indirect linking functionality allows terms occurring in the content to be linked through a key reference or transcluded using a new abbreviatedform element. Darwin information typing architecture dita version 1. This ant script can be modified to suit your needs and can be used by other tools and publishing workflows as an integration option for publishing to pdf from dita through framemaker.
The map and topics model, which separates the concern of publication structures maps from the concern of content topics. This course builds on what you learned in the four preceding classes. Bookmaps consist of references to topics organized as book content. Then, he explores the dita architecture, explaining maps and topics, structural patterns, metadat.
The author of practical dita does exactly what a technical writer should do speaks clearly and concisely and on the level of the audience. If your technical communications group is considering a move to dita and you, or your team, dont know what dita is and what it means to move to a dita authoring model, this book is a great place to start. Dita maps specify hierarchy and the relationships among the topics. Ibm filenet dita publishing supports the dita language specification v1. They contain information structures that are specific to linear publications. One of the major advantages of using a structured standard like dita. This fourlesson course describes how to use the dita open toolkit to generate output from your dita sources. 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. This article is published under the creative commons attributionshare alike opens in new window license. While the dita standard is owned and developed by oasis, the dita open toolkit project is governed separately. This fourlesson course introduces you to dita maps and bookmaps.
233 154 719 1426 703 425 1412 1454 665 892 1171 690 1504 811 790 217 716 795 1224 127 1010 153 401 1065 1426 361 278 1187 86 1438 1272 1180 1466 327 1431 150 11 70 1316 500 786 61