{"id":1321,"date":"2026-06-25T20:47:55","date_gmt":"2026-06-25T17:47:55","guid":{"rendered":"https:\/\/www.index.fi\/?page_id=1321"},"modified":"2026-06-25T21:27:51","modified_gmt":"2026-06-25T18:27:51","slug":"mika-on-dita-open-toolkit","status":"publish","type":"page","link":"https:\/\/www.index.fi\/fi\/tietopankki\/mika-on-dita-open-toolkit\/","title":{"rendered":"Mik\u00e4 on DITA-OT?"},"content":{"rendered":"
<\/i>

Mik\u00e4 on DITA Open Toolkit ja mihin sit\u00e4 voi k\u00e4ytt\u00e4\u00e4?<\/strong><\/h1><\/div>

T<\/span>eknisess\u00e4 <\/span>dokumentoinnissa ja suuren luokan sis\u00e4ll\u00f6nhallinnassa t\u00f6rm\u00e4\u00e4 usein lyhenteeseen DITA-OT eli DITA Open Toolkit. Kyseess\u00e4 on avoimen l\u00e4hdekoodin ty\u00f6kalu, joka toimii monen teollisuus- ja ohjelmistoyrityksen ohjekirjojen ja tukisivustojen moottorina.<\/span><\/p>\n

Mutta mit\u00e4 t\u00e4m\u00e4 ty\u00f6kalu k\u00e4yt\u00e4nn\u00f6ss\u00e4 tekee ja miksi se on niin suosittu teknisten kirjoittajien ja kehitt\u00e4jien keskuudessa?<\/p>\n<\/div>

Mik\u00e4 on DITA Open Toolkit?<\/h2><\/div>

DITA Open Toolkit on julkaisumoottori. Sen teht\u00e4v\u00e4n\u00e4 on ottaa vastaan DITA-standardin mukaista XML-raakateksti\u00e4 ja muuntaa se helpommin luettavaan muotoon, kuten verkkosivustoksi tai PDF-tiedostoksi.<\/p>\n

Itse DITA (Darwin Information Typing Architecture) on vain s\u00e4\u00e4nt\u00f6kokoelma siit\u00e4, miten teksti kirjoitetaan ja j\u00e4sennell\u00e4\u00e4n koodeilla ja t\u00e4geill\u00e4. DITA-koodi itsess\u00e4\u00e4n on pelkk\u00e4\u00e4 raakadataa, jota on vaikea lukea sellaisenaan. DITA Open Toolkit on se ty\u00f6kalu, joka lukee t\u00e4m\u00e4n datan, yhdist\u00e4\u00e4 tekstipalaset oikeaan j\u00e4rjestykseen ja tekee siit\u00e4 valmiin lopputuotteen.<\/p>\n<\/div>

Mihin DITA Open Toolkitia voi k\u00e4ytt\u00e4\u00e4?<\/h2><\/div>

DITA-OT on parhaimmillaan silloin, kun dokumentoitavaa on valtavasti, tuoteversioita on useita ja ohjeiden on p\u00e4ivitytt\u00e4v\u00e4 jatkuvasti. Se ei ole ty\u00f6kalu yhden manuaalin taittamiseen, vaan teollisen tason k\u00e4\u00e4nt\u00e4j\u00e4, joka nivoo pirstaleisen XML-datan valmiiksi tuotteiksi ilman ihmisen v\u00e4liintuloa.<\/p>\n

K\u00e4yt\u00e4nn\u00f6ss\u00e4 sen rooli tiivistyy kolmeen p\u00e4\u00e4teht\u00e4v\u00e4\u00e4n:<\/p>\n

1. Sis\u00e4ll\u00f6n uudelleenk\u00e4ytt\u00f6 ja monikanavajulkaisu<\/p>\n

Yhden tekstin yll\u00e4pit\u00e4minen useassa paikassa on ajanhaaskausta. DITA-OT:n ydinidea on ottaa yksi XML-l\u00e4hdetiedosto ja k\u00e4\u00e4nt\u00e4\u00e4 se useaan eri muotoon yhdell\u00e4 komennolla. Sama varoitus- tai asennusohje voidaan puskea suoraan tuotteen mukana toimitettavaan PDF-tiedostoon, asiakastuen responsiiviselle verkkosivustolle sek\u00e4 suoraan ohjelmiston sis\u00e4iseen ”Help”-valikkoon.<\/p>\n

2. Ehdollinen julkaisu ja profilointi<\/p>\n

Kun ohjelmistosta tai laitteesta on olemassa esimerkiksi perus-, pro- ja yll\u00e4pit\u00e4j\u00e4versiot, DITA-OT eliminoi tarpeen yll\u00e4pit\u00e4\u00e4 kolmea erillist\u00e4 opasta. L\u00e4hdetekstiin merkit\u00e4\u00e4n (profiloidaan), mik\u00e4 tieto kuuluu millekin kohderyhm\u00e4lle tai laitemallille. Julkaisuvaiheessa DITA-OT:lle annetaan parametrit, ja se suodattaa tuhansien sivujen joukosta automaattisesti vain juuri kyseist\u00e4 versiota koskevan, r\u00e4\u00e4t\u00e4l\u00f6idyn manuaalin.<\/p>\n

3. Dokumentaation automatisointi (Docs-as-Code)<\/p>\n

Moderneissa ohjelmistoprojekteissa dokumentaatiota k\u00e4sitell\u00e4\u00e4n samalla tavalla kuin itse koodia. Koska DITA-OT toimii t\u00e4ysin komentorivilt\u00e4, se on helppo kytke\u00e4 osaksi yrityksen CI\/CD-putkea (esim. Jenkins tai GitHub Actions). Kun koodari tai kirjoittaja puskee p\u00e4ivityksen versiohallintaan, DITA-OT her\u00e4\u00e4 automaattisesti taustalla, k\u00e4\u00e4nt\u00e4\u00e4 uudet ohjeet ja julkaisee sivuston p\u00e4ivitetyn version suoraan tuotantoon.<\/p>\n<\/div>

Kenelle se on tarkoitettu?<\/h2><\/div>

DITA Open Toolkit on harvoin suoraan teknisen kirjoittajan silmien edess\u00e4. Kirjoittajat k\u00e4ytt\u00e4v\u00e4t yleens\u00e4 erillist\u00e4 tekstieditoria tai laajempaa sis\u00e4ll\u00f6nhallintaj\u00e4rjestelm\u00e4\u00e4 (CCMS), jonka moottorina DITA-OT py\u00f6rii n\u00e4kym\u00e4tt\u00f6m\u00e4sti taustalla. Se on ennen kaikkea dokumentaation arkkitehtien, teknisten kirjoittajien ja DevOps-asiantuntijoiden ty\u00f6kalu, jolla varmistetaan, ett\u00e4 tieto liikkuu ja p\u00e4ivittyy tehokkaasti.<\/p>\n<\/div>

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

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

Kirjoittaja on Index IT:n kokenut ohjelmistokehitt\u00e4j\u00e4.<\/span><\/p>\n<\/div><\/div><\/div><\/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-1321","page","type-page","status-publish","hentry"],"yoast_head":"\nMik\u00e4 on DITA-OT? - Index IT<\/title>\n<meta name=\"description\" content=\"Mik\u00e4 on DITA Open Toolkit (DITA-OT)? Esittelyss\u00e4 teknisen dokumentoinnin moottori, joka mahdollistaa monikanavajulkaisun ja automaattiset julkaisuputket.\" \/>\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\/mika-on-dita-open-toolkit\/\" \/>\n<meta property=\"og:locale\" content=\"fi_FI\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Mik\u00e4 on DITA-OT? - Index IT\" \/>\n<meta property=\"og:description\" content=\"Mik\u00e4 on DITA Open Toolkit (DITA-OT)? Esittelyss\u00e4 teknisen dokumentoinnin moottori, joka mahdollistaa monikanavajulkaisun ja automaattiset julkaisuputket.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.index.fi\/fi\/tietopankki\/mika-on-dita-open-toolkit\/\" \/>\n<meta property=\"og:site_name\" content=\"Index IT\" \/>\n<meta property=\"article:modified_time\" content=\"2026-06-25T18:27:51+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=\"3 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\\\/mika-on-dita-open-toolkit\\\/\",\"url\":\"https:\\\/\\\/www.index.fi\\\/fi\\\/tietopankki\\\/mika-on-dita-open-toolkit\\\/\",\"name\":\"Mik\u00e4 on DITA-OT? - Index IT\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.index.fi\\\/#website\"},\"datePublished\":\"2026-06-25T17:47:55+00:00\",\"dateModified\":\"2026-06-25T18:27:51+00:00\",\"description\":\"Mik\u00e4 on DITA Open Toolkit (DITA-OT)? Esittelyss\u00e4 teknisen dokumentoinnin moottori, joka mahdollistaa monikanavajulkaisun ja automaattiset julkaisuputket.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/www.index.fi\\\/fi\\\/tietopankki\\\/mika-on-dita-open-toolkit\\\/#breadcrumb\"},\"inLanguage\":\"fi\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.index.fi\\\/fi\\\/tietopankki\\\/mika-on-dita-open-toolkit\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.index.fi\\\/fi\\\/tietopankki\\\/mika-on-dita-open-toolkit\\\/#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\":\"Mik\u00e4 on DITA-OT?\"}]},{\"@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":"Mik\u00e4 on DITA-OT? - Index IT","description":"Mik\u00e4 on DITA Open Toolkit (DITA-OT)? Esittelyss\u00e4 teknisen dokumentoinnin moottori, joka mahdollistaa monikanavajulkaisun ja automaattiset julkaisuputket.","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\/mika-on-dita-open-toolkit\/","og_locale":"fi_FI","og_type":"article","og_title":"Mik\u00e4 on DITA-OT? - Index IT","og_description":"Mik\u00e4 on DITA Open Toolkit (DITA-OT)? Esittelyss\u00e4 teknisen dokumentoinnin moottori, joka mahdollistaa monikanavajulkaisun ja automaattiset julkaisuputket.","og_url":"https:\/\/www.index.fi\/fi\/tietopankki\/mika-on-dita-open-toolkit\/","og_site_name":"Index IT","article_modified_time":"2026-06-25T18:27:51+00:00","twitter_card":"summary_large_image","twitter_misc":{"Arvioitu lukuaika":"3 minuuttia"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.index.fi\/fi\/tietopankki\/mika-on-dita-open-toolkit\/","url":"https:\/\/www.index.fi\/fi\/tietopankki\/mika-on-dita-open-toolkit\/","name":"Mik\u00e4 on DITA-OT? - Index IT","isPartOf":{"@id":"https:\/\/www.index.fi\/#website"},"datePublished":"2026-06-25T17:47:55+00:00","dateModified":"2026-06-25T18:27:51+00:00","description":"Mik\u00e4 on DITA Open Toolkit (DITA-OT)? Esittelyss\u00e4 teknisen dokumentoinnin moottori, joka mahdollistaa monikanavajulkaisun ja automaattiset julkaisuputket.","breadcrumb":{"@id":"https:\/\/www.index.fi\/fi\/tietopankki\/mika-on-dita-open-toolkit\/#breadcrumb"},"inLanguage":"fi","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.index.fi\/fi\/tietopankki\/mika-on-dita-open-toolkit\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.index.fi\/fi\/tietopankki\/mika-on-dita-open-toolkit\/#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":"Mik\u00e4 on DITA-OT?"}]},{"@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\/1321","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=1321"}],"version-history":[{"count":7,"href":"https:\/\/www.index.fi\/fi\/wp-json\/wp\/v2\/pages\/1321\/revisions"}],"predecessor-version":[{"id":1356,"href":"https:\/\/www.index.fi\/fi\/wp-json\/wp\/v2\/pages\/1321\/revisions\/1356"}],"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=1321"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}