Saavutettavan sisällön kirjoittaminen Silverstripe CMS:ssä

Tiivistelmä

Saavutettava verkkosisältö auttaa erilaisia kävijöitä löytämään tarvitsemansa tiedon ja käyttämään sitä. Joku lukee sivua puhelimella, toinen suurentaa tekstiä ja kolmas kuuntelee sisällön ruudunlukijalla. Myös kiire…

Silverstripe CMS tarjoaa työkaluja sisällön jäsentämiseen, mutta julkaisujärjestelmä ei yksin tee tekstistä saavutettavaa. Sisällöntuottajan valinnat vaikuttavat siihen, ymmärtääkö kävijä otsikot, linkit, ohjeet ja kuvien merkityksen.

Hyvä lähtökohta on kirjoittaa lukijan tehtävää ajatellen. Kun sivulla on selkeä tarkoitus, johdonmukainen rakenne ja ymmärrettävä kieli, sen käyttäminen helpottuu. Saavutettavuus muodostuu monesta pienestä päätöksestä, jotka voi ottaa osaksi tavallista kirjoittamista.

Aloita siitä, mitä kävijä tarvitsee

Ennen Silverstripen tekstieditorin avaamista määrittele sivun tärkein tehtävä. Onko tarkoitus auttaa ilmoittautumaan tapahtumaan, ratkaisemaan ongelma vai löytämään yhteystiedot?

Kirjoita olennainen tieto alkuun. Esimerkiksi tapahtumasivulla kävijä tarvitsee nopeasti tapahtuman nimen, ajankohdan, paikan ja ilmoittautumisohjeen. Järjestäjän pitkä esittely voi tulla myöhemmin.

Voit suunnitella sisältöä kolmen kysymyksen avulla:

Mitä kävijä haluaa tietää?
Mitä hänen pitää tehdä?
Mitä tietoja hän tarvitsee toiminnan onnistumiseen?

Jos kirjoitat ohjetta tiedoston lataamiseen, kerro myös, millainen tiedosto on kyseessä ja mihin sitä käytetään. Pelkkä latauspainike ilman asiayhteyttä jättää lukijan arvaamaan.

Rajaa samalla sivun aihe. Jos yhdellä sivulla käsitellään useita toisistaan riippumattomia tehtäviä, erilliset sivut voivat tehdä kokonaisuudesta helpommin hahmotettavan.

Käytä ymmärrettävää ja täsmällistä kieltä

Saavutettava teksti ei tarkoita, että kaikki asiat pitäisi yksinkertaistaa äärimmilleen. Tavoitteena on ilmaista tarvittava tieto tavalla, jonka kohderyhmä ymmärtää.

Suosi tuttuja sanoja ja selitä välttämättömät erikoistermit ensimmäisellä käyttökerralla. Avaa lyhenteet, jos niiden merkitys ei ole lukijalle itsestään selvä.

Vertaa esimerkiksi näitä ohjeita:

Raskas: ”Julkaisutoimenpiteen suorittaminen edellyttää tallennustoiminnallisuuden hyödyntämistä.”
Selkeä: ”Tallenna muutokset ennen julkaisemista.”

Kirjoita yksi pääasia kerrallaan. Pitkän virkkeen voi usein jakaa kahdeksi ilman, että sisältö menettää tarkkuutta. Käytä myös konkreettisia toimintaohjeita: ”Lähetä lomake viimeistään 15. lokakuuta” kertoo enemmän kuin ”Hoida asia hyvissä ajoin”.

Selkeä yleiskieli auttaa monia lukijoita, mutta se ei ole sama asia kuin erityisesti mukautettu selkokieli. W3C:n kirjoittamisohjeissa suositellaan muun muassa selkeää ilmaisua, ymmärrettäviä ohjeita ja tarpeettoman monimutkaisuuden välttämistä.

Rakenna sivu oikeilla otsikkotasoilla

Otsikot auttavat silmäilemään sisältöä ja siirtymään kiinnostavaan kohtaan. Ruudunlukijan käyttäjä voi puolestaan liikkua sivulla otsikoiden avulla.

Silverstripen tekstieditorissa otsikko tehdään valitsemalla tarkoitukseen sopiva otsikkotyyli. Pelkkä lihavointi tai tekstin suurentaminen ei muodosta rakenteellista otsikkoa.

Sivupohja tuottaa usein sivun nimestä H1-pääotsikon. Tällöin varsinaisen sisältöalueen pääosiot aloitetaan yleensä H2-tasolta. H2-osion tarkemmat alaluvut merkitään H3-otsikoiksi.

