WebHelp-pohjan mukauttaminen

Yksi DoX CMS:n julkaisumuodoista on WebHelp. Tällaiset julkaisut ovat HTML-julkaisuja, jotka on asetettu yhden otsikkosisällön kerrallaan esittävään ja sisällysluettelon näkyvissä pitävään kehykseen. Alkuperäinen kehys rakennettiin omaan käyttöömme. Tästä syystä monia seikkoja on syytä muuttaa tyylitiedostojen avulla, … Read More

Uuden käyttäjän vanhassa ympäristössä tarkistuslista

Törmään hieman liian usein tilanteisiin, missä ainoa sisäinen kirjoittaja on vaihdettu toiseen ja uusille kirjoittajille ei ole jätetty lainkaan sisäistä dokumentaatiota DoX CMS:n käytön tueksi. Pitäkää yllä sisäisiä käyttöoppaita. Kukaan ei halua joutua kyseiseen tilanteeseen. Syynä … Read More

Tageihin sidotut tyylit

Näissä artikkeleissa on ajoittain viitattu mahdollisuuteen, että tyylitiedostoissa määritetään sääntöjä elementeille, joihin on käytetty tiettyjä tageja. Yleensä ottaen emme suosittele tällaisten sääntöjen käyttämistä. Tässä artikkelissa kuitenkin käydään läpi joitakin tapoja, joilla tagikohtaiset säännöt tyylitiedostoissa voivat tuoda … Read More

Hyvät käännöskäytänteet DoX CMS:ssä

Sisältöjä eri kielillä hallinnoidaan tällä hetkellä täysin itsenäisesti DoX CMS:ssä. Tämä vaatii, että sisältöjen täytyy olla valmisteltu asianmukaisesti alkuperäiskielellä ennen niiden käännettäviksi lähettämistä. Tämä vähentää tarvetta uusille käännöspyynnöille korjauksia tai hallinnointia varten. Toki on hyvä huomioida, … Read More

Informaatio ei ole (vain) järjestettyä dataa

Moni tekniseen viestintään liittyvä työnimike kuten ’informaatioarkkitehti’ viittaa informaatioon joko suorasti tai epäsuorasti. Samanaikaisesti koko tämänhetkistä yhteiskuntaamme määrittää datatalous, joka perustuu datamassojen kokoamiseen ja jalostamiseen lisäarvoa tuottaviksi. Informaatio ja data ovat toisiinsa niin läheisesti liittyviä käsitteitä, … Read More

3D-pohjainen viestintäjärjestelmä AFTR mullistaa käyttöohje- ja varaosakirjamarkkinat

Olemme kehittäneet yhteistyössä kanadalaisen ohjelmistotalon kanssa 3D-pohjaisen viestintäjärjestelmän, AFTRin, joka mahdollistaa 3D-mallien hyödyntämisen koneiden ja laitteiden käyttöohjeissa ja varaosakirjoissa. Käyttöohjeiden ja varaosakirjojen luominen on perinteisesti vaatinut hidasta käsityötä, kun suunnittelijan luomista 3D-malleista on pitänyt karsia liikesalaisuuksia … Read More

DoX CMS:n Oletustyönkierto

Rakenteinen kirjoittaminen ja sitä tukevat järjestelmät muodostavat monivaiheisen prosessin. Vaikka tämän prosessin yksityiskohdat voivat poiketa eri toimijoiden tarpeiden mukaisesti, järjestelmiin on rakennettu oletustyönkierto. Tämä oletustyönkierto on runko, jonka varaan muutokset prosessissa tehdään ja joka rajoittaa mahdollisia … Read More

Käyttäjien Hallinnoimat Ehdollistetut Oppaat

Kun osallistuin 2022 VAKKI-symposiumiin, keskustelin yhden esitelmän päätteeksi esitelmöijien käsittelemistä dokumentaation käytettävyyden lisäämisen keinoista. Kyseessä oli sisällön vahvempi kohdistaminen käyttäjäkohtaisten tarpeiden mukaiseksi ja kuinka tämä turhan usein tapahtuu muiden kuin käyttäjän itsensä tekemiin oletuksiin soveltuvasta osaamistasosta. … Read More

Akatemietintöjä: Uudelleenkäyttö ja Sisällön Kontekstisidonnaisuus

Tämä artikkelisarja, josta käytän nimeä ’Akatemietintöjä’, tarjoaa muita neuvovia kirjoituksiani hieman teorialähtöisemmän näkökulman sekä teknistä että rakenteista kirjoittamista koskien. Ajattelin olevan mielenkiintoista soveltaa opintojani koskien esimerkiksi kielifilosofiaa, kulttuurievoluutiota ja kognitiolingvistiikkaa näihin aihepiireihin. Tässä ensimmäisessä osassa keskustellaan … Read More

CSS:n Rajat ja Elementtiluokkien Tärkeys

Olen sitten viimeisimmän artikkelin törmännyt erinäisiin tilanteisiin, missä CSS:n (cascading style sheets) sallimat muutokset eivät riitä. Usein näissä tilanteissa riittää käyttää lisätunnisteita, jotta halutut elementit saadaan erotettua muusta sisällöstä. Toisin sanoen käyttäjien tulee tällöin käyttää elementtiluokkia. … Read More