tuotedokumentaation tuotanto

Transkriptio

1 Tekla: DITA ja monikielisen tuotedokumentaation tuotanto Martti Poutanen, Index IT Oy Rune Backman, Tekla Oyj XML Finland

2 Tekla Oyj Tekla kehittää ohjelmistoratkaisuja, - tuotteita ja -palveluita asiakkaittensa ydinliiketoimintaan rakentamisessa ja yhdyskuntatoimessa sekä energianjakelussa Perustettu vuonna 1966 Teklan liikevaihto vuonna 2007 oli lähes 60 miljoonaa euroa ja liiketulos noin 20 miljoonaa euroa Kansainvälisen liiketoiminnan osuus on yli 80 prosenttia Tekla-konsernin palveluksessa työskentelee lähes 450 henkilöä Teklan osake on listattu NASDAQ OMX Helsingissä

3 Index IT XML ja SGML teknologioiden asiantuntija rakenteisten järjestelmien konsultointi ja toteutus dokumentin- ja sisällönhallinta ja jakelu vahvat yhteistyökumppanit kuten as X-Hive, Antennahouse, Ontopia ja Arbortext kokenut vuodesta 1994, yli 50 miestyövuoden kokemus rakenteisesta tekstistä referenssejä: Talentum, Tamrock, Danfoss, Metos, Finnair, Lääkelaitos, Vaisala, Valtiovarainministeriö, Tilastokeskus, Rakennustieto, SFS, Tekla...

4 Tekla Structures Tekla Structures on rakennuksen tietomallinnus (BIM) - ohjelmisto, jolla voi luoda ja hallita tarkasti detaljoituja, rakentamisen prosesseja tukevia kolmi- ja neliulotteisia rakennemalleja. Tekla-mallia voi hyödyntää rakennusprosessin kaikissa vaiheissa luonnossuunnittelusta valmistukseen, pystytykseen ja rakentamisen hallintaan.

5 Tekla Structures käyttökohteita Tehtaita Kauppakeskuksia Maamerkkejä Kevytmetallirunkoisia Monimateriaalisia Off-shore rakenteita rakenteita rakenteita

6 Tekla Structures dokumentaatio, ennen Master-kieli on US englanti 8 kieliversiota: saksa, espanja, ranska, italia, hollanti, japani, kiina ja venäjä Sisältö, ylläpito ja julkaisu Pitkiä ei-rakenteisia dokumentteja, <2000 sivua/kieli Ehdollisilla teksteillä merkattiin uudet, poistettavat ja eri mediaan julkaistettavat asiat Ylläpito ja PDF-julkaisu FrameMaker-ohjelmalla, HTML Helpit WebWorks Publisher -ohjelmalla Ongelmat Hankalaa löytää ja päivittää oikeita kohtia Ei juurikaan uusiokäyttöä Kieliversioiden päivittäminen työlästä

7 DITA pähkinänkuoressa Darwin Information Typing Architecture XML-pohjainen arkkitehtuuri keskeisiä tekijöitä ovat autonominen informaatiomoduli (Topic) näitä yhteenkokoava kartta (Map) informaatiomodulien keskinäisten riippuvuuksien kuvaus (Reltable) related topics sisältöviittaukset (conref) uusiokäyttö

8 DITAn arkkitehtuuri modulaarinen DTD/schema määritysjoukko perus-topic ja siitä johdetut task, reference, concept map conref spesialisaation/periytymisen käsite mekanismi uusien informaatiotyyppien luomiseen perustransformaatiot (Dita Toolkit)

9 Topic A topic is a unit of information with a title and content, short enough to be specific to a single subject or answer a single question, but long enough to make sense on its own and be authored as a unit. geneerinen teksti (topic) käsitteet (concept) toimintokuvaukset (task) references dialogi-ikkunan välilehden kuvaus (tab reference) mallinnuskomponentin seloste (ts component)

10 Kuva Tekla Structures topicista

11 DITA Map DITA maps are documents that collect and organize references to DITA topics to indicate the relationships among the topics. DITA Map tiedon konteksti k ti tiedon järjestys ja hierarkia staattinen ehdollistaminen (metatiedot) tiedon keskinäiset suhteet (reltable) See related topic

12 Kuva Tekla Structures mapista

13 Spesialisaatio Specialization allows you to define new kinds of information (new structural types or new domains of information), while reusing as much of existing design and code as possible, and minimizing or eliminating the costs of interchange, migration, and maintenance. strukturaalinen uudet informaatiotyypit domain sovellusaluekohtaiset rakenteet tämä on se Darwin DITAssa (evoluutio, periytyminen)

14 Spesialisaatio spesialisaatio generalisaatio

15 Spesialisaatiot Strukturaaliset topic concept task reference tscomp. tabref. Domain Tekla domain elements - attribuutit - elementit

16 Uusiokäyttö An element can replace itself with the content of a like element elsewhere, either in the current topic or in a separate topic that shares the same content models. DITA tukee sisällön uusiokäyttöä content reference tekniikka ei riko rakennetta mikä tahansa fragmentti voidaan uusiokäyttää

17 Tekla Structures dokumentaatio, nyt Master-kielisiä topicceja n synkronoidut, alisteiset kieliversiot topicceja kannassa > uusiokäyttö (conref) ja dynaaminen ristiviittaustekniikka versiohallinta ja julkaisujen revisiointi Sisältö, ylläpito ja julkaisu attribuuttiohjattu sisällön suodatus tuote/media jne. attribuuttiohjattu sisällön status Ylläpito ja PDF-julkaisu FrameMaker-ohjelmalla, HTML Helpit OASIS DITA Open Toolkitin avulla

18 Järjestelmä-arkkitehtuuri

19 Indox DITA Connector

20 Monikielisyys, haasteet yksittäisen dokumenttikomponentista (topic) yksi pääkielinen versio sisällön tuottajat ylläpitävät n kappaletta sivukielisiä versioita joihin on synkronoitava tehdyt muutokset kääntämistä varten minimoiden käännettävän tekstin määrä» siirrot, lisäykset poistot, t conref, xref asemointi» esim. taulukkogeometria, kuvien asemointi

21 Monikielisyys, haasteet komponenttien määrä käännöstyötä vaativien komponenttien löytäminen ja kokoaminen käännöspaketiksi sivukielten päivitys eräajona käännöstarpeen laskeminen kielten väliset rakenne-erot grafiikka kielestä riippuvat ja riippumattomat kuvat

22 Monikielisyys Master-slave-prosessi topic-tasolla: HTML Help (chm) esimerkkejä:

23 Kokemukset Vanhan aineiston konvertointi DITA-muotoon Uudelleenjärjestely työläs operaatio Materiaalin sovittaminen DITAan vaatii myös uudelleenkirjoittamista Saavutettuja hyötyjä On luotu alusta mille voi rakentaa eteenpäin Modulaarisuus Uusiokäyttö mahdollinen Käännösprosessi sujuvaksi, tätä kautta myös kustannussäästöjä Selkeitä sääntöjä (standardi) sisällöntuotantoon

24 Kiitoksia! Yhteystiedot: Index Information Technologies Oy Tekla Oyj