Esimerkiksi asennusohjeen rakenne voisi olla:

H1: Silverstripen asentaminen
H2: Valmistelut ennen asennusta
H3: Palvelinympäristön tarkistaminen
H3: Tietokannan luominen
H2: Asennuksen suorittaminen
H2: Asennuksen tarkistaminen

Valitse otsikkotaso sisällön suhteiden perusteella. Jos otsikko näyttää liian suurelta, ulkoasua kannattaa korjata sivuston tyyleissä sen sijaan, että valitsisit rakenteeseen sopimattoman tason. W3C:n otsikko-ohje kuvaa otsikoiden tehtävää sivun hierarkiassa.

Jaa teksti kappaleisiin ja käytä oikeita listoja

Pitkä yhtenäinen tekstimassa on vaikea silmäillä. Jaa sisältö kappaleisiin siten, että jokainen kappale kehittää yhtä ajatusta.

Käytä numeroitua listaa silloin, kun vaiheiden järjestys vaikuttaa lopputulokseen. Luettelomerkit sopivat vaihtoehtoihin, ominaisuuksiin ja muistettaviin asioihin.

Tee listat Silverstripen editorin luettelopainikkeilla. Älä rakenna niitä kirjoittamalla rivien alkuun käsin väliviivoja tai numeroita. Editorin oikeat listatoiminnot tuottavat myös ohjelmallisesti tunnistettavan luettelorakenteen. Tätä suosittelee Silverstripen sisällöntuotanto-ohje.

Vältä myös tyhjien rivien ja välilyöntien käyttämistä asetteluun. Jos tarvitset esimerkiksi kaksi palstaa, käytä sivustolle toteutettua sisältölohkoa. Käsin tehty asettelu voi hajota pienellä näytöllä tai tekstiä suurennettaessa.

Kirjoita linkit, joiden tarkoitus selviää tekstistä

Linkkitekstin pitäisi auttaa kävijää ymmärtämään, minne linkki johtaa. Ilmaukset ”tästä” ja ”klikkaa tästä” ovat usein liian epämääräisiä.

Kirjoita mieluummin:

Tutustu Silverstripen asennusohjeeseen.
Katso tapahtuman ohjelma.
Lataa käyttöohje PDF-tiedostona.
Ota yhteyttä asiakaspalveluun.

Silverstripessä valitset ensin linkiksi tulevan tekstin ja lisäät siihen linkin editorin toiminnolla. Tarkista samalla, että kohde vastaa tekstissä annettua lupausta.

Jos linkki avaa tiedoston, kerro tiedostomuoto. Myös tiedoston koko kannattaa ilmoittaa, jos lataus on suuri. Älä avaa linkkejä tarpeettomasti uuteen välilehteen. Jos uusi välilehti on perusteltu, kerro siitä käyttäjälle.

Ajattele linkkiä pienenä opasteena: ”Lue lisää” ei vielä kerro, mitä seuraavalla sivulla odottaa.

Huolehdi kuvien tekstivastineista

Tietoa välittävälle kuvalle tarvitaan vaihtoehtoinen teksti, joka kertoo sen olennaisen sisällön tai tehtävän. Hyvä kuvaus riippuu siitä, miksi kuva on sivulla.

Jos ohjekuva näyttää valitun asetuksen, kuvaile kyseinen asetus. Jos kuva toimii linkkinä, tekstivastineen pitää auttaa ymmärtämään linkin tarkoitus.

Pelkkä koristekuva käsitellään yleensä tyhjällä vaihtoehtoisella tekstillä, jotta ruudunlukija voi ohittaa sen. Kaikkia kuvia ei siis tarvitse kuvailla. W3C:n kuvaohje erottaa toisistaan tietoa välittävät, koristeelliset ja toiminnalliset kuvat.

Silverstripessä vaihtoehtoisen tekstin kentän sijainti riippuu siitä, lisätäänkö kuva tekstieditoriin vai erilliseen sisältölohkoon.

Älä jätä tärkeitä ohjeita pelkän kuvan varaan. Jos kuvassa lukee ilmoittautumisen määräaika, kirjoita päivämäärä myös sivun varsinaiseen tekstiin.

Esitä taulukot ymmärrettävästi

Taulukko sopii tietoon, jossa rivien ja sarakkeiden suhteet ovat olennaisia. Esimerkiksi palvelupakettien ominaisuuksia voi olla helpompi vertailla taulukossa kuin pitkänä tekstinä.

