World Library  
Flag as Inappropriate
Email this Article

Darwin Information Typing Architecture

Article Id: WHEBN0001223187
Reproduction Date:

Title: Darwin Information Typing Architecture  
Author: World Heritage Encyclopedia
Language: English
Subject: Adobe FrameMaker, DocBook, Component content management system, Ann Rockley, OASIS (organization)
Collection: Document-Centric Xml-Based Standards, Markup Languages, Technical Communication, Xml, Xml-Based Standards
Publisher: World Heritage Encyclopedia
Publication
Date:
 

Darwin Information Typing Architecture

The Darwin Information Typing Architecture (DITA) is an OASIS DITA Technical Committee.[2]

The name derives from the following components:

  • Darwin: it uses the principles of specialization and inheritance, which is in some ways analogous to the naturalist Charles Darwin's concept of evolutionary adaptation,
  • Information,
  • Typing,
  • Architecture: DITA is an extensible set of structures.[3]

Contents

  • Features and limitations 1
    • Content reuse 1.1
    • Information typing 1.2
    • Maps 1.3
    • Metadata 1.4
    • Specialization 1.5
    • Topic orientation 1.6
  • Creating content in DITA 2
  • Publishing content written in DITA 3
    • Localization 3.1
  • History 4
  • Code samples 5
    • Ditamap file (table of contents) sample 5.1
    • Hello World (topic DTD) 5.2
    • .ditaval file sample (for conditionalizing text) 5.3
  • See also 6
  • References 7
  • External links 8

Features and limitations

Content reuse

Topics can be reused across multiple publications. Fragments of content within topics can be reused through the use of content references (conref), a transclusion mechanism.[4]

Information typing

DITA includes three specialized topic types: Task, Concept, and Reference. Each of these three topic types is a specialization of a generic Topic type, which contains a title element, a prolog element for metadata, and a body element. The body element contains paragraph, table, and list elements, similar to HTML.

  • A (General) Task topic is intended for a procedure that describes how to accomplish a task. A Task topic lists a series of steps that users follow to produce an intended outcome. The steps are contained in a taskbody element, which is a specialization of the generic body element. The steps element is a specialization of an ordered list element.
  • Concept information is more objective, containing definitions, rules, and guidelines.
  • A Reference topic is for topics that describe command syntax, programming instructions, and other reference material, and usually contains detailed, factual material.

Maps

A DITA map is a container for topics used to transform a collection of content into a publication. It gives the topics' sequence and structure. A map can include relationship tables (reltables) that define hyperlinks between topics.[5] Maps can be nested. Maps can reference topics or other maps, and can contain a variety of content types and metadata.

Metadata

DITA includes extensive metadata elements and attributes, both at topic level and within elements.[6] Conditional text allows filtering or styling content based on attributes for audience, platform, product, and other properties. The conditional processing profile (.ditaval file) is used to identify which values are to be used for conditional processing.[7]

Specialization

DITA allows adding new elements and attributes through specialization of base DITA elements and attributes. Through specialization, DITA can accommodate new topic types, element types, and attributes as needed for specific industries or companies. Specializations of DITA for specific industries, such as the OASIS technical committees or subcommittees. Many organizations using DITA also develop their own specializations.

The extensibility of DITA permits organizations to specialize DITA by defining specific information structures and still use standard tools to work with them. The ability to define company-specific information architectures enables companies to use DITA to enrich content with metadata that is meaningful to them, and to enforce company-specific rules on document structure.[4]

Topic orientation

DITA content is created as topics, each an individual XML file. Typically, each topic covers a specific subject with a singular intent, for example, a conceptual topic that provides an overview, or a procedural topic that explains how to accomplish a task.[8] Content should be structured to resemble the file structure in which it is contained.[9][10][11]

Creating content in DITA

DITA map and topic documents are XML files. As with HTML, any images, video files, or other files that must appear in the output are inserted via reference. Any XML editor or even text editor can be used to write DITA content, depending on the level of support required while authoring. Aids to authoring featured in specialized editors includes WYSIWYG preview rendering, validation, and integration with the DITA-OT. Third-party editors that support authoring DITA include Arbortext, FontoXML, FrameMaker, Oxygen XML Editor, PublishOne, Quark XML Author, SDL Xopus, and XMetaL, which are supported by several content management systems. DITA is natively supported by a number of CCMSs like Componize, DITAworks,[12] easyDITA,[13] IXIASOFT,[14] and Syntext Serna.[15]

Publishing content written in DITA

DITA is designed as an end-to-end architecture. In addition to indicating what elements, attributes, and rules are part of the DITA language, the DITA specification includes rules for publishing DITA content in HTML, online Help, print, and other formats.

For example, the DITA specification indicates that if the conref attribute of element A contains a path to element B, the contents of element B will display in the location of element A. DITA-compliant publishing solutions, known as DITA processors, must handle the conref attribute according to the specified behaviour. Rules also exist for processing other rich features such as conditional text, index markers, and topic-to-topic links. Applications that transform DITA content into other formats, and meet the DITA specification's requirements for interpreting DITA markup, are known as DITA processors.

