Moduuli:Kielilinkki/ohje

Wikisanakirjasta

Tämä on ohjesivu moduulille Moduuli:Kielilinkki

Tässä ohjeessa kuvataan toiminnallisuutta jonka kehitys on vielä kesken. Sivu on tarkoitettu lähinnä kehityksen apuvälineeksi, ei yleiseen käyttöön.

Moduulin avulla voi merkitä tekstiä kielelle määritellyllä tyylillä ja tehdä linkin kielen omaan osioon.

Kielten ja kirjoitusjärjestelmien tyylit määritellään sivulla Järjestelmäviesti:Gadget-Tekstityylit.

Käyttö[muokkaa]

Moduulia käytetään sisältösivuilla seuraavien mallineiden kautta.

  • l: kielen linkkityylillä merkitty linkki kielen omaan osioon,
  • t: kielen tyylillä merkitty teksti (esim. esimerkkilause),
  • tb: kielen lihavointityylillä merkitty teksti (esim. sanarivillä näkyvä teksti taivutusmuotoartikkeleissa),
  • termi: kielen sana kuin siihen viitataan, esim. etymologiaosiossa; kursivointi latinalaisilla, kreikkalaisilla ja kyrillisillä; muilla normaali
  • käännös: käännöslaatikossa näytettävä sana silloin, kun sanasta voi luoda sivun

Lua-moduuleissa kirjasto otetaan käyttöön seuraavasti:

local kielilinkki = require("Moduuli:kielilinkki")

Funktiot[muokkaa]

linkki[muokkaa]

kielilinkki.linkki(kielikoodi, kohdesivu, teksti, lisäparametrit)

Tekee kielen tyylillä muotoillun linkin kielen osioon.

Esimerkkejä:

kielilinkki.linkki("es", "pato")            -- Tulos: <span class="Latn" lang="es">[[pato]]</span>
kielilinkki.linkki("fi", "ankka", "ankan")  -- Tulos: <span class="Latn" lang="fi">[[ankka|ankan]]</span>
kielilinkki.linkki("ar", "بَطَّة", "بطة")      -- Tulos: <span class="Arab" lang="ar">[[بطة|بَطَّة]]</span>

Parametrit voi antaa myös nimettyinä:

kielilinkki.linkki{ kieli = "fi", kohde = "ankka", teksti = "ankan" }  -- Tulos sama kuin yllä.

Nimettyjä parametreja on lisäksi seuraavat:

  • elem: html-elementti johon linkki tulee. Koska wikissä ei voi luoda suoraan a-elementtiä tulee linkki toisen elementin sisään. (Oletus span.)
  • class: html-elementille annettavat class-attribuutit (oletus linkki); jos useita, erotetaan välilyönnillä
  • kuvaus: linkin kohdetta kuvaava teksti joka on samalla myös artikkelipohjan nimi. Malline:artikkelipohja. Tätä voi käyttää sivujen automaattiseen luontiin.
  • kuvaus-param: taulukko, jossa on kuvaukseen littettävät parametrit
kielilinkki.linkki{ kieli = "fi", kohde = "ankka", teksti = "ankan", elem = "b" } -- Tulos: <b class="Latn" lang="fi">[[ankka|ankan]]</b>

Jos kielelle on määritelty automaattinen linkin muuntaja moduulissa Automaattilinkki, voi ensimmäisen parametrin jättää pois:

kielilinkki.linkki{ kieli = "sr", kohde = "ȍko", autolinkki = true }  -- sama kuin kielilinkki.linkki("sr", "oko", "ȍko")
kielilinkki.linkki{ kieli = "ar", kohde = "بَطَّة", autolinkki = true }  -- sama kuin kielilinkki.linkki("ar", "بَطَّة", "بطة").

teksti[muokkaa]

kielilinkki.teksti(kielikoodi, teksti, lisäparametrit)

Tekee kielen tyylillä muotoillun tekstin.

Esimerkkejä:

kielilinkki.teksti("bn", "পাতিহাঁস") -- Tulos: <span class="Beng" lang="bn">পাতিহাঁস</span>
  • elem: html-elementti johon linkki tulee. Koska wikissä ei voi luoda suoraan a-elementtiä tulee linkki toisen elementin sisään. (Oletus span.)
  • class: html-elementille annettavat class-attribuutit (oletus linkki); jos useita, erotetaan välilyönnillä