Pidä rakenne mahdollisimman yksinkertaisena:

Anna taulukolle kuvaava nimi tai sitä selittävä johdanto.
Merkitse tarvittavat rivi- ja sarakeotsikot otsikkosoluiksi.
Vältä tarpeettomia yhdistettyjä soluja.
Kerro mittayksiköt selkeästi.
Tarkista toimivuus myös kapealla näytöllä.

Lihavoitu ensimmäinen rivi ei yksin korvaa otsikkosolujen merkintää. Ruudunlukija tarvitsee ohjelmallisesti tunnistettavat yhteydet otsikoiden ja tietosolujen välille. W3C:n taulukko-ohje selittää nämä rakenteet.

Silverstripen taulukkoasetukset riippuvat editorin kokoonpanosta. Jos tarvittavia asetuksia ei ole käytettävissä, pyydä ylläpitäjältä apua. Taulukkoa ei pidä korvata kuvakaappauksella.

Muista videot, äänitteet ja ladattavat tiedostot

Saavutettavuus koskee myös sivulle upotettua ja linkitettyä sisältöä. Selkeästi kirjoitettu verkkosivu ei ratkaise videon tai liitetiedoston puutteita.

Puhetta sisältävä video tarvitsee asianmukaiset tekstitykset. Tarkista automaattisesti tuotetut tekstitykset etenkin nimien, lukujen ja teknisten termien osalta. Pelkässä äänessä esitetylle sisällölle tarvitaan tekstivastine.

Jos videon tärkeä tieto välittyy vain kuvasta, se pitää tarjota myös saavutettavassa muodossa, esimerkiksi kuvailutulkkauksella tilanteen mukaan. W3C:n mediaohje käsittelee eri mediatyyppien tarpeita.

Julkaise keskeiset toimintaohjeet mahdollisuuksien mukaan suoraan verkkosivulla. Jos tarjoat PDF-tiedoston, tarkista myös sen lukemisjärjestys, otsikot ja muut saavutettavuusominaisuudet. Verkkosivulle kirjoitettu lyhyt esittely ei yksin tee liitteestä saavutettavaa.

Tarkista sisältö ennen julkaisemista

Tallenna luonnos ja avaa Silverstripen esikatselu. Lue sivu ensin tavallisesti ja käy sen jälkeen läpi otsikot, linkit ja toimintaohjeet erikseen.

Kokeile seuraavia tarkistuksia:

Ymmärrätkö sivun tarkoituksen otsikon ja ensimmäisen kappaleen perusteella?
Löytyykö tärkein tieto ilman pitkää etsimistä?
Eteneekö otsikkorakenne johdonmukaisesti?
Ovatko linkkien kohteet ymmärrettäviä?
Säilyykö sisältö luettavana tekstiä suurennettaessa?
Voiko linkkeihin ja muihin toimintoihin siirtyä näppäimistöllä?

Automaattinen tarkistus auttaa löytämään osan ongelmista, mutta se ei arvioi luotettavasti esimerkiksi ohjeen ymmärrettävyyttä. Myös Silverstripen oma ohje korostaa ihmisen tekemän arvioinnin tarvetta.

Kaikki puutteet eivät kuulu sisällöntuottajan korjattaviksi. Esimerkiksi näkymätön näppäimistökohdistus tai sivupohjan virheellinen rakenne vaatii kehittäjän työtä. Kirjaa tällaisesta ongelmasta sivun osoite, havaittu tilanne ja toivottu toiminta.

Pidä saavutettavuus mukana päivityksissä

Tarkista sisältö uudelleen aina, kun vaihdat kuvia, lisäät linkkejä tai muokkaat ohjeita. Aiemmin selkeä sivu voi muuttua sekavaksi vähitellen tehtyjen lisäysten seurauksena.

Yhteinen kirjoitusohje helpottaa työtä, jos sivustolla on useita päivittäjiä. Sopikaa otsikkotasojen käytöstä, linkkien nimeämisestä ja julkaisua edeltävistä tarkistuksista. Kun käytännöt ovat tuttuja, saavutettavuus kulkee mukana sisällön suunnittelusta sen ylläpitoon.

Liittyvät kategoriat

Artikkeleita 2 010 artikkelia IT 1 936 artikkelia Kotisivut 1 191 artikkelia Nettisivut 1 192 artikkelia Silverstripe CMS 25 artikkelia Verkkokehitys 1 251 artikkelia Verkkosivut 1 391 artikkelia Verkkotyökalu 1 163 artikkelia