{"id":786,"date":"2025-04-17T15:57:24","date_gmt":"2025-04-17T12:57:24","guid":{"rendered":"https:\/\/www.index.fi\/?page_id=786"},"modified":"2026-06-25T21:37:18","modified_gmt":"2026-06-25T18:37:18","slug":"dita","status":"publish","type":"page","link":"https:\/\/www.index.fi\/en\/tietopankki\/dita\/","title":{"rendered":"Darwin Information Typing Architecture (DITA)"},"content":{"rendered":"<div class=\"fusion-fullwidth fullwidth-box fusion-builder-row-1 fusion-flex-container nonhundred-percent-fullwidth non-hundred-percent-height-scrolling no-bottom-margin\" style=\"--awb-border-radius-top-left:0px;--awb-border-radius-top-right:0px;--awb-border-radius-bottom-right:0px;--awb-border-radius-bottom-left:0px;--awb-padding-top-medium:80px;--awb-padding-bottom-medium:80px;--awb-margin-bottom-medium:80px;--awb-margin-bottom-small:60px;--awb-background-color:var(--awb-custom_color_2);--awb-flex-wrap:wrap;\" ><div class=\"fusion-builder-row fusion-row fusion-flex-align-items-stretch fusion-flex-content-wrap\" style=\"max-width:calc( 1200px + 30px );margin-left: calc(-30px \/ 2 );margin-right: calc(-30px \/ 2 );\"><div class=\"fusion-layout-column fusion_builder_column fusion-builder-column-0 fusion_builder_column_1_1 1_1 fusion-flex-column\" style=\"--awb-padding-top:90px;--awb-padding-right:40px;--awb-padding-left:40px;--awb-bg-color:var(--awb-custom_color_2);--awb-bg-color-hover:var(--awb-custom_color_2);--awb-bg-size:cover;--awb-width-large:100%;--awb-margin-top-large:0px;--awb-spacing-right-large:10px;--awb-margin-bottom-large:0px;--awb-spacing-left-large:15px;--awb-width-medium:33.333333333333%;--awb-spacing-right-medium:10px;--awb-spacing-left-medium:15px;--awb-width-small:100%;--awb-spacing-right-small:15px;--awb-margin-bottom-small:30px;--awb-spacing-left-small:15px;\"><div class=\"fusion-column-wrapper fusion-column-has-shadow fusion-flex-justify-content-flex-start fusion-content-layout-column\"><i class=\"fb-icon-element-1 fb-icon-element fontawesome-icon classic-thumbs-up-regular circle-no\" style=\"--awb-iconcolor:var(--awb-color4);--awb-iconcolor-hover:var(--awb-color4);--awb-font-size:72px;--awb-align-self:center;--awb-margin-top:0px;--awb-margin-right:0px;--awb-margin-bottom:30px;--awb-margin-left:0px;\"><\/i><div class=\"fusion-title title fusion-title-1 fusion-sep-none fusion-title-text fusion-title-size-one\" style=\"--awb-text-color:#ffffff;--awb-margin-bottom:30px;--awb-margin-top-small:10px;--awb-margin-right-small:0px;--awb-margin-bottom-small:10px;--awb-margin-left-small:0px;\"><h1 class=\"fusion-title-heading title-heading-left\" style=\"margin:0;\">Introduction to DITA: Structured and Reusable Technical Documentation<\/h1><\/div><div class=\"fusion-text fusion-text-1 fusion-text-no-margin\" style=\"--awb-content-alignment:center;--awb-text-color:#ffffff;--awb-margin-bottom:5%;\"><h2 style=\"text-align: left;\"><span style=\"letter-spacing: 0.24px; text-align: center; color: #ffffff; font-family: 'Maven Pro', Verdana, Geneva, sans-serif; font-size: 16px; font-weight: 400;\">Darwin Information Typing Architecture (DITA) is an XML-based open standard designed specifically for modular and reusable technical documentation. It is being developed by the DITA Technical Committee of the OASIS organization. DITA aims to improve content management, distribution, and maintenance, especially in complex and large documentation environments.<\/span><\/h2>\n<h2 style=\"text-align: left;\"><span style=\"color: #ffffff;\">What is DITA?<\/span><\/h2>\n<p style=\"text-align: left;\">DITA is based on two key principles:<\/p>\n<ol>\n<li style=\"text-align: left;\">Information Typing: Content is divided into types, such as \u201ctask\u201d, \u201cconcept\u201d, and \u201creference\u201d, which clarifies the purpose and structure of the content.<\/li>\n<li style=\"text-align: left;\">Architecture: DITA provides a flexible architecture that supports modularity and reuse of content in different contexts.<\/li>\n<\/ol>\n<h2 style=\"text-align: left;\"><span style=\"color: #ffffff;\"><b>Key components of DITA<\/b><\/span><\/h2>\n<p style=\"text-align: left;\">DITA documentation consists of two main elements:<\/p>\n<ol>\n<li style=\"text-align: left;\">Topic: A self-contained content module that covers a single topic. Topics can be of types such as tasks, concepts, or references.<\/li>\n<li style=\"text-align: left;\">Map: A structure that combines multiple topic modules into a logical whole, defining the order and hierarchy of the document.<\/li>\n<\/ol>\n<p style=\"text-align: left;\">This structure enables efficient reuse of content and makes documentation maintenance easier.<\/p>\n<h2 style=\"text-align: left;\"><span style=\"color: #ffffff;\">Benefits of DITA<\/span><\/h2>\n<ul>\n<li style=\"text-align: left;\">Reusability: Content modules can be used in multiple documents without copying.<\/li>\n<li style=\"text-align: left;\">Separating content from presentation: Content is written separately from its presentation, which allows for publication in different formats, such as HTML, PDF, or mobile apps.<\/li>\n<li style=\"text-align: left;\">Targeted content management: DITA supports content profiling and filtering, enabling, for example, content management targeted at different user groups.<\/li>\n<li style=\"text-align: left;\">Extensive tool support: There are several tools available for DITA, such as the DITA Open Toolkit and Oxygen XML Editor, that support content creation and publishing.<\/li>\n<\/ul>\n<h2 style=\"text-align: left;\"><span style=\"color: #ffffff;\">DITA vs. DocBook<\/span><\/h2>\n<p style=\"text-align: left;\">Although both DITA and DocBook are XML-based documentation standards, they have differences:<\/p>\n<ul>\n<li style=\"text-align: left;\">Structure: DocBook is designed for creating traditional books and documents, while DITA focuses on modular, topic-based content.<\/li>\n<li style=\"text-align: left;\">Extensibility: DITA provides a more flexible specialization mechanism that allows for the definition of new content types.<\/li>\n<li style=\"text-align: left;\">Reusability: DITA's architecture supports more efficient reuse of content in different contexts.<\/li>\n<\/ul>\n<h2 style=\"text-align: left;\"><span style=\"color: #ffffff;\">Summary<\/span><\/h2>\n<p style=\"text-align: left;\">DITA offers an efficient and flexible way to manage technical documentation, especially in environments where there is a lot of content and it needs to be published in multiple formats. Its modular structure, support for reusability, and extensive tool ecology make it an attractive option for many organizations.<\/p>\n<p style=\"text-align: left;\">More information about DITA and its use can be found, for example, on the official OASIS website.<\/p>\n<p style=\"text-align: left;\">\n<\/div><\/div><\/div><div class=\"fusion-layout-column fusion_builder_column fusion-builder-column-1 fusion_builder_column_1_1 1_1 fusion-flex-column fusion-flex-align-self-center\" style=\"--awb-padding-bottom:60px;--awb-bg-size:cover;--awb-width-large:100%;--awb-margin-top-large:0px;--awb-spacing-right-large:15px;--awb-margin-bottom-large:20px;--awb-spacing-left-large:15px;--awb-width-medium:100%;--awb-order-medium:0;--awb-spacing-right-medium:15px;--awb-spacing-left-medium:15px;--awb-width-small:100%;--awb-order-small:0;--awb-spacing-right-small:15px;--awb-spacing-left-small:15px;\"><div class=\"fusion-column-wrapper fusion-column-has-shadow fusion-flex-justify-content-center fusion-content-layout-row fusion-flex-align-items-center\"><div class=\"fusion-image-element\" style=\"--awb-margin-right:40px;--awb-max-width:100px;--awb-caption-title-font-family:var(--h2_typography-font-family);--awb-caption-title-font-weight:var(--h2_typography-font-weight);--awb-caption-title-font-style:var(--h2_typography-font-style);--awb-caption-title-size:var(--h2_typography-font-size);--awb-caption-title-transform:var(--h2_typography-text-transform);--awb-caption-title-line-height:var(--h2_typography-line-height);--awb-caption-title-letter-spacing:var(--h2_typography-letter-spacing);\"><span class=\"fusion-imageframe imageframe-none imageframe-1 hover-type-none\" style=\"border-radius:50px;\"><img decoding=\"async\" width=\"2560\" height=\"2560\" alt=\"Manu Ojanen Application Developer\" title=\"Manu Ojanen\" src=\"https:\/\/www.index.fi\/wp-content\/uploads\/2023\/09\/Manu.Ojanen-scaled-1.jpg\" class=\"img-responsive wp-image-271\" srcset=\"https:\/\/www.index.fi\/wp-content\/uploads\/2023\/09\/Manu.Ojanen-scaled-1-200x200.jpg 200w, https:\/\/www.index.fi\/wp-content\/uploads\/2023\/09\/Manu.Ojanen-scaled-1-400x400.jpg 400w, https:\/\/www.index.fi\/wp-content\/uploads\/2023\/09\/Manu.Ojanen-scaled-1-600x600.jpg 600w, https:\/\/www.index.fi\/wp-content\/uploads\/2023\/09\/Manu.Ojanen-scaled-1-800x800.jpg 800w, https:\/\/www.index.fi\/wp-content\/uploads\/2023\/09\/Manu.Ojanen-scaled-1-1200x1200.jpg 1200w, https:\/\/www.index.fi\/wp-content\/uploads\/2023\/09\/Manu.Ojanen-scaled-1.jpg 2560w\" sizes=\"(max-width: 640px) 100vw, 1200px\" \/><\/span><\/div><div class=\"fusion-text fusion-text-2\" style=\"--awb-text-color:var(--awb-color1);\"><p><b>Manu Ojanen<\/b><\/p>\n<p>The author is an experienced software developer at Index IT and is responsible for the development of Indox CCMS.<\/p>\n<\/div><\/div><\/div>\n<\/div><\/div>","protected":false},"excerpt":{"rendered":"","protected":false},"author":1,"featured_media":0,"parent":686,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"100-width.php","meta":{"footnotes":""},"class_list":["post-786","page","type-page","status-publish","hentry"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v28.1 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>Darwin Information Typing Architecture (DITA) - Index IT<\/title>\n<meta name=\"description\" content=\"Learn the basics and benefits of DITA content management. Index IT helps organizations structure and publish technical content efficiently using DITA and XML technologies.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.index.fi\/en\/knowledge-base\/dita\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Darwin Information Typing Architecture (DITA) - Index IT\" \/>\n<meta property=\"og:description\" content=\"Learn the basics and benefits of DITA content management. Index IT helps organizations structure and publish technical content efficiently using DITA and XML technologies.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.index.fi\/en\/knowledge-base\/dita\/\" \/>\n<meta property=\"og:site_name\" content=\"Index IT\" \/>\n<meta property=\"article:modified_time\" content=\"2026-06-25T18:37:18+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/www.index.fi\\\/fi\\\/tietopankki\\\/dita\\\/\",\"url\":\"https:\\\/\\\/www.index.fi\\\/fi\\\/tietopankki\\\/dita\\\/\",\"name\":\"Darwin Information Typing Architecture (DITA) - Index IT\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.index.fi\\\/#website\"},\"datePublished\":\"2025-04-17T12:57:24+00:00\",\"dateModified\":\"2026-06-25T18:37:18+00:00\",\"description\":\"Learn the basics and benefits of DITA content management. Index IT helps organizations structure and publish technical content efficiently using DITA and XML technologies.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/www.index.fi\\\/fi\\\/tietopankki\\\/dita\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.index.fi\\\/fi\\\/tietopankki\\\/dita\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.index.fi\\\/fi\\\/tietopankki\\\/dita\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Etusivu\",\"item\":\"https:\\\/\\\/www.index.fi\\\/fi\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Tietopankki\",\"item\":\"https:\\\/\\\/www.index.fi\\\/fi\\\/tietopankki\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Darwin Information Typing Architecture (DITA)\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/www.index.fi\\\/#website\",\"url\":\"https:\\\/\\\/www.index.fi\\\/\",\"name\":\"Index IT\",\"description\":\"Index IT\",\"publisher\":{\"@id\":\"https:\\\/\\\/www.index.fi\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/www.index.fi\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/www.index.fi\\\/#organization\",\"name\":\"Index IT\",\"url\":\"https:\\\/\\\/www.index.fi\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/www.index.fi\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/www.index.fi\\\/wp-content\\\/uploads\\\/2023\\\/09\\\/Logo_digi.png\",\"contentUrl\":\"https:\\\/\\\/www.index.fi\\\/wp-content\\\/uploads\\\/2023\\\/09\\\/Logo_digi.png\",\"width\":2165,\"height\":570,\"caption\":\"Index IT\"},\"image\":{\"@id\":\"https:\\\/\\\/www.index.fi\\\/#\\\/schema\\\/logo\\\/image\\\/\"},\"sameAs\":[\"https:\\\/\\\/www.linkedin.com\\\/company\\\/index-information-technologies-oy\\\/\"]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Darwin Information Typing Architecture (DITA) - Index IT","description":"Learn the basics and benefits of DITA content management. Index IT helps organizations structure and publish technical content efficiently using DITA and XML technologies.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.index.fi\/en\/knowledge-base\/dita\/","og_locale":"en_US","og_type":"article","og_title":"Darwin Information Typing Architecture (DITA) - Index IT","og_description":"Learn the basics and benefits of DITA content management. Index IT helps organizations structure and publish technical content efficiently using DITA and XML technologies.","og_url":"https:\/\/www.index.fi\/en\/knowledge-base\/dita\/","og_site_name":"Index IT","article_modified_time":"2026-06-25T18:37:18+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.index.fi\/fi\/tietopankki\/dita\/","url":"https:\/\/www.index.fi\/fi\/tietopankki\/dita\/","name":"Darwin Information Typing Architecture (DITA) - Index IT","isPartOf":{"@id":"https:\/\/www.index.fi\/#website"},"datePublished":"2025-04-17T12:57:24+00:00","dateModified":"2026-06-25T18:37:18+00:00","description":"Learn the basics and benefits of DITA content management. Index IT helps organizations structure and publish technical content efficiently using DITA and XML technologies.","breadcrumb":{"@id":"https:\/\/www.index.fi\/fi\/tietopankki\/dita\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.index.fi\/fi\/tietopankki\/dita\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.index.fi\/fi\/tietopankki\/dita\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Etusivu","item":"https:\/\/www.index.fi\/fi\/"},{"@type":"ListItem","position":2,"name":"Tietopankki","item":"https:\/\/www.index.fi\/fi\/tietopankki\/"},{"@type":"ListItem","position":3,"name":"Darwin Information Typing Architecture (DITA)"}]},{"@type":"WebSite","@id":"https:\/\/www.index.fi\/#website","url":"https:\/\/www.index.fi\/","name":"IT Index","description":"IT Index","publisher":{"@id":"https:\/\/www.index.fi\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.index.fi\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.index.fi\/#organization","name":"IT Index","url":"https:\/\/www.index.fi\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.index.fi\/#\/schema\/logo\/image\/","url":"https:\/\/www.index.fi\/wp-content\/uploads\/2023\/09\/Logo_digi.png","contentUrl":"https:\/\/www.index.fi\/wp-content\/uploads\/2023\/09\/Logo_digi.png","width":2165,"height":570,"caption":"Index IT"},"image":{"@id":"https:\/\/www.index.fi\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.linkedin.com\/company\/index-information-technologies-oy\/"]}]}},"_links":{"self":[{"href":"https:\/\/www.index.fi\/en\/wp-json\/wp\/v2\/pages\/786","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.index.fi\/en\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.index.fi\/en\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.index.fi\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.index.fi\/en\/wp-json\/wp\/v2\/comments?post=786"}],"version-history":[{"count":12,"href":"https:\/\/www.index.fi\/en\/wp-json\/wp\/v2\/pages\/786\/revisions"}],"predecessor-version":[{"id":1363,"href":"https:\/\/www.index.fi\/en\/wp-json\/wp\/v2\/pages\/786\/revisions\/1363"}],"up":[{"embeddable":true,"href":"https:\/\/www.index.fi\/en\/wp-json\/wp\/v2\/pages\/686"}],"wp:attachment":[{"href":"https:\/\/www.index.fi\/en\/wp-json\/wp\/v2\/media?parent=786"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}