LUE_MINUT

1. Wikin sivu- ja mallinerakenne
 1.1 Käsitesivun mallineet
  1.1.1 Käsite
  1.1.2 Liittyvä nimitys
  1.1.3 Lähikäsite
  1.1.4 Käsitekuva
 1.2 Nimityssivun mallineet

2. Wikin lomakkeet
 2.1 Käsite-lomake
 2.2 Nimitys-lomake
 2.3 Lähde-lomake

3. Skriptit

4. Käännös- ja monikielisyysasiat


::1. Wikin sivu- ja mallinerakenne::

Termipankin rakenne:

*--Käsitesivu--------------------*    *--Nimityssivu----*
|*----------*    *-------------* |    |NIMITYS          |
||KÄSITE    |    |LIITTYVÄ     | |    |Kieli            |
||Määritelmä|    |NIMITYS      |<---->|Sanaluokka       |
||Selite    |    *-------------* |    |...              |
||jne.      |    *-------------* |    *-----------------*
|*----------*    |LÄHIKÄSITE   | |
|                *-------------* |
|                *-------------* |
|                |KÄSITEKUVA   | |
|                *-------------* |
*--------------------------------*

Kaikki tieteenalakohtaiset sivut ovat KÄSITESIVUJA, ne perustuvat Käsite-mallineeseen (määritelty sivulla Malline:Käsite) ja sen mallinekutsu sisältää käsitettä koskevat tiedot, kuten määritelmän, selitteen, lisätiedot, lähteet, kuvatiedostojen nimet jne. Käsite-malline määrittelee koko käsitesivun layoutin. Käsite-mallineen lisäksi käsitesivuilla on Liittyvä nimitys- ja Lähikäsite-mallinekutsuja (määritelty sivuilla Malline:Liittyvä nimitys ja Malline:Lähikäsite). Liittyvä nimitys -mallinekutsuun on tallennettu kaikki sellaiset tiettyä nimitystä koskevat tiedot, jotka liittyvät ao. nimityksen käyttöön nimenomaan suhteessa sivun käsitteeseen sekä riittävät tiedot, joilla se voidaan paikantaa tiettyyn NIMITYSSIVUUN (nimityssivun nimi ja nimityksen kieli). Lähikäsite on yksinkertaisesti linkki johonkin toiseen käsitteeseen, johon on mahdollista liittää jotakin käsitteeseen liittyvää metatietoa (tieto käsitesuhteesta).

NIMITYSSIVUT eivät kuulu millekään tieteenalan aihealueelle, vaan ne sijaitsevat omassa Nimitys-nimiavaruudessaan. Tämä sen vuoksi, että riittää, että nimityskohtaiset kieliopilliset koodaukset tallennetaan vain kerran. Lisäksi kaikille yhteisten nimityssivujen avulla on näppärä seurata sitä, miten samoja nimityksiä käytetään eri käsitteistä eri aihealueilla tai samankin aihealueen sisällä. Nimityssivu koostuu kahdenlaisista mallineista: Nimitityssivu-mallinekutsu ei sisällä mitään talletettua tietoa, vaan se on sivuilla vain huolehtimassa sivun kokonaisasettelusta. Nimitys-mallineet sisältävät kaikki sellaiset nimityskohtaiset tiedot, jotka ovat yhteisiä kaikille sanan käyttötavoille (kieli, sanaluokka jne.).

Kun aineistoja viedään termipankkiin, niiden sisältämät tiedot pitää jaotella oikeisiin mallinekutsuihin, jotka sijoitellaan oikeille sivuilleen. Esimerkiksi seuraavanlaisen termitaulukon tms. aineiston rivi:

* Aihealue   * termi1    * englanti *  määritelmä                                                         *
| Kasvitiede | apoplasti | apoplast | kasvisolukon soluvälien ja seinähuokosten muodostama kokonaisuus... |

jaoteltaisiin mallinekutsuihin seuraavasti:

sivulle Kasvitiede:apoplasti:

{{Käsite
|määritelmä_fi=kasvisolukon soluvälien ja seinähuokosten muodostama kokonaisuus...
}}
{{Liittyvä nimitys
|nimitys=apoplasti
|kieli=suomi
}}
{{Liittyvä nimitys
|nimitys=apoplasti
|kieli=englanti
}}

