Moduuli:Kielilinkki/ohje
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ö
muokkaaModuulia 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
muokkaalinkki
muokkaakielilinkki.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
muokkaakielilinkki.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ä