Kirjasampo-Sahan ohjeistus

Wiki

• Kaunokirjallisuushanke Kirjasammon etusivulle

Jos ohje ei oikein avaudu tai jos haluat saada lisätietoa, kysyä lisää tai kommentoida ohjeita, ota yhteyttä ohjeistuksen ylläpitäjiin: kirjasampo@kirjastot.fi

Yleistä Saha-annotaatioeditorista

Kirjasampo-Sahan ohjeistuksen tarkoituksena on houkutella sinut mukaan uusien ja vanhojen kaunokirjallisten teosten ja niiden kirjoittajien tietojen kuvailuun eli annotointiin.

Tavoitteena on yhdessä tuotettu, jatkuvasti täydentyvä kaunokirjallinen, semanttinen verkkokopalvelu, jossa on monipuoliset hakuominaisuudet.

Semanttinen web työkaluineen ja ontologioineen muodostavat monimutkaisen tietoteknisen ympäristön. Kuvailutasolla sinun ei kuitenkaan tarvitse hallita koko kokonaisuutta. Uusia käsitteitä vilisee - annotaatio, Saha, skeema, ontologia, Onki-selain - mutta pohjimmiltaan on kyse kirjastolaisille tutuista luettelointiin liittyvistä asioista.

Kirjasampo-Saha

• Kirjasampo-Saha on varsinaisesti teosten ja kirjailijoiden ontologiaperustaiseen kuvailuun tarkoitettu annotaatiotyökalu, joka on kehitetty TKK:n semanttisen laskennan tutkimusryhmässä (SECO), osana FinnONTO-projektia.

• Saha on selainpohjainen ja tällä hetkellä se toimii parhaiten Firefox-selaimella. Tiedonhaku onnistuu myös InternetExplorerilla, mutta tiedontallennus on parasta tehdä Firefoxilla.

• Kirjasampo-Saha pohjautuu skeemalle, jossa on määritelty kaikki teosten ja kirjailijoiden kuvailuun tarvittavat kentät.

• Kirjasampo-Sahaan on kytketty ontologioita, joista voidaan hakea kuvailuun tarvittavia asiasanoja. Kirjasampo-Sahassa on käytössä: KOKO-ontologia, Kaunokki-yhdistelmäontologia (YSO+Kaunokki), paikka- ja lingvoj-ontologiat. Uudenlaiset tekniikat helpottavat sisällönkuvailutyön rutiineja. Termejä ei tarvitse etsiä erillisistä palveluista, vaan ne voi poimia suoraan ontologioista.

• Kirjasampo-Sahan pohja-aineistona on HelMet-kirjastojärjestelmästä saatu aikuisten suomenkielinen kaunokirjallinen aineisto 1800-luvulta alkaen. Tämä tarkoittaa, että suurin osa ilmestyneistä teoksista ja kirjailijoista on jo valmiina Sahassa ja sinun tehtävänäsi on osallistua kuvailutietojen, erityisesti asiasanoitukseen ja kirjailijatietojen täydentämiseen.

• Sahassa on myös virheellistä ja puutteellisesti tallennettua tietoa, jota on suotavaa korjata ja täydentää.

• Kirjasampo-Sahan asiasanoitus perustuu erilliseen fiktiivisen aineiston asiasanastoon Kaunokkiin, jonka löydät verkosta osoitteesta: http://kaunokki.kirjastot.fi/ nimellä Verkko-Kaunokki. Verkko-Kaunokki perustuu fasettiajatteluun eli asiasanat on jaoteltu viiteen kategoriaan: Genre (laji, tyyli), Teema, Henkilö/Toimija, Paikka, Aika. Nämä fasetit ovat myös Kirjasampo-Sahassa.

• Yksittäisen teoksen ja kirjailijan kuvailuista syntyvät ns. perusannotaatiot, joihin on kiinnitetty kuvailukentät tietosisältöineen. Perusannotaation sisällä on kuvailutietoja, joilla on omat annotaatiot (esim. kustantaja ja sarjatieto). Tämä mahdollistaa sen, että esim. Otavan oma annotaatio kerää semanttisessa verkossa yhteen kaikki ne teokset, joiden kustantaja on Otava. Kuulostaa monimutkaiselta, mutta onneksi tämä kaikki on jo pääosin sovelluksessa valmiina ja sinun tehtävä on vain täyttää kuvailutietoja.

