This architecture consists of a set of design principles for creating informationtyped modules at a topic level and for using that content in delivery modes such as online help and product support portals on the web. Because of this, the topic files are not included in the sample. These items have passed the stage 1 hurdle, but either the proposal champion has not yet completed the stage 2 proposal template, or the tc has considered the stage 2 proposal and sent it back for revisions. Sta 3 refere the topic con information y to be read on figure 3. Depending on what you are looking for, these files are great for learning more about the practical aspects of using dita. Sep 11, 2008 2 yes the fm8 dita mapto book process is fairly restrictive in the allowable directory structure both for the source files and where you create the book. The examples illustrate a few of the ways that dita maps are used. Darwin information typing architecture or document information typing architecture dita is an xml data model for authoring and publishing.
A sample bookmap illustrates how different semantic elements are arranged to. The package also includes a stylesheet for merging all the documents referenced by a map into a single dita file. 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. Since framemaker 11 has been enhanced to support both dita 1. If you follow the one topic per xml file rule, a single topic map or depending on the complexity of the contents is all you need. 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 dita map is the whole book, and the topics or additional dita maps within it are like chapters, dividing the content into relevant sections. This morning i saw an interesting demo presentation by kristen eberlein for. Ibm information architecture workbench presentation day two of the content management strategies conference 2010 in santa clara. Darwin information typing architecture dita version 1.
Bookmaps are a specialisation of the base dita map information type. Generates graphviz graphs of the map structure and backofthe book index graphs xslt apache2. Dita can be really helpful in technical writing for many reasons, for example, dita makes your content readable and concise. This section contains information about the dita sample source files that come with dita open toolkit. The containing element for a bookmap is the element, which can take title, id, conref, and anchorref attributes. You dont need to create a for the screen media and a for the print media. Ibm information architecture workbench presentation. Xmlmind dita converter, an alternative to using the dita open toolkit. Most dita editors have autocomplete or other similar features to guide you through the process of adding elements for example, if you type the opening tag of an element, most dita editors will automatically add the closing tag for you. A current limitation is that the attribute names cannot be. 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.
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 toolkit supports all versions of the oasis dita specification, including 1. A sample bookmap illustrates how different semantic elements are arranged to form. This section of the specification contains simple examples of dita maps. Xml input and lightweight markup formats can be combined in a single map file and converted to a variety of. This fourlesson course introduces you to dita maps and bookmaps. If you follow the one topic per xml file rule, a single topic map or. We encourage you to complete the other classes before taking this class. A sample bookmap illustrates how different semantic elements are arranged to form the structure of a conventional, printed book. 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. The oasis dita technical committee and the oasis dita adoption technical committee. Note that any dita map specialisation should be handled in a. A sample bookmap illustrates how different semantic elements are arranged to form the structure of a conventional.
Maps consist of references to topics, maps, and other resources organized into hierarchies, groups, and tables. What i learned from the dita listening sessions part 2 five highlights from dita tcworld 2016. Sta folder following are there is a all dita m there is a. These placeholders instructs the dita processing software to automatically.
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 online version of the dita style guide will have links to the dita language reference. Need the ability to filter within a branch of content, in addition to the existing ability to filter an entire set of content based on a single set of conditions. Then, he explores the dita architecture, explaining maps and topics, structural patterns, metadat. Dita maps specify hierarchy and the relationships among the topics. The following sample files garage and grocery shopping are included in their dita source form for your reference.
The screen capture above shows framemaker 11 with the dita map and dita file contents that comprise. Download the pdf k there are numerous alternatives for producing pdf output from dita content. Navigate to the folder structure of the data sheet for which you want to create a dita topic map. Displaying topic titles in the dita map view ixiasoft.
This is the book to read when your organization is getting ready to deploy dita, or when you are getting ready to learn how to author in the dita environment. A formally defined book means one with covers, formal notices, front matter notices. In general for both the fmbased processes as well as any ot processing, you should keep the map file above or at the same level as any referenced files this includes graphics. The the dita2indesign project materials include a number of books from project gutenberg that have been converted to dita format.
This example illustrates how one map can reference a subordinate map using either or the basic element. Darwin information typing architecture dita is the best way to be smart about writing and publishing your business content. Note that any dita map specialisation should be handled in a similar manner to the book map specialisation, as the implementation works off the class attributes of the elements to determine whether a topic reference has been found. Books on learning dita technical writing is easy medium. The topic references therefore are labeled according to the book components they point to, such as booktitle, frontmatter, chapter, and appendix. 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. 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. Introduction to dita, the dita concept topic type, the dita task topic type, and the dita reference and glossary topic types. Aug 14, 2016 framemaker 11 publishes sample files from dita open toolkit outofthebox. What i learned from the dita listening sessions part 1 current worldwide distribution of dita users.
For example, consider the following chapter in a map. Bookmaps consist of references to topics organized as book content. This section contains nonnormative information, including topics about new features in dita 1. For example, you might have one map specifically for nonprint outputs online. Using other dita editors, it can required a lot of work to design style sheets that will publish otk to rich pdf. If you like to read a book on the way to work, here is a list of some. 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 document was last revised or approved by the oasis darwin information typing. My thanks to bill blackmon for providing these links and pointers. Bill is on the staff of the adl, and was one of the leads at the ims responsible for developing these best practices templates. Please read the content of the dita markup result results dita markup. Introduction to the darwin information typing architecture. It is an open standard that is defined and maintained by the oasis dita technical committee.
The darwin information typing architecture dit a is an architecture for topicbased, structured xml authoring. In fact, framemaker 11 is so dita compliant that you can open the complete sample that is provided with the dita open toolkit. This course builds on what you learned in the four preceding classes. In the instructions and examples, we show you the dita code for the sample files. Rightclick the toplevel folder, and from the menu that displays, click new new dita map.
253 224 232 745 390 1031 547 766 431 231 382 1039 512 956 630 892 220 79 871 393 1115 15 895 183 304 324 162 1067 1502 1207 928 1261 1439 412 743 1286 1552 754 310 631 313 837 72 167 290 700