Localization

DITA provides support for translation via the localization-atts attribute group. Element attributes can be set to indicate whether the content of the element should be translated. The language of the element content can be specified, as can the writing direction.[16] A DITA project can be converted to an XLIFF file and back into its original maps and topics, using the DITA-XLIFF Roundtrip Tool for DITA-OT[17][18] and computer-assisted translation (CAT) tools, like Swordfish Translation Editor or Fluenta DITA Translation Manager, a tool designed to implement the translation workflow suggested by the article Using XLIFF to Translate DITA Projectspublished by the DITA Adoption TC at OASIS.

History

  • March 2001 Introduction by IBM of the core DTD and XML Schema
  • May 2002 Domain specialization added to topic specialization
  • April 2004 OASIS Technical Committee for DITA formed
  • February 2005 SourceForge begins DITA Open Toolkit support
  • June 2005 DITA v1.0 approved as an OASIS standard
  • August 2005 DITA Open Toolkit v1.1 is released
  • March 2006 OASIS launches DITA.XML.org
  • August 2007 DITA V1.1 is approved by OASIS, including Bookmap specialization
  • December 2010 DITA V1.2 is approved by OASIS, includes:
    • Indirect linking with keys
    • New content reuse features
    • Enhanced glossary support, including acronyms
    • New industry specializations (Training, Machinery)
    • New support for controlled values / taxonomies (Subject Scheme specialization)

Code samples

Ditamap file (table of contents) sample




  

Hello World (topic DTD)




  Sample
  
  

Hello World!

.ditaval file sample (for conditionalizing text)



  
  

See also

References

  1. ^ "Darwin Information Typing Architecture (DITA) Version 1.2". Retrieved 10 October 2012. 
  2. ^ "OASIS Darwin Information Typing Architecture (DITA) TC". OASIS. Retrieved 5 October 2012. 
  3. ^ "Frequently Asked Questions about the Darwin Information Typing Architecture". IBM Corporation. Retrieved 10 October 2012. 
  4. ^ a b "Introduction to the Darwin Information Typing Architecture". IBM Corporation. Retrieved 10 October 2012. 
  5. ^ "reltable". OASIS. Retrieved 22 October 2012. 
  6. ^ "Metadata elements". OASIS. Retrieved 22 October 2012. 
  7. ^ "ditaval". OASIS. Retrieved 22 October 2012. 
  8. ^ Priestly, Michael and Swope, Amber. "The DITA Maturity Model Whitepaper" (PDF). IBM Corp and JustSystems. Retrieved 22 October 2012. 
  9. ^ "Implementing DITA versus implementing custom XML architecture". Scriptorium Publishing Services, Inc. 2008. Retrieved 2009-07-29. 
  10. ^ "Structure, DITA, and content other than technical documentation …". The Rockley Group. October 16, 2007. Retrieved 2009-07-29. 
  11. ^ "Survey on DITA Challenges". WritePoint Ltd. January 18, 2010. Retrieved 2010-01-21. 
  12. ^ DITAworks
  13. ^ easyDITA
  14. ^ IXIASOFT
  15. ^ Doyle, Bob (April 2008). "DITA Tools from A to Z". intercom: 7–13. 
  16. ^ "localization-atts attribute group". OASIS. Retrieved 15 October 2012. 
  17. ^ Schnabel, Bryan. "DITA-XLIFF Roundtrip for OT". Retrieved 15 October 2012. 
  18. ^ DITA 1.2 Feature Article: Using XLIFF to Translate DITA Projects

External links

  • DITA specification
  • OASIS
  • SourceForge
  • DITA.XML.org
This article was sourced from Creative Commons Attribution-ShareAlike License; additional terms may apply. World Heritage Encyclopedia content is assembled from numerous content providers, Open Access Publishing, and in compliance with The Fair Access to Science and Technology Research Act (FASTR), Wikimedia Foundation, Inc., Public Library of Science, The Encyclopedia of Life, Open Book Publishers (OBP), PubMed, U.S. National Library of Medicine, National Center for Biotechnology Information, U.S. National Library of Medicine, National Institutes of Health (NIH), U.S. Department of Health & Human Services, and USA.gov, which sources content from all federal, state, local, tribal, and territorial government publication portals (.gov, .mil, .edu). Funding for USA.gov and content contributors is made possible from the U.S. Congress, E-Government Act of 2002.
 
Crowd sourced content that is contributed to World Heritage Encyclopedia is peer reviewed and edited by our editorial staff to ensure quality scholarly research articles.
 
By using this site, you agree to the Terms of Use and Privacy Policy. World Heritage Encyclopedia™ is a registered trademark of the World Public Library Association, a non-profit organization.
 


Copyright © World Library Foundation. All rights reserved. eBooks from Project Gutenberg are sponsored by the World Library Foundation,
a 501c(4) Member's Support Non-Profit Organization, and is NOT affiliated with any governmental agency or department.