Muistan venäläisen luennoitsijan vitsin yliopiston kansainvälisen kommunikaation kurssilta: ’Suomessa kaikki toimii, mutta mitään ei saa tehtyä. Venäjällä mikään ei toimi, mutta mikä vain on tehtävissä.’ Tällainen tasapainottelu valmiuden ja sovellettavuuden välillä pätee myös muissa asiayhteyksissä, ja … Read More
DoX CMS antaa julkaista verkkosisältöjä myös WebHelp-formaatissa, jossa HTML-julkaisu asetetaan valmiiksi määritettyjen kehyksien sisään. Olen aiemmin kertonut, kuinka kyseisen kehyksen ulkoasua voi säätää täällä. Tässä yhteydessä käyn puolestaan läpi seikkoja, jotka on syytä huomioida kehyksen ulkoasun … Read More
Aiemmin kävin läpi keinoja selvittää, kuinka edeltäjäsi käyttivät DoX CMS:ää, jos he eivät jättäneet jälkeensä sisäistä dokumentaatiota aiheesta. Kuten korostin kyseisessä artikkelissa, sisäinen dokumentaatio koskien oikeita käyttötapoja on erittäin tärkeää. Tämä pitää paikkansa kaikkien rakenteisten dokumentointijärjestelmien … Read More
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
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
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
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
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
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
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