{"id":1013,"date":"2025-06-19T12:16:43","date_gmt":"2025-06-19T09:16:43","guid":{"rendered":"https:\/\/www.index.fi\/?page_id=1013"},"modified":"2025-09-05T11:19:08","modified_gmt":"2025-09-05T08:19:08","slug":"dita-kayttoonotto","status":"publish","type":"page","link":"https:\/\/www.index.fi\/fi\/tietopankki\/dita-kayttoonotto\/","title":{"rendered":"DITA:n k\u00e4ytt\u00f6\u00f6notto"},"content":{"rendered":"<div class=\"fusion-fullwidth fullwidth-box fusion-builder-row-1 fusion-flex-container no-bottom-margin nonhundred-percent-fullwidth non-hundred-percent-height-scrolling\" 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-bottom:80px;--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;\"><h1 class=\"fusion-title-heading title-heading-left\" style=\"margin:0;\"><strong>DITA:n k\u00e4ytt\u00f6\u00f6notto dokumentointiprosessissa<\/strong><\/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:10%;\"><p style=\"text-align: left;\">DITA (Darwin Information Typing Architecture) tarjoaa tehokkaan tavan hallita teknist\u00e4 dokumentaatiota modulaarisesti ja uudelleenk\u00e4ytett\u00e4v\u00e4sti. Sen k\u00e4ytt\u00f6\u00f6notto voi kuitenkin tuntua haastavalta erityisesti tiimeille, joilla ei ole aiempaa kokemusta rakenteellisesta kirjoittamisesta tai XML:st\u00e4. Onnistunut siirtym\u00e4 edellytt\u00e4\u00e4 suunnittelua, oikeita ty\u00f6kaluja ja sis\u00e4ll\u00f6ntuotannon prosessien uudelleenarviointia. T\u00e4ss\u00e4 artikkelissa k\u00e4yd\u00e4\u00e4n l\u00e4pi keskeiset vaiheet DITA:n k\u00e4ytt\u00f6\u00f6nottoon.<\/p>\n<ol style=\"text-align: left;\">\n<li>Tunnista tarpeet ja tavoitteet<br \/>\nAloita kartoittamalla, miksi haluat siirty\u00e4 DITAan. Onko tavoitteena sis\u00e4ll\u00f6n uudelleenk\u00e4ytt\u00f6, monikielinen julkaisu, tehokkaampi p\u00e4ivitysprosessi tai skaalautuva dokumentaatiorakenne? Selke\u00e4 tavoite auttaa valitsemaan oikeat ty\u00f6kalut ja resurssit.<\/li>\n<li>Kouluta tiimi<br \/>\nDITA tuo mukanaan uuden ajattelutavan: topic-pohjaisen ja rakenteellisen kirjoittamisen. Varmista, ett\u00e4 kirjoittajilla on peruskoulutus DITA:sta ja ett\u00e4 he ymm\u00e4rt\u00e4v\u00e4t k\u00e4sitteet, kuten topic-tyypit (task, concept, reference), sis\u00e4lt\u00f6kartat (maps) ja metatiedot.<\/li>\n<li>Valitse sopivat ty\u00f6kalut<br \/>\nDITA vaatii editorin, joka tukee XML-muotoilua ja DITA-rakennetta. Suosittuja vaihtoehtoja ovat esimerkiksi Oxygen XML Editor, DITA Open Toolkitja CCMS-j\u00e4rjestelm\u00e4t (Component Content Management System), jotka helpottavat versionhallintaa ja julkaisua useisiin kanaviin.<\/li>\n<li>Suunnittele sis\u00e4lt\u00f6rakenne<br \/>\nHyvin suunniteltu informaatiomallion DITA-projektin selk\u00e4ranka. M\u00e4\u00e4rit\u00e4, miten sis\u00e4lt\u00f6 jaetaan topiceihin, millaisia uudelleenk\u00e4ytt\u00f6tarpeita on ja miten sis\u00e4lt\u00f6 kootaan julkaisuiksi. My\u00f6s metatietojen ja taksonomioiden suunnittelu kannattaa tehd\u00e4 alusta l\u00e4htien huolella.<\/li>\n<li>Aloita pienesti, skaalaa my\u00f6hemmin<br \/>\n\u00c4l\u00e4 yrit\u00e4 siirt\u00e4\u00e4 kaikkea kerralla. Valitse pilottiprojekti \u2013 esimerkiksi yksi k\u00e4ytt\u00f6opas tai tuotelinja \u2013 ja k\u00e4yt\u00e4 sit\u00e4 DITA-k\u00e4ytt\u00f6\u00f6noton testialustana. Ker\u00e4\u00e4 palautetta ja kehit\u00e4 prosessia iteratiivisesti.<\/li>\n<\/ol>\n<p style=\"text-align: left;\"><strong>Yhteenveto<\/strong>:<br \/>\nDITA:n k\u00e4ytt\u00f6\u00f6notto vaatii suunnittelua, mutta palkitsee selkeydell\u00e4, tehokkuudella ja skaalautuvuudella. Kun prosessi tehd\u00e4\u00e4n vaiheittain ja k\u00e4ytt\u00e4j\u00e4t koulutetaan kunnolla, DITA voi tuoda merkitt\u00e4vi\u00e4 etuja tekniseen dokumentointiin niin sis\u00e4ll\u00f6n hallinnan kuin loppuk\u00e4ytt\u00e4j\u00e4kokemuksen osalta.<\/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-1013","page","type-page","status-publish","hentry"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.5 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>DITA:n k\u00e4ytt\u00f6\u00f6notto - Index IT<\/title>\n<meta name=\"description\" content=\"DITA:n k\u00e4ytt\u00f6\u00f6notto selkeytt\u00e4\u00e4 ja tehostaa dokumentointia. Katso viisi keskeist\u00e4 vaihetta, joilla onnistut projektin aloituksessa ja skaalaamisessa.\" \/>\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-kayttoonotto\/\" \/>\n<meta property=\"og:locale\" content=\"fi_FI\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"DITA:n k\u00e4ytt\u00f6\u00f6notto - Index IT\" \/>\n<meta property=\"og:description\" content=\"DITA:n k\u00e4ytt\u00f6\u00f6notto selkeytt\u00e4\u00e4 ja tehostaa dokumentointia. Katso viisi keskeist\u00e4 vaihetta, joilla onnistut projektin aloituksessa ja skaalaamisessa.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.index.fi\/fi\/tietopankki\/dita-kayttoonotto\/\" \/>\n<meta property=\"og:site_name\" content=\"Index IT\" \/>\n<meta property=\"article:modified_time\" content=\"2025-09-05T08:19:08+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-kayttoonotto\\\/\",\"url\":\"https:\\\/\\\/www.index.fi\\\/fi\\\/tietopankki\\\/dita-kayttoonotto\\\/\",\"name\":\"DITA:n k\u00e4ytt\u00f6\u00f6notto - Index IT\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.index.fi\\\/#website\"},\"datePublished\":\"2025-06-19T09:16:43+00:00\",\"dateModified\":\"2025-09-05T08:19:08+00:00\",\"description\":\"DITA:n k\u00e4ytt\u00f6\u00f6notto selkeytt\u00e4\u00e4 ja tehostaa dokumentointia. Katso viisi keskeist\u00e4 vaihetta, joilla onnistut projektin aloituksessa ja skaalaamisessa.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/www.index.fi\\\/fi\\\/tietopankki\\\/dita-kayttoonotto\\\/#breadcrumb\"},\"inLanguage\":\"fi\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.index.fi\\\/fi\\\/tietopankki\\\/dita-kayttoonotto\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.index.fi\\\/fi\\\/tietopankki\\\/dita-kayttoonotto\\\/#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\":\"DITA:n k\u00e4ytt\u00f6\u00f6notto\"}]},{\"@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":"DITA:n k\u00e4ytt\u00f6\u00f6notto - Index IT","description":"DITA:n k\u00e4ytt\u00f6\u00f6notto selkeytt\u00e4\u00e4 ja tehostaa dokumentointia. Katso viisi keskeist\u00e4 vaihetta, joilla onnistut projektin aloituksessa ja skaalaamisessa.","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-kayttoonotto\/","og_locale":"fi_FI","og_type":"article","og_title":"DITA:n k\u00e4ytt\u00f6\u00f6notto - Index IT","og_description":"DITA:n k\u00e4ytt\u00f6\u00f6notto selkeytt\u00e4\u00e4 ja tehostaa dokumentointia. Katso viisi keskeist\u00e4 vaihetta, joilla onnistut projektin aloituksessa ja skaalaamisessa.","og_url":"https:\/\/www.index.fi\/fi\/tietopankki\/dita-kayttoonotto\/","og_site_name":"Index IT","article_modified_time":"2025-09-05T08:19:08+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-kayttoonotto\/","url":"https:\/\/www.index.fi\/fi\/tietopankki\/dita-kayttoonotto\/","name":"DITA:n k\u00e4ytt\u00f6\u00f6notto - Index IT","isPartOf":{"@id":"https:\/\/www.index.fi\/#website"},"datePublished":"2025-06-19T09:16:43+00:00","dateModified":"2025-09-05T08:19:08+00:00","description":"DITA:n k\u00e4ytt\u00f6\u00f6notto selkeytt\u00e4\u00e4 ja tehostaa dokumentointia. Katso viisi keskeist\u00e4 vaihetta, joilla onnistut projektin aloituksessa ja skaalaamisessa.","breadcrumb":{"@id":"https:\/\/www.index.fi\/fi\/tietopankki\/dita-kayttoonotto\/#breadcrumb"},"inLanguage":"fi","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.index.fi\/fi\/tietopankki\/dita-kayttoonotto\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.index.fi\/fi\/tietopankki\/dita-kayttoonotto\/#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":"DITA:n k\u00e4ytt\u00f6\u00f6notto"}]},{"@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\/1013","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=1013"}],"version-history":[{"count":6,"href":"https:\/\/www.index.fi\/fi\/wp-json\/wp\/v2\/pages\/1013\/revisions"}],"predecessor-version":[{"id":1242,"href":"https:\/\/www.index.fi\/fi\/wp-json\/wp\/v2\/pages\/1013\/revisions\/1242"}],"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=1013"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}