• Kirjasampo-Saha pystyy näyttämään ajantasaisina aakkosillisina listauksina vaikkapa teostyypit ja mitkä teokset kuuluvat teostyyppiin Runokokoelmat. Lähes kaiken tallennetun tiedon saa koottuna näkyville aakkosellisina listauksina. Saha hyödyntää semanttisia tekniikoita, joiden avulla tuotettu kuvailutieto on paremmin myös tietokoneiden ymmärrettävissä.

• Kirjasampo-Sahassa on mahdollista tehdä korjauksia ja muutoksia koko ajan ja lähes mihin kenttään tahansa. Yksittäisen tiedon voi helposti poistaa, sillä sen yhteydessä on [remove]-painike, jota klikkaamalla poisto tapahtuu kysymättä. Muista olla tarkkaavainen, ettet poista turhaan. Tosin tiedon saa palautettua yhtä helposti.

• Sahassa on hyödynnetty funktionaalisen luetteloinnin menetelmiä. Sen mukaisesti teosta kuvaillaan sekä abstraktilla että fyysisellä tasolla. Abstraktin tasoon kuuluvat ne teosta kuvaavat asiat, joiden voidaan ajatella olevan kaikille erikielisille versioille samat, kuten päävastuullinen tekijä ja kaikki sisältöön liittyvät kuvailutiedot. Fyysisellä tasolla puolestaan kuvaillaan teoksen ulkoasua ja julkaisuhistoriaa. Fyysiset teokset ovat erikielisiä laitoksia samasta teoksesta, eivät esim. eri painoksia. Fyysisistä teoksista viedään ensimmäisen painoksen mukaiset tiedot, muista painoksista voi tietoa lisätä Ilmestymishistoriaan liittyvään kenttään. Kumpaankin tasoon on kytketty siihen liittyvät kentät, joten tiedontallentajan ei tarvitse niitä muistaa. Kentät on lueteltu alempana.

Kirjasampo-Sahassa on oikeassa laidassa käytössä chat-mahdollisuus, jonka välityksellä voi esittää kysymyksiä. Viestit tulevat näkyviin enteriä painamalla kaikille Sahan käyttäjille.

Kirjasampo-Sahan kehitysluonteen vuoksi editorissa esiintyy ajoittain katkoksia ja se voi antaa erinäisiä virheilmoituksia. Projektiryhmä pyrkii korjaamaan tilanteen mahdollisimman nopeasti.

Mikäli kohtaat ongelmia, tai sinulla on kysyttävää ota yhteyttä projektityöryhmään: kirjasampo@kirjastot.fi

Haku Kirjasampo-Sahasta

Huom! Tämä koskee vain hakua Sahasta. Kirjasampo-palvelun käyttöliittymässä hakutavat tulevat olemaan erilaiset, esim. on mahdollista tehdä tarkkoja hakuja ja yhdistellä hakuehtoja.

Sahan hakulaatikko [search] on sivun ylälaidassa vasemmalla. Haku kohdistuu kaikkeen Sahaan tallennettuun tietoon, niin teksteihin, asiasanoihin kuin kirjailijoihin. Kirjoitettaessa hakuelementtejä hakulaatikkoon Saha ehdottaa hakuehdot täyttäviä tuloksia, joten enteriä ei paineta. Riittää, että sanoista kirjoitetaan vain osa. Henkilöitä hakiessa nimen voi kirjoittaa muodossa etunimi sukunimi tai päinvastoin.

Esim.

maup nov > saadaan esille Maupassantin kirjoittamat novellit

kri tot > Krisztina Toth

äiti joy > James Joycen kirjoittama novelli Äiti

anton t > Anton Tsehov

Katkaisumerkki = puolipiste (;), esim. äiti; > katkaisee sanan tai fraasin.

