Uudistunut sisällysluettelon, otsikoiden ja linkkien muotoilu

DoX CMS:n versio 8.8 toi mukanaan merkittäviä muutoksia otsikoiden ja julkaisujen sisäisten linkkien pohjarakenteeseen. Nämä muutokset näkyvät myös sisällysluetteloissa. Käyn täällä läpi näitä muutoksia sekä niihin liittyviä tarpeita ja mahdollisuuksia. Käyn ensin läpi tekemämme muutokset julkaisupohjiin … Read More

Tyhjien linkkien paikantamisen keino

Yksi riskeistä rakenteisien järjestelmien käyttämisessä on, että joskus julkaisujen sisäisten linkkien kohteet eivät ole mukana samoissa julkaisuissa kuin kyseiset linkit. Tältä tilanteelta vältytään ehdollistamalla kyseiset linkit vastaavalla tavoin kuin niiden kohteet ja varmistamalla, että linkkien kohteet … Read More

Julkaisukohtaiset tyylisovitukset

DoX CMS:n versio 8.7 lisäsi julkaisuihin niiden julkaisupohjien revisionumeroiden tunnistearvot. Kävin edellisessä artikkelissa läpi yksityiskohtia version 8.7 mukanaan tuomiin eroihin näkymien suodatuksessa. Tällä kertaa esittelen keinoja käyttää näitä lisätunnisteita julkaisujen sisällön ja ulkoasun hallinnoimiseen. Yleisellä tasolla … Read More

Valittujen työkalujen vaikutus kirjoittajiin

Tämä on puolifilosofinen pohdinta koskien työkalujen roolia osana työn tekijöiden suhdetta työhönsä, sen tuloksiin ja itseensä sen tekijöinä. Koska toimitamme kirjoittamisen työkaluja kuten rakenteisen kirjoittamisen järjestelmää DoX CMS, on esitettämäni näkökulma tämän eturistiriidan värittämä. Ensisijaisesti tämä … Read More

CSS-muuttujat ja laskelmat dokumentaation tukena

Aiempi DocRaptor-julkaisuputken päivitys DoX CMS:ssä mahdollisti CSS-muuttujien ja laskelmien käyttämisen myös sitä kautta kasatuissa PDF-julkaisuissa. Muut näiden tyylitiedostojen toimintojen kanssa yhteensopivat julkaisumuodot ovat oletuskasaajalla tehdyt PDF:t, ja verkkojulkaisut eli HTML ja WebHelp. Tämän päivityksen vuoksi on … Read More

Attribuuttien käyttäminen tyylitiedostoissa

Tyylitiedostojen valitsijat voi kytkeä mihin tahansa sisällön tunnisteisiin. Useimmiten tähän käytetään ID-arvoja tai luokkia kuten .dita-title. Myös muut attribuuttiarvot kuitenkin soveltuvat tähän. Koska DoX CMS:n elementtiluokat ja tagit on toteutettu elementtien attribuutteina, niitä koskevat ohjeet ovat … Read More

Yleisluontoisten toimintojen soveltamisen edut

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

Sisäinen dokumentaatio DoX:issa ja DoX:ista

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

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