Sivulle Nimitys:apoplasti

{{Nimityssivu}}
{{Nimitys
|kieli=suomi
}}

Sivulle Nimitys:apoplast

{{Nimityssivu}}
{{Nimitys
|kieli=englanti
}}

Silloin kun sivu viedään wikiin, riittää, että mallinekutsu sisältää vain ne kohdat, joissa on jotain tietoa. Wiki täydentää automaattisesti sellaiset tiedot, jotka ovat välttämättömiä, mutta joille on annettu vakioarvo.

1.1. Käsitesivun mallineet

1.1.1. Käsite-malline

Kokonaisuudessaan käsitemallinekutsu voi näyttää esim. tältä:

{{Käsite
|otsikkohuomautus=
|määritelmä_fi=[[Kasvitiede:kukka|kukan]] [[Kasvitiede:siitoslehti | siitoslehti]], joka tuottaa siemenaiheet
|selite_fi=Yksinäinen emilehti tai emilehtien erillisyys ei ole vallitseva, vaan emikiehkuran yhteenkasvu emiöksi. Emi tai emiö koostuu [[Kasvitiede:sikiäin|sikiäimestä]], [[Kasvitiede:vartalo|vartalosta]] ja [[Kasvitiede:luotti|luotista]].

Vrt. [[Kasvitiede: emiö|emiö]].
|kuvat=
|tieteellinen nimi=
|lähteet=BS2001, FN2004, RK1998, SLT2006
|tarkistettu=Y
|lisätiedot_fi=
|luokka=Kasvimorfologia, Kukkaan liittyvät käsitteet
|ilmiön kuvaus=N
|logotiedosto=
|logolinkki=
|lähdeaineisto=Kasvitiedetesti
|lähdeaineistotunnus=103
|käsite=emi
}}


Mallinekutsun parametrit ovat seuraavat:

	* otsikkohuomautus
	  otsikkohuomautusta käytetään, jos käsitesivun otsikossa on tärkeää jollain tavalla täsmentää, mihin käsitteeseen tai aihepiiriin sivu liittyy, mikäli tiedetään, 		  että sivun otsikko sellaisenaan saattaisi aiheuttaa sekaannusta
	* määritelmä_fi
	  tekstikenttä, johon suomenkielinen määritelmä tallennetaan. _fi on kielikoodi. Ks. monikielisyysasiat.
	* selite_fi
	  tekstikenttä, johon suomenkielinen selite tallennetaan. _fi on kielikoodi. Ks. monikielisyysasiat.
	* kuvat
	  vanhentunut kenttä sivulla näytettäville kuville. Tarkoitus poistaa kokonaan käytöstä, kun kaikki olemassaolevat sisällöt wikissä on saatu päivitettyä käyttämään 		  uutta järjestelmää.
	* tieteellinen nimi
	  joillain, erityisesti biotieteellisillä aloilla käsite voidaan täsmentää tieteellisen nimen avulla.
	* lähteet
	  kenttä lähdeluetteloa varten. Käsitemalline jakaa tiedot listaksi käyttäen erottimena pilkkua.
	* tarkistettu
	  voi saada arvot Y tai N. Mikäli arvo on N, Käsite-malline kirjoittaa sivun ylälaitaan tekstin "Tämä sivu on vielä tarkistamatta".
	* lisätiedot_fi
	  tekstikenttä, johon suomenkieliset lisätiedot tallennetaan. _fi on kielikoodi. Ks. monikielisyysasiat.
	* luokka
	  Käsite-malline purkaa kentän pilkuilla erotetun listan ja sijoittaa sivun näihin luokkiin.
	* ilmiön kuvaus
	  voi saada arvot Y tai N. Mikäli arvo on Y, Käsite-malline avaa käsitesivulle linkin, josta pääsee muokkaamaan erillistä Ilmiön kuvaus -alisivua, joka on tarkoitettu 		  laajempien tekstikokonaisuuksien esittämiseen.
	* logotiedosto
	  joillakin käsitesivuilla on näkyvissä yhteistyökumppanin banneri. Kuva on talletettu wikiin, ja Käsite-malline asettaa sen paikalleen tämän tiedon perusteella.
	* logolinkki
	  mikäli yllä mainitun bannerin halutaan johtavan ulkopuoliselle sivustolle, sen osoite annetaan tässä.
	* lähdeaineisto
          vientiskripti kirjoittaa viennistä metahuomautuksen tähän kenttään. Käsite-malline ei tee tiedolla mitään, mutta se näkyy sivun lähdetekstissä.
	* lähdeaineistotunnus
	  joskus lähdeaineistoissa on täsmennetty jokainen käsite yksilöivällä tunnuksella ja se halutaan säilyttää myös wikissä. Tätäkään tietoa ei näytetä sivulla.