Saha näyttää ensin 15 hakutulosta. Jos tuloksia halutaan saada enemmän, lisätään haun perään plus-merkki (+). Huom. Saha hakee seuraavat tuhat viitettä, joten haku kestää hetken.

Hakutuloslistassa kursori siirretään halutun kohteen (teoksen, kirjailijan, asiasanan) kohdalle ja klikataan.

Saha näyttää ensin ns. korttinäytön [view], josta abstraktin tai fyysisen teoksen tietoja päästään muokkaamaan painamalla [edit].

Ns. leijukkeiden avulla voidaan nähdä, mitä tietoa Sahaan on tallennettu. Esim. kun kursori viedään kirjailijan nimen päälle, esiin tulee hänestä Sahaan tallennettu tieto.

Jokainen alleviivattu sana on linkki muihin termiin, nimeen tai ominaisuuteen liittyviin annotaatioihin. Vasemmassa yläkulmassa oleva kirjasampo–linkki vie Sahan etusivulle.

Tiedontallennus Kirjasampo-Sahaan

Sahassa on kahdenlaisia tietokenttiä:

 Add new literal (tunnistaa Add-painikkeesta): ns. vapaateksti –kenttä, johon kirjoitetaan haluttu teksti ja painetaan add.

Jos tekstikentän edessä on pienempi kenttä, siihen lisätään kielikoodi, joka määräytyy syötettävän tekstin perusteella (oletusarvona on fi eli suomi). Kielikoodit ovat kaksikirjaimisia ja perustuvat SFS-ISO 639-1 -standardiin, yleisimmät kielikoodit löytyvät tästä.

Jos jo tallennettua tietoa halutaan muuttaa, klikataan tekstiä, jolloin se on muokattavissa. Muutosten jälkeen painetaan taas add.

 Select reference (tunnistaa nuolipainikkeesta): tieto poimitaan joko ontologiasta tai jo Sahaan tallennetuista tiedoista. Vaihtoehtoja saadaan esiin kirjoittamalla termin ensimmäiset kirjaimet.

Remove poistaa tiedon. Poistettu tieto näkyy yliviivattuna, ja häviää sivun päivittämisen jälkeen.

Kaikki kentät ovat toistettavissa. Edit-tilasta päästään katsomaan tallennettuja tietoja takaisin ”korttinäytölle” painamalla [view].

Joihinkin kenttiin on mahdollista luoda ja tallentaa uutta tietoa. Niissä tapauksissa kentän viereen ilmestyy teksti create a new instance quick | inline.

Quick-vaihtoehto valitaan silloin, kun tallennettavaan tietoon ei liitetä lisätietoa.

Inline-vaihtoehto tuo esiin uuden tallennusalustan, jolla voidaan kuvata tallennettavaa tietoa asiasanoin tai sanallisesti. Inline-tila voidaan sulkea sen vasemmassa ylälaidassa olevasta [close]-painikkeesta. Kenttäkohtaisista ohjeista selviää, mihin kenttiin on mahdollista luoda uusi instanssi.

Jos halutaan katsoa ja muokata sisällönkuvailuja, hakutuloksista valitaan nimeke, jonka määreenä on teostyyppi, esim. Romaanit, Novellit, Runot.

Jos halutaan katsoa ja muokata teoksen ulkoasuun tai julkaisuhistoriaan liittyviä tietoja, valitaan nimeke, jonka määreenä on fyysinen teos tai fyysisen teoksen osa.

Abstraktin ja fyysisen teoksen välillä voi myös liikkua joustavasti, joten abstraktista teoksesta pääsee katsomaan/muokkaamaan myös fyysisen teoksen tietoja ja päinvastoin.

Sahassa voidaan toistaa kaikkia tiedontallennuskenttiä.

Abstraktin teoksen kuvailu

nimi

teoksen nimet niillä kielillä, joilla se on tallennettu Sahaan, kukin nimi omaan kenttäänsä. add new literal, ks. ohje yllä

Muista lisätä kielikoodi kentän edessä olevaan pienempään laatikkoon.

