Dita consists of a document type definition dtd, which specifies how the elements and that make up a dita document can be defined. The content from all the referenced topics maps is collated to create a single framemaker document for output. 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. Adobe techcomm blog adobe dita world 2017 day 3 summary. Acquire handson experience with document publishing including the use of topics, concepts, tasks, and references, and the creation and management of map and bookmap documents. The wordto dita transformation framework provides a general facility for converting styled microsoft word documents into dita maps and topics. These tutorials are excerpted from the upcoming book dita for practitioners, to be published by xml press in 2011.
A perfect collectible book for fans of dita, classic burlesque devotees, or for anyone who loves a playful and beautifully packaged book, dita. Select from framemaker book select this if you want to select fm files that belong to a particular book. It also includes highlevel information about dita map elements, attributes, and metadata. It is intended neither as an endorsement of any technol. This language reference describes the elements that comprise the topic dtd and its initial, infotyped descendents. 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. It is an open standard that is defined and maintained by the oasis dita technical committee the name derives from the following components. 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. It allows me to create a framemaker book from a dita map or bookmap and then do whatever i can do with any framemaker book, including create a pdf.
Similarly, the structure of a book is the hierarchy of chapters that make that make that book. Publish your structured documents in a professional format. Apr 24, 2014 however, you might want to check out ditafmx, in which the aggregation process is controlled by xslt that you are free to modify. Each dita map can work with any supported output format, so if you want to publish a training manual in both pdf and html, you can use one dita map and two output formats. You distilled the essence from an informationpacked conference. Theres also set of xslt stylesheets that control the look and feel of the documents that are output. The generated book contains these xml documents in the same hierarchical structure as the dita map.
Depending on what you are looking for, these files are great for learning more about the practical aspects of using dita. The package also includes a stylesheet for merging all the documents referenced by a map. It provides architectural features for content modularity, content reuse, and controlled extension of document vocabularies in a way that ensures interoperability of dita. Each topic map in the dita map, gets added to the framemaker book in the xml format itself. Sep 28, 2005 frequently asked questions about the darwin information typing architecture. The default book build process in ditafmx also ignores these map elements, and assumes that all content is defined in topics, but you could tweak the xslt to include topicheads as topic headings in the generated book. 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, product testing, and. Formatting is determined according to which structured application you have selected for books in the dita options.
Liz fraley, singlesourcing solutions, is a serial entrepreneur. Formal definition of ditaval syntax for content filtering. The ditaexchange connector, supports two custom document libraries. The document class is extended to include subclasses that represent topics ditabase, maps ditamap, and processing profiles ditaval. In a bookmap, highestlevel topicref elements in your dita map become chapters in the framemaker book, containing any nested topicref elements. All about output from dita maps with framemaker adobe blogs. To create a specific deliverable for a specific product, audience, and purpose, you use a dita map.
Dita maps specify hierarchy and the relationships among the topics. A framemaker book is created based on the dita map. See appendix for information about this element in oasis document type shells. Working with master documents what is a master document. A roadmap for writing, editing, and architecting in dita ibm press bellamy, laura, carey, michelle, schlotfeldt, jenifer on. The oasis open darwin information typing architecture dita is a standard xmlbased architecture for representing documents intended primarily for consumption by humans. The darwin information typing architecture or document information typing architecture dita is an. The wordtodita transformation framework provides a general facility for converting styled microsoft word documents into dita maps and topics. Darwin information typing architecture dita specification defines both a a set of document types for authoring and. The topic references therefore are labeled according to the book components they point to, such as book title, front matter, chapter, and appendix.
It indicates to the processing software that the author wants an abbreviation list generated at the particular location. The xml addon also allows you to publish framemaker documents directly from aem. The bookmap specialization of ditamap supports standard book production for collections of dita topics. Using xml documentation addon for adobe experience. Topichead does not convert properly when ditamap s. Darwin information typing architecture dita is the best way to be smart about writing and publishing your business content. Definition of dita maps dita maps are documents that organize topics and other resources into structured collections of information. Dita concepts topics, maps, specialization, etc have an immediate appeal to the technical writer, making this document type more attractive than docbook. The docx2dita transform is driven by a configuration file, the styletotag map. Learn about its wysiwyg authoring in a dita environment optimized for editing and production. Dita map document type framework oxygen xml editor. In the context of a book, each chapter could have its own dita map, listing the topics. The styletotag map enables an entirely or almostentirely configurationdriven transformation of styled word documents into ditabased xml, specialized or not.
This second edition covers open toolkit, version 2, including customizing the dita 1. 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. Darwin information typing architecture dita version 1. All fm files in the book are selected automatically. Frequently asked questions about the darwin information typing architecture. Dita approaches documents from the other direction. Select from dita map select this to select all documents referenced by a dita map. Design, but its still useful for a lot of applications, especially traditional technical documents. The interactive tutorials guide even the most novice user through the steps required to learn how to create content including tasks, concepts, references and even maps. Dec 01, 2010 dita maps are documents that organize topics and other resources into structured collections of information. The containing element for a bookmap is the element, which can. About dita darwin information typing architecture dita darwin information typing architecture is an xmlbased, endtoend architecture for authoring, producing, and deli vering information often called content as discrete, typed topics. Dita elements, the dtds are normative if there is ever any discrepancy. Information typing, which means each topic has a defined.
As opposed to standards that support long, book oriented writing, dita is optimized for creating content in small, discrete units called topics that you then can organize in different ways to product output deliverables. The the dita2indesign project materials include a number of books from project gutenberg that have been converted to dita format. The default value will increase with each release of dita. These processes are described in more detail in the documents.
These models represent only the default document types distributed by oasis. We teach you how you can easily and quickly make a pdf that also displays a professional lookandfeel. Lets have a look at the various ways to create composite dita documents in framemaker, and their respective shortcomings. The ditabase and ditamap classes have a rich set of metadata that maps to key dita elements and attributes to provide a powerful query capability. However, you might want to check out ditafmx, in which the aggregation process is controlled by xslt that you are free to modify. It is an open standard that is defined and maintained by the oasis dita technical committee.
Jan 09, 2018 a bookmap is a specialization of a dita map. Jan 19, 2017 it provides architectural features for content modularity, content reuse, and controlled extension of document vocabularies in a way that ensures interoperability of dita documents. Dita was developed at ibm in 19992000 to replace the companys bulky and complicated ibmdoc format. This book fills the gap between the dita language reference and the author. Mar 17, 2015 the same map can be used to create web sites, pdfs, word documents, and more. A dita open toolkit workbook, second edition white, leigh w on. A dita bookmap is a specialized type of map, intended for creating output that is. The generated book contains these converted framemaker documents in the same hierarchical structure as the dita map. The bookmap map type is part of the standard dita vocabulary. Dita configuration and specialization tutorials this information set provides a set of tutorials on dita 1. Sep 27, 2010 each time you want to generate a deliverable, you use a dita publishing engine to process that deliverables dita map with an output format. Then, he explores the dita architecture, explaining maps and topics, structural patterns, metadat. The overall dita document contains this sequence of topics. If you want to create a traditional book in dita, you can use a bookmap to organize your topics into a book.
The package also includes a stylesheet for merging all the documents referenced by a map into a single dita file. In a bookmap, highestlevel topicref elements in your dita map become chapters in the. Dita language reference overview the design of the darwin information typing architecture dita is based on deriving multiple information types, or infotypes, from a common, generic topic. Working with dita maps in arbortext singlesourcing.
The following documents may be used as master documents. The document class is extended to represent dita topics, maps, and processing profiles ditaval files. Hi all, in the ditafmx plugin developed by leximation, theres a feature called generate book from map. Dita itself is designed to be presentation neutral, and deliverables can be rendered with completely different styles, and share all or only some of the topics. 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. The overall contents of a dita document are specified using a topic map also simply called a map. Ibm filenet p8 dita publishing provides a ditabased information development solution that is built upon the following ibm filenet p8 functionality documents subclassing and custom properties. These books serve primarily as realistic test documents used to exercise the dita toindesign process, but they also serve more generally as nontrivial, interesting, unencumbered sample dita documents that can be used for demonstration, product testing, and. Xmlmind dita converter, an alternative to using the dita open toolkit. 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. Tools create book as dita bookmap document faq fyicenter. For an author, just knowing the syntactical elements of a language is not enough to write effectively and well. The same map can be used to create web sites, pdfs, word documents, and more. 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.
It is aimed at people who are already working with dita. The bookmap element is a map file used to organize dita content into a traditional book format. A handson guide to creating dita compliant documents. Dita is an oasis open standard first published in 2005 and last updated in 2015 with the publication of version 1. As with other document content, dita files are stored in ibm filenet p8 as document objects. Dita implements the first option with the ditabase document type, and the second option with the map and bookmap document types socalled dita maps.
Bookmaps consist of references to topics organized as book content. By the end, youll be a pro at working with dita maps in arbortext. This innovative book provides a combination of technical information related to using xmetal author to build ditacompliant content with detailed, stepbystep tutorials. A roadmap for writing, editing, and architecting in dita ibm press. So, now you know that maps are just a collection of references to other xml files.
A dita bookmap document is used as a container of multiple dita topic docuements to for book with a more complex structure with chapter elements. Open the book from the dita map document, ditamapexample. The darwin information typing architecture dit a is an architecture for topicbased, structured xml authoring. More formally, dita is an open standard that describes the architecture for creating and managing information that separates the content from the formatting, allows for a more streamlined content creation process, and. Structured authoring enforces structure to the authoring of documents. Just one small clarification regarding my talk there would actually be other ways to generate pages with markup from dita, but we have made it very easy and smooth in aem by building on the welldesigned customization points available in the xml documentation addon.
The publishing ditasourced content pdf training course is intended for people who wish to publish ditasourced content to pdf via framemaker, using the ditafmx plugin. Through careful design of word templates it is possible to quickly configure the transformation to produce good xml documents. A dita map is essentially a list of pointers to a set of specific topics, specifying what topics to include in the deliverable. In addition, dita maps share many metadata and linking. The containing element for a bookmap is the element. 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. The topic headings are determined by how it is nested on the dita map. Framemaker a standard documentation tool and other xmlbased solutions such as docbook use the traditional, fairly rigid book chaptersection metaphorthe book is a container that contains chapters, which in turn contains individual sections describing an idea or a task.
Topic module the representation within a schema technology for. Villegas, resident blogger at adobe dita world 2017 sums up the presentations of day 3 of the conference. The autofm script instructs framemaker to use the ditafmx map to book process to create a book and chapter files from the dita map. Dita expert eliot kimber takes you inside the dita xml standard, explaining the architecture and technology that make dita unique. The public id of the document is oasisdtd dita map or oasisdtd dita bookmap. More formally, dita is an open standard that describes the architecture for creating and managing information that separates the content from the formatting, allows for a more streamlined content creation process, and opens up the possibilities of introducing simpler. Frequently asked questions about the darwin information. Unfortunately, framemaker 10 supports only the first option fully. This is all there is to the functional aspect of dita. Leigh whites book, dita for print, has become the goto reference for building a print customization plugin for the dita open toolkit.
1403 210 617 18 724 388 706 1216 93 286 663 470 10 1242 1042 1370 1119 1287 16 1284 149 885 264 362 1358 1313 1026 293 348 819 929 563 884