Käsitemalline sisältää omia mallinekutsuja, jotka uudelleen käyttävät käsitemallineen kutsun (tai muiden sivulle tallennettujen mallinekutsujen). Näitä ovat:

Käsite/otsikko

Malline hakee sivulle tallennetuista Liittyvä nimitys -SIO:ista ne, joiden kieli vastaa sivun nimiavaruuden nimiselle sivulle tallennettua Otsikkokieli-ominaisuutta ja pistää ne eteenpäin mallineeseen Käsite/otsikko/malli joka kokoaa varsinaisen otsikon. Mikäli ehtojen mukaisia SIO:ita ei löydy, otsikon tilalle tulee tekstin "tällä sivulla ei ole otsikon muodostavia nimityksiä".

Muotoiltu vastine
Malline muotoilee haetuista Liittyvä nimitys -SIO:ista termivastine listan, joka sijoittuu otsikon alapuolelle

Muotoiltu käännösvastine
Malline muotoilee haetuista Liittyvä nimitys -SIO:ista termivastine listan, joka sijoittuu vieraskieliset vastineet listaan

Muotoiltu käännösvastine/alku
Pelkkä <table>-tägi avaamaan taulukkomuotoisen vastinelistan.

Muotoiltu käännösvastine/loppu
Pelkkä </table>-tägi lopettamaan taulukkomuotoisen vastinelistan.

Lähikäsitelista
Malline, joka muotoilee haetuista Lähikäsite- SIO:ista listan

Muotoiltu kuva
Malline, joka muotoilee haetuista Käsitekuva- SIO:ista listan

1.1.2. Liittyvä nimitys

1.1.3. Lähikäsite

1.1.4. Käsitekuva





::Skriptit::

Termbank-laajennos sisältää seuraavat komentoriviltä ajettavat skriptit:

importPages.php

Pääasiallinen sivujen wikiin viemiseksi käytetty skripti. Sivun viedään tab-erotettuna taulukkona, jonka ensimmäisessä sarakkeessa on nimiavaruus, toisessa sivun nimi, ja kolmannessa koko sivulle tuleva sisältö. Tätä voi käyttää niin käsite- kuin nimityssivujen viemiseen.

Skriptillä on seuraavat optiot:

--checked
y/n
Säätää sen, tuleeko sivuille "Tämä sivu on vielä tarkistamatta" -teksti. Lisää sivun sisältöön, käsitesivun mallinekutsuun kohdan "|tarkistettu=n". Nimityssivuihin tällä ei ole vaikutusta.

--overwrite
y/n
Säätää sen, kirjoittaako ohjelma jo olemassaolevien sivujen päälle vai ei.

--extend
y/n
Mikäli overwrite on säädetty y:ksi, tällä voi valita sen, kirjoitetaanko vain niiden sivujen päälle, joiden jo olemassaoleva sisältö on merkkimääräisesti pienempi kuin päälle tuotava. Näppärä erityisesti nimityssivuihin.

--filecode
string
tiedosto, joka sisältää vietävän tsv-taulukon.

--source
string
aineiston/tuonnin alkuperää koskeva huomautus. Tallentuu wikisivulle. Ihan näppärä jos joskus tulevaisuudessa joutuu ihmettelemään, että miksi joillain sivuilla on tiettyä materiaalia.


importNotes.php
Skripti keltaisten laatikoiden viemiseksi.


import.php

Vanhempi sivujen wikiin viemiseksi käytetty skripti. Syö kolme erillistä csv-taulukkoa, joista kokoaa käsite- ja nimityssivut.