esimerkki: [remove] (fi) Putkinotko [remove] (sv) Ödemarkens barn

muu nimi

muut nimet, joilla teos on ilmestnyt, esimerkiksi nimi (fi) Santiagon unet muu nimi (fi)Alkemisti

nimi-kenttään se nimi, jolla teos on ensimmäisen kerran ilmestynyt

add new literal, ks. ohje yllä

tekijä

teoksen päävastuullinen tekijä / tekijät

poimitaan Sahaan jo tallennetuista tekijöistä tai luodaan uusi:

kirjoitetaan kenttään kirjailijan nimi muodossa Sukunimi, Etunimi

valitaan inline ja täytetään vähintään seuraavat kentät, jos tiedossa:

sukupuoli, kansallisuus, kieli, syntymä-, kuolinaika, ja -paikka, ammatti

alkukieli

se kieli, jolla teos on ensimmäisen kerran kirjoitettu (jos tiedossa)

poimitaan kieliontologiasta

ei voi luoda uutta kieltä

kirjallisuudenlaji l. genre

kirjallisuudenlaji(t), johon tai joihin teos kuuluu

poimitaan Kaunokki-ontologiasta

ei voi luoda uutta

aiheet ja teemat

teoksen keskeisimmät aiheet, se, mistä kirjassa on kyse;

liittyy usein tarinaan, juoneen

myös sivuteemat, jos käsitelty aihe on harvinainen tai teoksen kokonaisuuden kannalta tärkeä

poimitaan Kaunokki-ontologiasta

ei voi luoda uutta

henkilöt, toimijat

teoksen keskeiset toimijat ja päähenkilöt asiasanoin: ihmiset, eläimet, taruolennot…

poimitaan Kaunokki-ontologiasta

ei voi luoda uutta

päähenkilöt

päähenkilö(ide)n erisnimi/-nimet

poimitaan valikosta Sahaan jo tallennetuista tai luodaan uusi

jos tallennetaan vain nimi, se luodaan quick-toiminnolla

jos päähenkilöstä annetaan myös lisätietoa (asiasanat, kuvaus), valitaan inline. Näin toimitaan etenkin, jos Sahasta löytyy useita samannimisiä henkilöitä.

personifikaatio henkilöstä: jos teos käsittelee reaalimaailman henkilöä, poimitaan kenttään Sahasta kyseisen henkilön nimi (esim. Elina Vaara). Jos nimeä ei löydy, luodaan uusi inline-toiminnolla.

tapahtumapaikka

teoksen tapahtumapaikka asiasanoin (esim. sairaalat, maaseutu, puistot...)

poimitaan Kaunokki-ontologiasta

ei voi luoda uutta

konkreettinen tapahtumapaikka

maantieteelliset paikat (maat, kaupungit, kylät)

poimitaan paikkaontologiasta

fiktiiviset paikat: poimitaan valikosta Sahaan jo tallennetuista

tarvittaessa luodaan uusi fiktiivinen paikka joko quick-toiminnolla (tallennetaan vain paikan nimi) tai inline-toiminnolla (jos halutaan tallentaa paikkaan liittyvää lisätietoa)

tapahtuma-aika

teoksen tapahtuma-aika asiasanoin (esim. kesä, yö)

poimitaan Kaunokki-ontologiasta

ei voi luoda uutta

tarkka aika

esim. päivämäärä, vuosiluku, vuosikymmen(et)

poimitaan valikosta Sahaan jo tallennetuista

1920-luku = 1920-1929, voidaan käyttää kumpaa vaihtoehtoa vain

luodaan uusi quick-toiminnolla, merkintätavat: esim. 2.9.1990, 1740-luku, 1999

jos teos tapahtuu useammalla vuosikymmenellä, poimitaan kaikki valikosta, esim. 1920-luku, 1930-luku, 1940-luku...

asiasana tai oma avainsana

tämä kenttä on lähinnä omien avainsanoja eli sellaisia kuvailutermejä varten, joita ei löydy ontologioista. Tähän kenttään voi poimia Sahaan jo tallennettuja avainsanoja tai luoda uuden harkinnan jälkeen.

