{"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\/fi\/tietopankki\/dita\/","title":{"rendered":"Darwin Information Typing Architecture (DITA)"},"content":{"rendered":"
<\/i>

Johdatus DITA-standardiin: Rakenteinen ja uudelleenk\u00e4ytett\u00e4v\u00e4 tekninen dokumentaatio<\/h1><\/div>

Darwin Information Typing Architecture (DITA) on XML-pohjainen avoin standardi, joka on suunniteltu erityisesti teknisen dokumentaation modulaariseen ja uudelleenk\u00e4ytett\u00e4v\u00e4\u00e4n kirjoittamiseen. Sen kehityksest\u00e4 vastaa OASIS-j\u00e4rjest\u00f6n DITA Technical Committee. DITA:n tavoitteena on parantaa sis\u00e4ll\u00f6n hallintaa, jakelua ja yll\u00e4pitoa erityisesti monimutkaisissa ja laajoissa dokumentaatioymp\u00e4rist\u00f6iss\u00e4.<\/span><\/h2>\n

Mik\u00e4 on DITA?<\/span><\/h2>\n

DITA perustuu kahteen keskeiseen periaatteeseen:<\/p>\n

    \n
  1. Information Typing: Sis\u00e4lt\u00f6 jaetaan tyyppeihin, kuten ”task” (teht\u00e4v\u00e4), ”concept” (k\u00e4site) ja ”reference” (viite), mik\u00e4 selkeytt\u00e4\u00e4 sis\u00e4ll\u00f6n tarkoitusta ja rakennetta.<\/li>\n
  2. Architecture: DITA tarjoaa joustavan arkkitehtuurin, joka tukee sis\u00e4ll\u00f6n modulaarisuutta ja uudelleenk\u00e4ytt\u00f6\u00e4 eri konteksteissa.<\/li>\n<\/ol>\n

    DITA:n keskeiset komponentit<\/b><\/span><\/h2>\n

    DITA-dokumentaatio koostuu kahdesta p\u00e4\u00e4elementist\u00e4:<\/p>\n

      \n
    1. Topic: Itsen\u00e4inen sis\u00e4lt\u00f6moduuli, joka k\u00e4sittelee yht\u00e4 aihetta. Topics voivat olla tyypilt\u00e4\u00e4n esimerkiksi teht\u00e4vi\u00e4, k\u00e4sitteit\u00e4 tai viitteit\u00e4.<\/li>\n
    2. Map: Rakenne, joka yhdist\u00e4\u00e4 useita topic-moduuleja loogiseksi kokonaisuudeksi, m\u00e4\u00e4ritt\u00e4en dokumentin j\u00e4rjestyksen ja hierarkian.<\/li>\n<\/ol>\n

      T\u00e4m\u00e4 rakenne mahdollistaa sis\u00e4ll\u00f6n tehokkaan uudelleenk\u00e4yt\u00f6n ja helpottaa dokumentaation yll\u00e4pitoa.<\/p>\n

      DITA:n hy\u00f6dyt<\/span><\/h2>\n
        \n
      • Uudelleenk\u00e4ytett\u00e4vyys: Sis\u00e4lt\u00f6moduulit voidaan k\u00e4ytt\u00e4\u00e4 useissa eri dokumenteissa ilman kopiointia.<\/li>\n
      • Sis\u00e4ll\u00f6n erottaminen esitystavasta: Sis\u00e4lt\u00f6 kirjoitetaan erill\u00e4\u00e4n sen esitysmuodosta, mik\u00e4 mahdollistaa julkaisun eri formaatteihin, kuten HTML, PDF tai mobiilisovellukset.<\/li>\n
      • Kohdennettu sis\u00e4ll\u00f6nhallinta: DITA tukee sis\u00e4ll\u00f6n profilointia ja suodatusta, mahdollistaen esimerkiksi eri k\u00e4ytt\u00e4j\u00e4ryhmille suunnatun sis\u00e4ll\u00f6n hallinnan.<\/li>\n
      • Laaja ty\u00f6kalutuki: DITA:lle on saatavilla useita ty\u00f6kaluja, kuten DITA Open Toolkit ja Oxygen XML Editor, jotka tukevat sis\u00e4ll\u00f6n luomista ja julkaisemista.<\/li>\n<\/ul>\n

        DITA vs. DocBook<\/span><\/h2>\n

        Vaikka sek\u00e4 DITA ett\u00e4 DocBook ovat XML-pohjaisia dokumentaatiostandardeja, niill\u00e4 on eroja:<\/p>\n

          \n
        • Rakenne: DocBook on suunniteltu perinteisten kirjojen ja dokumenttien luomiseen, kun taas DITA keskittyy modulaariseen, topic-pohjaiseen sis\u00e4lt\u00f6\u00f6n.<\/li>\n
        • Laajennettavuus: DITA tarjoaa joustavamman erikoistumismekanismin, joka mahdollistaa uusien sis\u00e4lt\u00f6tyyppien m\u00e4\u00e4rittelyn.<\/li>\n
        • Uudelleenk\u00e4ytett\u00e4vyys: DITA:n arkkitehtuuri tukee tehokkaampaa sis\u00e4ll\u00f6n uudelleenk\u00e4ytt\u00f6\u00e4 eri konteksteissa.<\/li>\n<\/ul>\n

          Yhteenveto<\/span><\/h2>\n

          DITA tarjoaa tehokkaan ja joustavan tavan hallita teknist\u00e4 dokumentaatiota, erityisesti ymp\u00e4rist\u00f6iss\u00e4, joissa sis\u00e4lt\u00f6\u00e4 on paljon ja se tarvitsee julkaista useissa eri formaateissa. Sen modulaarinen rakenne, uudelleenk\u00e4ytett\u00e4vyyden tuki ja laaja ty\u00f6kaluekologia tekev\u00e4t siit\u00e4 houkuttelevan vaihtoehdon monille organisaatioille.<\/p>\n

          Lis\u00e4tietoja DITA:sta ja sen k\u00e4yt\u00f6st\u00e4 l\u00f6ytyy esimerkiksi OASIS:n virallisilta sivuilta.<\/p>\n

          \n<\/div><\/div><\/div>

          \"Manu<\/span><\/div>

          Manu Ojanen<\/b><\/p>\n

          Kirjoittaja on Index IT:n kokenut ohjelmistokehitt\u00e4j\u00e4 ja vastaa Indox CCMS:n kehityksest\u00e4.<\/p>\n<\/div><\/div><\/div>\n<\/div><\/div>\n","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":"\nDarwin 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\/fi\/tietopankki\/dita\/\" \/>\n<meta property=\"og:locale\" content=\"fi_FI\" \/>\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\/fi\/tietopankki\/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=\"Arvioitu lukuaika\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minuuttia\" \/>\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\":\"fi\",\"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\":\"fi\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/www.index.fi\\\/#organization\",\"name\":\"Index IT\",\"url\":\"https:\\\/\\\/www.index.fi\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"fi\",\"@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\/fi\/tietopankki\/dita\/","og_locale":"fi_FI","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\/fi\/tietopankki\/dita\/","og_site_name":"Index IT","article_modified_time":"2026-06-25T18:37:18+00:00","twitter_card":"summary_large_image","twitter_misc":{"Arvioitu lukuaika":"2 minuuttia"},"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":"fi","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":"fi"},{"@type":"Organization","@id":"https:\/\/www.index.fi\/#organization","name":"Index IT","url":"https:\/\/www.index.fi\/","logo":{"@type":"ImageObject","inLanguage":"fi","@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\/fi\/wp-json\/wp\/v2\/pages\/786","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.index.fi\/fi\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.index.fi\/fi\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.index.fi\/fi\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.index.fi\/fi\/wp-json\/wp\/v2\/comments?post=786"}],"version-history":[{"count":12,"href":"https:\/\/www.index.fi\/fi\/wp-json\/wp\/v2\/pages\/786\/revisions"}],"predecessor-version":[{"id":1363,"href":"https:\/\/www.index.fi\/fi\/wp-json\/wp\/v2\/pages\/786\/revisions\/1363"}],"up":[{"embeddable":true,"href":"https:\/\/www.index.fi\/fi\/wp-json\/wp\/v2\/pages\/686"}],"wp:attachment":[{"href":"https:\/\/www.index.fi\/fi\/wp-json\/wp\/v2\/media?parent=786"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}