Comparing FrameMaker and Quicksilver as Tools for Producing Single Sourced Content from XML
HUHTAMÄKI, HENRI (2006)
2006
Englantilainen filologia - English Philology
Humanistinen tiedekunta - Faculty of Humanities
This publication is copyrighted. You may download, display and print it for Your own personal use. Commercial use is prohibited.
Hyväksymispäivämäärä
2006-01-10
Julkaisun pysyvä osoite on
https://urn.fi/urn:nbn:fi:uta-1-15294
https://urn.fi/urn:nbn:fi:uta-1-15294
Tiivistelmä
Tutkimuksen tarkoituksena on vertailla kahta yleisesti teknisen dokumentaation tuottamiseen tarkoittettua ohjelmaa yksilähteistämisen näkökulmasta, kun lähdemateriaali on XML-muodossa: Adobe FrameMakeria ja Broadvision Quicksilveriä. Tarkoituksena on antaa teknisille kirjoittajille ja tekniseen viestintään erikoistuneille yrityksille tarpeeksi tietoa, jotta he osaisivat valita oikean työkalun omiin tarkoitusperiinsä. Työkalut testataan tutkimuskentän rajoittamiseksi sellaisina kokonaisuuksina kuin ne tuotepakkauksessa ovat.
Kiinnostus yksilähteistämisen toteuttamiseen on noussut yritysten ja teknisten kirjoittajien yhteydessä monista syistä, lähinnä se on rahan- ja ajansäästökysymys. Yksilähteistäminen ei ole täysin ongelmaton ratkaisu, mutta tietyissä oloissa se voi säästää selvästi resursseja.
Yksilähteistämistä tarkasteltiin työkalujen yhteydessä tutkimalla niiden rakenteisia ympäristöjä, ehdollista tekstiä ja HTML-julkaisua. Tarkoituksena oli saada tuotua Metso Automationilta saatuja XML-dokumentteja työkaluun, antaa tiedolle uusia ulkoasumäärittelyjä tuonnin yhteydessä tai sen jälkeen ja julkaista ehdollista tekstiä ja HTML:ää tästä testidatasta. XML-ominaisuuksien tutkiminen jakautui selkeästi rakenteisen ympäristön käyttöönottoon ja sen testaamiseen. Päätösenteon helpottamiseksi XML-ominaisuudet pyrittiin myös kuvaamaan mahdollisimman tarkasti. Testauksen yhteydessä kiinnitettiin myös huomiota työkalun rakenteisten ominaisuuksien dokumentaatioon.
Testitulokset voidaan kiteyttää siten, että FrameMaker on helpompi käyttöönottaa kuin Quicksilver, sen HTML-julkaisu on ammattimaisempi, koska sen mukana tulee erillinen työkalu (Webworks Publisher) tähän tarkoitukseen. FrameMaker antaa käyttäjälle mahdollisuuden antaa eri muotoiluja erilaisille ehdollisille teksteille, mutta sen rakenteinen työskentely-ympäristö on hieman epäjärjestelmällinen verrattuna Quicksilveriin. Quicksilverissä puolestaan on kompakti käyttöliittymä rakenteisten dokumenttien kanssa työskentelyyn, sisääntulevan XML-tiedon prosessointiohjeet ovat monipuolisesti räätälöitävissä, ja se tarjoaa tehokkaat puitteet ehdollisen tekstin tuottamiseen. Quicksilverin prosessointiohjeiden tekeminen vaatii kuitenkin Interleaf Lisp -ohjelmointikielen hallintaa ja HTML-julkaisu ei ole yhtä kehittynyt kuin FrameMakerin mukana tulevassa Webworks Publisherissa.
Jatkotutkimuksia voi toteuttaa tutkittujen ohjelmien uudemmista versioista, tai testaamalla yksilähteistämistä XML-tyylikielillä ja vertailemalla tätä tapaa tutkielmassa esitettyyn yksilähteistämisympäristöön.
Hakutermit:
technical communication, XML, single sourcing, FrameMaker, Quicksilver
Kiinnostus yksilähteistämisen toteuttamiseen on noussut yritysten ja teknisten kirjoittajien yhteydessä monista syistä, lähinnä se on rahan- ja ajansäästökysymys. Yksilähteistäminen ei ole täysin ongelmaton ratkaisu, mutta tietyissä oloissa se voi säästää selvästi resursseja.
Yksilähteistämistä tarkasteltiin työkalujen yhteydessä tutkimalla niiden rakenteisia ympäristöjä, ehdollista tekstiä ja HTML-julkaisua. Tarkoituksena oli saada tuotua Metso Automationilta saatuja XML-dokumentteja työkaluun, antaa tiedolle uusia ulkoasumäärittelyjä tuonnin yhteydessä tai sen jälkeen ja julkaista ehdollista tekstiä ja HTML:ää tästä testidatasta. XML-ominaisuuksien tutkiminen jakautui selkeästi rakenteisen ympäristön käyttöönottoon ja sen testaamiseen. Päätösenteon helpottamiseksi XML-ominaisuudet pyrittiin myös kuvaamaan mahdollisimman tarkasti. Testauksen yhteydessä kiinnitettiin myös huomiota työkalun rakenteisten ominaisuuksien dokumentaatioon.
Testitulokset voidaan kiteyttää siten, että FrameMaker on helpompi käyttöönottaa kuin Quicksilver, sen HTML-julkaisu on ammattimaisempi, koska sen mukana tulee erillinen työkalu (Webworks Publisher) tähän tarkoitukseen. FrameMaker antaa käyttäjälle mahdollisuuden antaa eri muotoiluja erilaisille ehdollisille teksteille, mutta sen rakenteinen työskentely-ympäristö on hieman epäjärjestelmällinen verrattuna Quicksilveriin. Quicksilverissä puolestaan on kompakti käyttöliittymä rakenteisten dokumenttien kanssa työskentelyyn, sisääntulevan XML-tiedon prosessointiohjeet ovat monipuolisesti räätälöitävissä, ja se tarjoaa tehokkaat puitteet ehdollisen tekstin tuottamiseen. Quicksilverin prosessointiohjeiden tekeminen vaatii kuitenkin Interleaf Lisp -ohjelmointikielen hallintaa ja HTML-julkaisu ei ole yhtä kehittynyt kuin FrameMakerin mukana tulevassa Webworks Publisherissa.
Jatkotutkimuksia voi toteuttaa tutkittujen ohjelmien uudemmista versioista, tai testaamalla yksilähteistämistä XML-tyylikielillä ja vertailemalla tätä tapaa tutkielmassa esitettyyn yksilähteistämisympäristöön.
Hakutermit:
technical communication, XML, single sourcing, FrameMaker, Quicksilver