kirjoitetaan asiasana ja tallennetaan quick-toiminnolla. Jos sanalle halutaan antaa määritelmä tms., valitaan inline-toiminto

asiasanayhdistelmät eli ketjutetut asiasanat

kirjoitetaan ketju kenttään muodossa asiasana : asiasana

jos ketju on jo tallennettu, Saha tuo sen esiin

jos ketjua ei vielä ole, luodaan inline-toiminnolla uusi:

ketju on jo siirtynyt nimi-kenttään (korjataan, jos siinä on virheitä),

sen lisäksi asiasanat poimitaan ontologiasta fasettinsa mukaiseen kenttään.

Näin myös ketjut saadaan kytkettyä ontologiaan.

Kaunokki-ontologia auttaa termien valinnassa: http://www.yso.fi/onki/kauno/

kuvaus

suorasanainen sisältöön liittyvä kuvaus, esim. takakansiteksti, poiminta kritiikistä tai oma kuvaus.

jos teksti poimitaan muualta, mainitaan lähde

add new literal, ks. ohje yllä

sukulaisteokset

kentässä voidaan linkittää teoksia, jotka liittyvät toisiinsa jollakin tavoin

poimitaan Sahaan tallennetuista nimekkeistä

jos nimekettä ei löydy Sahasta, luodaan uusi, ks. uuden annotaation luomiseen liittyvä ohje

lisätietoa muualla verkossa

lisätään harkiten linkki luotettaville ja päivittyville sivustoille

kirjoita linkin nimi kenttään (esim. Arvio Kiiltomadossa), jolloin näytölle tulee create new, valitse inline-vaihtoehto

linkin nimi on siirtynyt nimi-kenttään, lisää verkko-osoite sille varattuun kenttään. Halutessasi voit kirjoittaa linkistä lyhyen kuvauksen kuvaus-kenttään

elokuvat ja muut sovitukset

teoksen pohjalta tehty sovitus (esim. elokuva, tv-sarja, näytelmä, ooppera…)

kirjoita elokuvan nimi kenttään, inline-tilassa lisää linkki lisätietoa sisältävälle sivustolle, esim. imdb, elonet, naytelmat.fi

ei tallenneta sovituksiin liittyvää tietoa, ainoastaan linkki lisätietoa sisältävään palveluun

Projektiryhmä täyttää Palkinnot- ja Arvosteleva kirjaluettelo -kenttiä.

luetteloija

voidaan halutessa luoda oma luetteloijatunnus inline-toiminnolla tai poimia jo tehty luetteloijatunnus

Fyysisen teoksen tiedot saadaan esiin klikkaamalla sen nimeä fyysinen teos -kentässä. Edit-tilassa niitä voidaan tarvittaessa muokata.

Uusi fyysinen teos luodaan kirjoittamalla sen nimi kenttään ja valitsemalla inline-toiminto, jolloin avautuvat fyysisen teoksen tallennuskentät.

Fyysinen teos / fyysisen teoksen osa

nimi

kuvailtavana olevan fyysisen teoksen / osan nimi

add new literal, ks. ohje yllä

muu nimi

alanimekkeet yms.

add new literal, ks. ohje yllä

ensimmäinen julkaisu

kenttä täytetään siinä tapauksessa, että kyseinen fyysinen teos / osa on alkuperäinen julkaisu, ts. sitä ei ole käännetty mistään

poimitaan ”kyllä” pudotusvalikosta

alkuteos

siitä teoksesta, mihin käännös perustuu, tehdään oma fyysinen teos,

täytetään seuraavat kentät:

nimi, ilmestymisvuosi (jos tiedossa), kieli

kieli

kuvailtavana olevan fyysisen teoksen / osan kieli

poimitaan kieliontologiasta

ei voi luoda uutta kieltä

kustantaja

kuvailtavana olevan fyysisen teoksen kustantaja. Osakohteiden kustantajaa ei tallenneta tähän, vaan kokoelman tietojen yhteyteen.

poimitaan Sahaan jo tallennetuista kustantajista tai luodaan uusi kustantajan nimi quick-toiminnolla

jos halutaan tallentaa kustantajaan liittyvää lisätietoa, valitaan inline-toiminto

ilmestymisaika

kyseisen fyysisen teoksen / osan ensimmäisen suomenkielisen painoksen ilmestymisaika, jos tiedossa poimitaan Sahaan jo tallennetuista vuosista tai luodaan uusi vuosiluku quick-toiminnolla

sivumäärä

kyseisen fyysisen teoksen / osan ensimmäisen painoksen sivumäärä, jos tiedossa

add new literal, ks. ohje yllä

sivumäärä numeroina, ei s. tai muita määreitä

kokoelmateos, johon esim. runo tai novelli sisältyy

linkitetään yksittäinen runo, novelli, näytelmä kokoelmaan / kokoelmiin, joista se löytyy painettuna

poimitaan Sahaan tallennetuista nimekkeistä tai luodaan uusi kokoelmateos, ks. uuden annotaation luomiseen liittyvä ohje.

toimittaja

poimitaan Sahaan jo tallennetuista tekijöistä tai luodaan uusi:

kirjoitetaan kenttään kääntäjän nimi muodossa Sukunimi, Etunimi

valitaan inline, täytetään vähintään nämä kentät, jos tiedossa:

sukupuoli, kansallisuus, kieli, syntymä-, kuolinaika, ja -paikka, ammatti

kääntäjä

poimitaan Sahaan jo tallennetuista tekijöistä tai luodaan uusi:

kirjoitetaan kenttään kääntäjän nimi muodossa Sukunimi, Etunimi

valitaan inline, täytetään vähintään nämä kentät, jos tiedossa:

sukupuoli, kansallisuus, kieli, syntymä-, kuolinaika, ja -paikka, ammatti

kuvittaja

poimitaan Sahaan jo tallennetuista tekijöistä tai luodaan uusi:

kirjoitetaan kenttään kääntäjän nimi muodossa Sukunimi, Etunimi

valitaan inline, täytetään vähintään nämä kentät, jos tiedossa:

sukupuoli, kansallisuus, kieli, syntymä-, kuolinaika, ja -paikka, ammatti

julkaisuhistoriaan liittyvä lisätieto

julkaisuhistoriaan, esim. eri painoksiin liittyvää lisätietoa voidaan tallentaa tähän kenttään add new literal, ks. ohje yllä

sarjamerkintä

kenttään kirjoitetaan sarjan nimi ja mahdollinen osanumero esim. MurhaMylly: 28

jos teoksella ei ole osanumeroa, valmiina oleva sarja poimitaan valikosta tai luodaan uusi sarja quick-toiminnolla

sarjan osa tehdään inline-toiminnolla; syntyneeseen annotaatioon lisätään sarjan nimi ja osanumero uudestaan

Uuden teosannotaation luominen

Huom! Aina ennen uuden teoksen tallennusta tarkista, ettei sitä löydy jo Sahasta!

Kirjasampo-Sahasta puuttuu jonkin verran nimekkeitä. Jos nimekettä ei löydy, voidaan uusi abstrakti teos luoda etusivulla siirtämällä kursori sen teostyypin, johon kuvailtava teos kuuluu, oikealle puolelle, jolloin ilmestyy vihreä teksti create new. Avautuvaan tallennuspohjaan viedään uuden teoksen tietoja soveltamalla tätä ohjetta. Myös yksittäisiä novelleista ja runoista tehdään uusi teos tällä tavoin.

Uusi fyysinen teos / osa voidaan luoda inline-tilassa abstraktin teoksen kuvailun yhteydessä tai create new -toiminnolla Kirjasampo-Sahan etusivulla. Monografiat ovat fyysisiä teoksia, osakohteet fyysisen teoksen osia. Näin esim. Romaaneilla, Novellikokoelmilla, Runokokoelmilla on fyysinen teos, Runoilla ja Novelleilla on fyysisen teoksen osia.