Ohje:Malline
- Artikkelit elävistä henkilöistä
- Kieltenväliset linkit
- Luettelo
- Luokittelu
- Nimeämiskäytäntö
- Ohjaus
- Merkitse lähteet
- Tarkistettavuus
- Ei uutta tutkimusta
- Kunnianloukkaus
- Loukkaava sisältö
- Merkittävyys
- Mitä Wikipedia ei ole
- Tekijänoikeudet
- Tiedostojen käyttösäännöt
- Vandalismi
- Allekirjoitus
- Ei avoimia välityspalvelimia
- Keskustelusivu
- Käyttäjälaatikko
- Käyttäjäsivu
- Käyttäjätunnus
- Monta käyttäjätunnusta
- Älä palvo sääntöjä
- Aiheesta muualla
- Antiikin terminologia
- Arabian kielen transkribointi
- Artikkelin nimi
- Artikkelin rakenne
- Itä-Aasiaa käsittelevät artikkelit
- Juonipaljastukset
- Kerro kuka tekee
- Kielioppi
- Kreikan kielen translitterointi
- Kuvitteellisesta aiheesta kirjoittaminen
- Linkit
- Merkitsemiskäytännöt
- Slaavilaisten kielten translitterointi
- Välimerkit ja typografia
- Värit
- Ylisanat
- Uuden artikkelin luominen
- Artikkelin nimi
- Kuinka sivuja muokataan
- Artikkelien kääntäminen
- Kielimallien käytöstä
- Haku
- Kuvien lisääminen
- Taulukot
- Aikajanojen luominen
- Artikkelien yhdistäminen
- Kaavat
- Koodiopas
- Kuvien lisääminen
- Kuvien siirtäminen Commonsiin
- Kuvien tiedostokoon pienentäminen
- Lua
- Malline
- Nuottikirjoitus
- Omat tyylit
- Palautus
- Sisällysluettelo
- Sivun siirtäminen
- Substaus
- Taulukot
- Tiedostojen tallentaminen
- Wikidata
- Ääni ja video
- Kolme perussääntöä
- Käytä maalaisjärkeä
- Lähde- ja tekstikritiikin käyttö Wikipediasta lainattaessa
- Miksi Wikipedia ei ole upea
- Miksi Wikipedia on niin upea
- Opettajalle
- Kierre
- Lumipallo helvetissä
- Uskalla pyytää anteeksi
- Viileänä pysyminen muokkaamisen käydessä kuumana
- Vältä henkilökohtaisuuksia
- Wikipedia on julma paikka
- Wikirakkaus
- Wikiviha
- Älä huomauta vakiokäyttäjiä
mallineilla
- Artikkelin elinkaari
- Kaikelle on oltava lähteet
- Lähteet ja viitteet
- Miten lähteet toimivat
- Poliitikot
- Päivänkohtaisuus
- Wikipedia ei ole paperia
- Konekääntäminen
- Perusteluita, joita tulisi välttää poistoäänestyksessä
- Päivässä keksityt asiat eivät kuulu Wikipediaan
- Sanakirjamääritelmä
- Äänestäminen kaikesta ei kannata
- Äänestäminen on pahasta
Wikipedian mallineet (engl. template) ovat sivuja, joiden avulla saman sisällön voi esittää useammalla sivulla. Mallineeseen tehdyt muokkaukset näkyvät kaikilla niillä sivuilla, joihin malline on asetettu. Esimerkiksi oheinen Wikipedian ohjekirja on navigaatiomalline, joka on avuksi samaan kokonaisuuteen kuuluvia sivuja selattaessa. Malline on sijoitettu sivulle tekstinpätkällä {{WPManuaalipystynavi}}. Monet mallineet myös laittavat artikkelin automaattisesti tiettyyn ylläpitoluokkaan (ks. luokittelukäytäntö aiheesta). Mallineen suurin hyöty saavutetaan silloin, kun sama asia tulisi toistaa samalla tavalla useilla eri sivuilla.
Tässä ohjeessa käydään yksityiskohtaisesti läpi kuinka mallineita voidaan liittää artikkeleihin, kuinka luoda mallineita sekä lopuksi kuinka mallineeseen saadaan toiminnallisuutta. Sivulla Wikiprojekti:Mallineet/Linjaukset on lisää ohjeita mallineiden luontiin liittyen. Olemassa olevia mallineita voi selata sivulla Luokka:Mallineet tai Wikipedia:Malline.
Mallineen liittäminen
[muokkaa | muokkaa wikitekstiä]Malline voi sijaita kahdessa eri nimiavaruudessa. Yleisimmin mallineen tunnistaa etuliitteestä Malline: nimessä, mutta myös artikkelin alasivu voi toimia mallineena.
Malline-nimiavaruudessa olevan mallineen liittäminen osaksi artikkelia
[muokkaa | muokkaa wikitekstiä]Yksinkertaisimmillaan malline voidaan liittää artikkeliin kirjoittamalla mallineen nimi (ilman nimiavaruusosaa Malline:) kaksinkertaisten aaltosulkeiden sisälle:
{{Mallineen nimi}}
Tällaisissa tapauksissa malline on niin kutsuttu listaava tai luetteloiva malline ilman sen kummempaa toiminnallisuutta, tai rakennettu siten että malline toimii yleisimmissä tapauksissa ilman parametreja.
Kun malline vaatii parametreja eli arvoja jotka määrittävät mallineen sisältöä, lisätään ne mallineen nimen perään pystyviivalla eroteltuna:
{{Mallineen nimi | 1 | 2 | 3}} {{Mallineen nimi | parametri2 = 2 | parametri1 = 1 | parametri3 = 3}} {{Mallineen nimi | 1 | 2 | parametri4 = 4}}
- Ensimmäisessä tapauksessa malline vastaanottaa parametreja tietyssä järjestyksessä, eikä parametria tule eikä pidä nimetä.
- Toisessa tapauksessa mallineen parametrit on nimetty, ja nimet tulee liittää osaksi mallinekutsua. Tällöin parametrien järjestyksellä ei ole väliä, vaan MediaWiki järjestelee parametrit nimen perusteella oikein
- Kolmannessa tapauksessa mallineella on sekä tietyssä järjestyksessä käsiteltäviä parametreja, että nimettyjä parametreja. Tällöin järjestyksessä käsiteltävien parametrien tulee sijaita oikeassa kohdassa, mutta nimetyt parametrit voivat olla halutussa järjestyksessä mallinekutsun lopussa.
Alasivun liittäminen osaksi artikkelia tai artikkelin toista alasivua
[muokkaa | muokkaa wikitekstiä]Myös artikkelin alasivu voi toimia mallineena, mutta vain itse artikkelille ja artikkelin muille alasivuille. Tämän tyylistä ratkaisua suositaan useasti muun muassa Wikipedian äänestyssivuilla, teemasivuilla sekä joissakin wikiprojekteissa.
Alasivun kutsuminen artikkelissa tapahtuu muuten samoin kuin mallinekutsu, mutta mukaan täytyy liittää vinoviiva nimen eteen:
{{/Alasivu}}
Artikkelin alasivun kutsuminen toisella alasivulla taas tapahtuu liittämällä nimen eteen ../ :
{{../Alasivu}}
Myös alasivut osaa käsitellä parametreja samalla tavalla kuin mallineet, pystyviivalla eroteltuna:
{{/Alasivu|1|2|3}} {{/Alasivu|parametri2=2|parametri1=1|parametri3=3}} {{/Alasivu|1|2|parametri4=4}}
Tarvittaessa sivulle voidaan liittää myös toinen artikkeli:
{{:Toinen artikkeli}}
Tätä tulee kuitenkin välttää, sillä hyvin harvoin tämä on tarpeellista. Lisäksi sen käyttö voi hallitsemattomasti paisuttaa artikkelin kokoa, jos sisällytettäväkin artikkeli laajenee.
Osion sisällyttäminen
[muokkaa | muokkaa wikitekstiä]Myös sivun tietyn osion sisällyttäminen on mahdollista.
Seuraavat sisällyttävät sivun osion, joka on sijoitettu tagien <section begin=nimike />
ja <section end=nimike />
väliin:
{{#section:sivun nimi|nimike}}
tai
{{#lst:sivun nimi|nimike}}
Seuraavat sisällyttävät sivulta kaiken muun paitsi tagien <section begin=nimike />
ja <section end=nimike />
väliin sijoitetun osion:
{{#section-x:sivun nimi|nimike}}
tai
{{#lstx:sivun nimi|nimike}}
Seuraavat sisällyttävät sivun osion ilman tageja:
{{#section-h:sivun nimi|otsikko}}
tai
{{#lsth:sivun nimi|otsikko}}
Esim. {{#section-h:Suomi|Historia}}
sisällyttää Suomi-artikkelin Historia-osion alaosioineen.
Huono puoli tässä tavassa on se, että jos alkuperäsivun osion otsikon nimi myöhemmin muuttuu, niin osio ei enää tulostu kohdesivulle. Siksi on suositeltavaa käyttää tageja ja {{#section}}
:ia.
Osion sisällyttämisen huonoja puolia:
- Jos sisällytettävä osio sisältää nimettyjä viitteitä, joita ei ole sisällytettävässä osiossa määritetty, nämä nimetyt viitteet aiheuttavat viittausvirheitä kohdeartikkelissa.
- Alkuperäsivun osion muokkaukset eivät näy sisällytettävän osion sisältävän artikkelin muokkaushistoriassa eikä tarkkailulistan muutoksena.
Lisätietoa osion sisällyttämisestä löytyy englanniksi MediaWikistä.
Mallineen luonti
[muokkaa | muokkaa wikitekstiä]Ennen mallineen luomista on hyvä tarkastaa mallineluokan avulla, ettei kukaan ole jo luonut vastaavanlaista mallinetta, jota tarvitsisit artikkelissa. Osa mallineista saattaa olla myös luokittelemattomia mallineita, joten hyvä paikka tarkastaa mallineen olemassaolo on myös vastaavanlainen artikkeli. Mikäli tarvittava malline löytyy mutta ei täysin täytä tarvettasi, voit huoletta muokata mallinetta sopivaksi, tai mikäli haluat, voit myös esittää toiveen mallineprojektin sivulla.
Mikäli tarvitsemaasi mallinetta ei löydy, tulee miettiä:
- Tullaanko sama / samankaltainen tieto toistamaan useilla sivuilla
- Mikäli ei, tulisi mallineen sijasta rakentaa tieto suoraan artikkeliin
- Looginen nimi mallineelle
- Mallineen vakiosijainti artikkelissa (ylhäällä oikealla, alhaalla keskellä, jossain muualla)
- Mallineen toiminta mikäli kyseessä on muu kuin listaava / luetteloiva malline
Kun nämä kohdat on selvillä, voit aloittaa mallineen luonnin kirjoittamalla esimerkiksi vasemmalle hakuun Malline:Mallineen nimi tai halutessasi jättää mallineen luontipyynnön.
Toiminnallisuuden lisääminen mallineeseen
[muokkaa | muokkaa wikitekstiä]Mallineisiin voidaan lisätä toiminnallisuutta parametreilla ja funktioilla.
Parametrit
[muokkaa | muokkaa wikitekstiä]Parametrit ovat eräänlaisia muuttujia, jotka vastaanottavat mallinekutsussa (katso yllä) mallineelle erilaisia arvoja. Parametrit suljetaan mallineen sisällä kolminkertaisiin aaltosulkeisiin ( {{{ ja }}} ) ja ne voidaan asettaa minne tahansa tavallisen mallinesisällön sisään.
Esimerkki:
Malline parametrilla jonka arvo on {{{1}}}
Esimerkki tulostaisi kohtaan {{{1}}} mallineelle ensiksi määritellyn parametrin. Mikäli aaltosulkeiden sisällä olisi numeron sijasta tekstiä, esimerkiksi {{{parametri}}}, pitäisi mallinetta kutsuessa määritellä parametri = arvo.
Parametrien ketjuttaminen
[muokkaa | muokkaa wikitekstiä]Välillä mallinetta luodessa tulee ajatusvirheitä parametrien nimissä, tai tarvitaan tulostaa tietty asia kun yksi parametri kahdesta (tai useammasta parametrista) on määritelty. Näissä tapauksissa parametreja voidaan ketjuttaa:
{{{param|{{{parametri}}}}}}
Yllä mainitussa esimerkissä tulostettaisiin parametrin param arvo, tai jos sitä ei olisi määritelty, tulostettaisiin parametrin parametri arvo. Tällä keinolla laajasti käytössä olevan mallineen parametrien nimiä voidaan muuttaa ilman että mallinetta käyttävät sivut häiriintyy muutoksesta, ja saadaan aikaa päivittää mallinetta käyttävät sivut käyttämään uusia parametreja.
Parametreja voidaan käytännössä ketjuttaa kuinka monta tahansa lisäämällä aina pystypalkki ja uusi parametri yllä olevan esimerkin mukaisesti parametrin nimen tai numeron perään.
Parametrin ehdollistaminen ja oletusarvon käyttö
[muokkaa | muokkaa wikitekstiä]Parametri voidaan tarvittaessa ehdollistaa käyttämällä parametrien ketjuttamisessa kuvattua tapaa, mutta sen sijaan että määriteltäisiin uusi parametri, voidaan määritellä tyhjä (eli ehdollistaa) tai oletusarvo:
{{{1|ei arvoa}}} {{{2|}}}
Yllä oleva esimerkki tulostaisi ensimmäisen parametrin arvon tai ei arvoa ja lisäisi tulosteen perään toisen parametrin arvon mikäli se olisi määritelty.
MediaWikin avainsanat
[muokkaa | muokkaa wikitekstiä]Sisällysluettelon avainsanat
[muokkaa | muokkaa wikitekstiä]- Pääartikkeli: Wikipedia:Sisällysluettelo
Avainsana | Selite |
---|---|
__NOTOC__ | Piilottaa sisällysluettelon sivulta. |
__FORCETOC__ | Pakottaa sisällysluettelon esiin |
__TOC__ | Sijoittaa sisällysluettelon valittuun paikkaan (välittämättä avainsanasta __NOTOC__). |
Muut avainsanat
[muokkaa | muokkaa wikitekstiä]Avainsana | Selite |
---|---|
__NOEDITSECTION__ | Piilottaa sivulta [muokkaa] -linkit otsikkotasojen vierestä. |
__NEWSECTIONLINK__ | Lisää ei-keskustelusivulle + välilehden, jonka avulla voi lisätä uuden osa-alueen sivulle. |
__NOCONTENTCONVERT__ __NOCC__ |
Estää sisällön maakohtaisen muuntamisen artikkeleita tarkasteltaessa. |
__NOGALLERY__ | Näyttää kuvaluokissa kuvat tekstimuotoisena, ei galleriana. |
__NOTITLECONVERT__ __NOTC__ |
Kuten __NOCC__ mutta vaikuttaa vain artikkelin otsikkoon. |
__HIDDENCAT__ | Luokittelee sivun, muttei näytä luokkaa itse sivulla. Käytetään luokan alla. |
Taikasanat
[muokkaa | muokkaa wikitekstiä]Aika
[muokkaa | muokkaa wikitekstiä]Muuttuja | Tulos | Selitys |
---|---|---|
{{CURRENTMONTH}} | 08 | Meneillään oleva kuukausi kahdella numerolla |
{{CURRENTMONTHNAME}} | elokuu | Meneillään olevan kuukauden nimi |
{{CURRENTMONTHNAMEGEN}} | elokuun | Meneillään olevan kuukauden nimi genetiivissä |
{{CURRENTMONTHABBREV}} | elokuu | |
{{CURRENTDAY}} | 26 | |
{{CURRENTDAY2}} | 26 | Meneillään oleva päivä kahdella numerolla |
{{CURRENTDOW}} | 1 | |
{{CURRENTDAYNAME}} | maanantai | |
{{CURRENTWEEK}} | 35 | |
{{CURRENTYEAR}} | 2024 | |
{{CURRENTTIME}} | 17.35 | |
{{CURRENTTIMESTAMP}} | 20240826173528 |
Paikallinen aika
[muokkaa | muokkaa wikitekstiä]Muuttuja | Tulos | Selitys |
---|---|---|
{{LOCALDAY}} | 26 | |
{{LOCALDAY2}} | 26 | |
{{LOCALDAYNAME}} | maanantai | |
{{LOCALDOW}} | 1 | |
{{LOCALMONTH}} | 08 | |
{{LOCALMONTHABBREV}} | elokuu | |
{{LOCALMONTHNAME}} | elokuu | |
{{LOCALTIME}} | 20.35 | |
{{LOCALHOUR}} | 20 | |
{{LOCALWEEK}} | 35 | |
{{LOCALYEAR}} | 2024 | |
{{LOCALTIMESTAMP}} | 20240826203528 |
Lisäksi suomenkielisessä Wikipediassa on malline {{LOCALTIMEZONE}} aikavyöhykkeen esittämiseksi. Tämä avainsana ei kuitenkaan kuulu MediaWikin omiin avainsanoihin.
Tilastot
[muokkaa | muokkaa wikitekstiä]Muuttuja | Tulos | Selitys |
---|---|---|
{{CURRENTVERSION}} | 1.43.0-wmf.19 (a8c8877) | |
{{NUMBEROFEDITS}} {{NUMBEROFEDITS:R}} |
22 541 641 22541641 |
|
{{NUMBEROFARTICLES}} {{NUMBEROFARTICLES:R}} |
579 081579081
|
|
{{NUMBEROFPAGES}} {{NUMBEROFPAGES:R}} |
1 504 916 1504916 |
|
{{NUMBEROFFILES}} {{NUMBEROFFILES:R}} |
77 112 77112 |
|
{{NUMBEROFUSERS}} {{NUMBEROFUSERS:R}} |
582 993 582993 |
|
{{NUMBEROFADMINS}} {{NUMBEROFADMINS:R}} |
34 34 |
|
{{PAGESINNAMESPACE}} | ei käytössä | |
{{PAGESINNS:ns}} {{PAGESINNS:ns:R}} |
{{PAGESINNS:2}} {{PAGESINNS:2:R}} ei käytössä |
|
{{PAGESINCATEGORY:Luokka}} {{PAGESINCAT:Luokka}} |
{{PAGESINCATEGORY:Wikipedian ylläpito}} 83 |
Sivun nimi ja siihen liittyvä tieto
[muokkaa | muokkaa wikitekstiä]Muuttuja | Tulos | Selitys |
---|---|---|
{{PAGENAME}} | Malline | Sivun nimi ilman nimiavaruutta |
{{PAGENAMEE}} | Malline | |
{{SUBPAGENAME}} {{SUBPAGENAMEE}} |
Malline Malline |
|
{{BASEPAGENAME}} {{BASEPAGENAMEE}} |
Malline Malline |
|
{{NAMESPACE}} {{NAMESPACEE}} |
Ohje Ohje |
Sivun nimiavaruus |
{{FULLPAGENAME}} {{FULLPAGENAMEE}} |
Ohje:Malline Ohje:Malline |
Sivun nimiavaruus ja nimi |
{{TALKSPACE}} {{TALKSPACEE}} |
Keskustelu ohjeesta Keskustelu_ohjeesta |
|
{{SUBJECTSPACE}} {{SUBJECTSPACEE}} |
Ohje Ohje |
|
{{ARTICLESPACE}} {{ARTICLESPACEE}} |
Ohje Ohje |
|
{{TALKPAGENAME}} {{TALKPAGENAMEE}} |
Keskustelu ohjeesta:Malline Keskustelu_ohjeesta:Malline |
|
{{SUBJECTPAGENAME}} {{SUBJECTPAGENAMEE}} |
Ohje:Malline Ohje:Malline |
|
{{ARTICLEPAGENAME}} {{ARTICLEPAGENAMEE}} |
Ohje:Malline Ohje:Malline |
|
{{REVISIONID}} | - | |
{{REVISIONDAY}} | 15 | |
{{REVISIONDAY2}} | 15 | |
{{REVISIONMONTH}} | 07 | |
{{REVISIONYEAR}} | 2024 | |
{{REVISIONTIMESTAMP}} | 20240715200846 | |
{{SITENAME}} | Wikipedia | |
{{SERVER}} | //fi.wikipedia.org | |
{{SCRIPTPATH}} | /w | |
{{SERVERNAME}} | fi.wikipedia.org |
MediaWikin funktiot
[muokkaa | muokkaa wikitekstiä]Nimiavaruus ja osoitteet
[muokkaa | muokkaa wikitekstiä]Funktio | Tulos | Selitys |
---|---|---|
{{ns:}} | {{ns:4}} = Wikipedia {{ns:project}} = Wikipedia |
Hakee tietyn numeroisen nimiavaruuden nimen |
{{localurl:x y @}} {{localurle:x y @}} {{localurl:a|b=c}} {{localurl:Wikipedia:Luokittelu}} |
/wiki/X_y_@ /wiki/X_y_@ /w/index.php?title=A&b=c /wiki/Wikipedia:Luokittelu |
selvennä |
{{urlencode:x y @}} | x+y+%40 | selvennä |
{{anchorencode:x #y @}} | x_#y_@ | selvennä |
{{fullurl:x y @}} {{fullurle:x y @}} {{fullurl:m:a|b=c}} |
//fi.wikipedia.org/wiki/X_y_@ //fi.wikipedia.org/wiki/X_y_@ https://meta.wikimedia.org/wiki/a?b=c |
selvennä |
Muotoilu
[muokkaa | muokkaa wikitekstiä]Funktio | Tulos | Selitys |
---|---|---|
{{#language:}} | {{#language:da}} = dansk | Tulostaa kielikoodin kielen omankielisen nimen (suomi, English, 日本語...) |
{{lc:}} | {{lc:AbC dEf}} = abc def | Muuttaa merkkijonon kaikki kirjaimet pieniksi |
{{lcfirst:}} | {{lcfirst:Ab Cd}} = ab Cd | Muuttaa merkkijonon mahdollisen ensimmäisen kirjaimen pieneksi |
{{uc:}} | {{uc:aBc DeF}} = ABC DEF | Muuttaa merkkijonon kaikki kirjaimet isoiksi |
{{ucfirst:}} | {{ucfirst:aB cD}} = AB cD | Muuttaa merkkijonon mahdollisen ensimmäisen kirjaimen isoksi |
{{formatnum:}} | {{formatnum:-299792458.56789}} = −299 792 458,56789 | Muuttaa numerojonon desimaalipilkulliseen muotoon, jossa tuhaterottimena on välilyönti |
{{padleft:}} {{padright:}} |
{{padleft:7|3|0}} = 007 |
Täyttää annetun merkkijonon (ensimmäinen parametri) vasemman puolen (padleft) tai oikean puolen (padright) määritetyn pituiseksi (toinen parametri) määritellyllä merkillä (kolmas parametri) |
Mallinefunktiot
[muokkaa | muokkaa wikitekstiä]Funktio | Esimerkki | Selite |
---|---|---|
{{:Xyz}} | {{:Kissa}} | Hakee annetun artikkelin sisällön sivulle, ei ole varsinainen mallinefunktio. |
{{int:xyz}} | Lyhyempi versio {{MediaWiki:xyz}}, joka tulostaa ⧼xyz⧽ jos MediaWiki:xyz ei löydy.selvennä | |
{{msg:xyz}} | {{msg:NAMESPACE}} | Vaikka avainsana xyz olisi olemassa, on mahdollista käyttää sen nimistä mallinetta mutta mallinekutsu tulee tehdä mainitusti. Mahdollistaa avainsanojen nimellä toimivien mallineiden luonnin ilman ristiriitaisuuksia. |
{{msgnw:xyz}} | Tulostaa mallineen koodin samalla tavalla kuin <nowiki>...</nowiki> sisällä. | |
{{raw:xyz}} | Sama kuin {{msg:xyz}}. | |
{{subst:xyz}} | Tekee mallineesta sivulle vastineen, katso #subst. |
Muut
[muokkaa | muokkaa wikitekstiä]Funktio | Esimerkki | Selite |
---|---|---|
{{DISPLAYTITLE:xyz}} | oletuksena pois päältä | Asettaa sivun otsikon eriäväksi sivun nimen kanssa, katso http://svn.wikimedia.org/viewvc/mediawiki?view=rev&revision=13572 . |
{{DIRMARK}} {{DIRECTIONMARK}} |
|
u+200E vasemmalta oikealle tai u+200D oikealta vasemmalleselvennä |
{{CONTENTLANGUAGE}} | fi | Sisällön kielen koodi |
{{AAKKOSTUS:xyz}} {{DEFAULTSORT:xyz}} |
{{AAKKOSTUS:xyz}} | Asettaa oletuslajittelunimen sivulle luokittelua varten. Käytetään esimerkiksi henkilöiden lajitteluun sukunimen perusteella, {{AAKKOSTUS:Suku, Etu}}. |
{{!}} | Tulostaa |-merkin. Käytetään esimerkiksi kun halutaan sisällyttää taulukkokoodia parserifunktion sisään. |
Funktiot
[muokkaa | muokkaa wikitekstiä]Wikipediassa on käytössä ParserFunctions -laajennus, joka tukee seuraavia funktioita:
#expr:
[muokkaa | muokkaa wikitekstiä]{{#expr: lauseke }}
expr laskee matemaattisia lausekkeita, ja tukee seuraavia matemaattisia ja loogisia operaattoreita: (), +, -, not, *, /, div, mod, round, =, <>, !=, <, >, <=, >=, and ja or.
Esimerkki:
{{#expr: 6 + (2 * 4) }}
Lisätietoja mw:Help:Extension:ParserFunctions#.23expr
#if:
[muokkaa | muokkaa wikitekstiä]{{#if: ehto | teksti | muuten teksti }} {{#if: ehto | teksti }}
if on looginen ehtolause, joka tulostaa tietyn tekstin mikäli parametri ei ole tyhjä (eli parametri on määritelty ja parametri sisältää muutakin kuin tulostumattomia merkkejä) ja tarvittaessa kun ehto ei täyty, toisen tekstin.
Esimerkki:
{{#if: {{{parametri|}}} | parametri määritelty | parametria ei määritelty }}
Tavallisesti parametrit ketjutetaan muodossa {{{parametri|{{{parametri2|{{{parametri3}}}}}}}}}, mutta tätä tyyliä ei tulisi käyttää ehtolauseissa. Kun ehtolauseen halutaan toteutuvan kun vähintään yksi tietyistä parametreista on asetettu erisuureksi kuin tyhjä, tulee käyttää muotoa
{{#if: {{{parametri|}}}{{{parametri2|}}}{{{parametri3|}}} | jokin kolmesta parametrista erisuuri kuin tyhjä }}
Lisätietoja mw:Help:Extension:ParserFunctions#.23if
#ifeq:
[muokkaa | muokkaa wikitekstiä]{{#ifeq: teksti1 | teksti2 | kun yhtäsuuret | muuten }}
ifeq on looginen ehtolause, joka tulostaa tietyn tekstin mikäli vertailtavat tekstit ovat samat tai kun ehto ei täyty, toisen tekstin.
Esimerkki:
{{#ifeq: {{{parametri|}}} | tulosta | parametri oli tulosta | parametri ei ollut tulosta }}
Lisätietoja mw:Help:Extension:ParserFunctions#.23ifeq
#ifexist:
[muokkaa | muokkaa wikitekstiä]{{#ifexist: artikkeli | artikkeli löytyi | artikkelia ei löytynyt }}
ifexist on looginen ehtolause, joka tulostaa tietyn tekstin mikäli artikkeli löytyy tai kun artikkelia ei löydy, toisen tekstin.
Esimerkki:
{{#ifexist: Artikkeli | Artikkeli löytyi | Artikkelia ei löytynyt }}
Lisätietoja mw:Help:Extension:ParserFunctions#.23ifexist
#ifexpr:
[muokkaa | muokkaa wikitekstiä]{{#ifexpr: ehto | ehto tosi | ehto epätosi }}
ifexpr on looginen ehtolause, joka tulostaa tietyn tekstin mikäli määritelty ehto on tosi tai ehdon ollessa epätosi, toisen tekstin.
Esimerkki:
{{#ifexpr: {{{parametri}}}=1 | parametri oli yksi | parametri ei ollut yksi }}
Lisätietoja mw:Help:Extension:ParserFunctions#.23ifexpr. HUOM: Funktiolla on muutama erikoiskäyttäytyminen, kannattaa katsoa Metan sivu näiden välttämiseksi.
#switch:
[muokkaa | muokkaa wikitekstiä]{{#switch: vertailuehto | arvo1 = tulos1 | arvo2 = tulos2 | ... | arvon = tulosn | oletustulos }}
switch on looginen ehtolause, joka tulostaa tietyn tekstin mikäli määritelty vertailuehto täsmää lueteltuihin arvoihin tai kun täsmäävyyttä ei löydy, oletustuloksen.
Esimerkki:
{{#switch: {{{parametri}}} | 1 = yksi | 2 = kaksi | 100 = sata | Arvo ei ollut yksi, kaksi tai sata }}
Lisätietoja mw:Help:Extension:ParserFunctions#.23switch.
#time:
[muokkaa | muokkaa wikitekstiä]{{#time: muoto }} {{#time: muoto | aika}}
time on ajan muotoilemiseen käytetty funktio, joka osaa muotoilla nykyisen ajan halutun laiseksi, tai mikäli aika on määritelty, myös muut ajat.
Esimerkki:
{{#time: j.n.Y H.i.s | -1 year }}
Lisätietoja mw:Help:Extension:ParserFunctions#.23time. HUOM: Funktion sisällä voi tulostaa myös varattuja merkkejä käyttämällä \ -merkkiä varatun merkin edessä (esimerkiksi \H). Metan sivulla on tarkka luettelo miten aikaa voi muotoilla ja missä muodossa ajan voi funktiolle syöttää.
#rel2abs:
[muokkaa | muokkaa wikitekstiä]{{#rel2abs: polku }} {{#rel2abs: polku | pohjapolku }}
rel2abs muuntaa määritetyn polun relatiivisesta polusta absoluuttiseksi poluksi käyttäen tarvittaessa pohjapolkua lähtökohtana.
Esimerkki:
{{#rel2abs: ../Alasivu1 }} palauttaisi Alasivu1 {{#rel2abs: ../Alasivu1 | Ohje:Mallineet/Alasivu2 }} palauttaisi Ohje:Mallineet/Alasivu1
Lisätietoja mw:Help:Extension:ParserFunctions#.23rel2abs
#titleparts:
[muokkaa | muokkaa wikitekstiä]Lisätietoja mw:Help:Extension:ParserFunctions#.23titleparts
#iferror:
[muokkaa | muokkaa wikitekstiä]Lisätietoja mw:Help:Extension:ParserFunctions#.23iferror
Funktioiden soveltaminen
[muokkaa | muokkaa wikitekstiä]Taulukon rivin ehdollistaminen
[muokkaa | muokkaa wikitekstiä]{| {{#if: {{{parametri|<noinclude>-</noinclude>}}} | {{!-}} {{!}} Nimi {{!}} {{{parametri}}} }}<!-- -->{{#if: {{{parametri2|<noinclude>-</noinclude>}}} | {{!-}} {{!}} Nimi2 {{!}} {{{parametri2}}} }} |}
Artikkeliluokan ehdollistaminen
[muokkaa | muokkaa wikitekstiä]Kun on tiedossa että malline ei saa luokitella niin kutsuttuun artikkeliluokkaan kuin tietyssä nimiavaruudessa sijaitsevat sivut jotka mallinetta käyttää, voidaan käyttää seuraavaa koodia:
<includeonly>{{#ifeq: {{NAMESPACE}} | {{ns:0}} | [[Luokka:Artikkeliluokka]] }}</includeonly>
{{ns:0}} kohdalla voidaan käyttää MediaWikin vakionimiavaruuksia (katso lista vakionimiavaruuksista m:Help:Namespace#List of namespaces).
Mallineen käyttöohjeen laatiminen
[muokkaa | muokkaa wikitekstiä]Etenkin toiminnalliseen mallineeseen on hyvä lisätä ohje, jotta joku muukin osaa sitä käyttää. Ohje voidaan kirjoittaa alla mainittua noinclude-tagia käyttämällä. Siinä olisi hyvä olla mallineen täydellinen syntaksi, eli lueteltuna kaikki mahdolliset parametrit, niiden vaikutus ja pakollisuus.
Muut mallineisiin liittyvät MediaWikin ominaisuudet
[muokkaa | muokkaa wikitekstiä]MediaWiki tukee oletuksena myös muutamaa, lähinnä mallineita varten kehitettyä toimintoa, jotka ovat:
subst
[muokkaa | muokkaa wikitekstiä]Mallineen substaus eli sijoite ({{subst:Malline}}) on toiminto, jolla mallineen tallennushetken koodi tallennetaan mallinekutsun tilalle. Tämän jälkeen muutokset mallineeseen eivät enää vaikuta kyseiseen sivuun. Tavallisesti mallineita käytetään mallinekutsujen avulla ({{Malline}}), jolloin malline haetaan uudestaan joka latauskerralla. Substaus tehdään lisäämällä subst: ennen mallineen nimeä mallinekutsussa.
{{subst:Malline}}
Täydellinen luettelo substattavista mallineista löytyy erillisestä käytösohjeesta.
noinclude
[muokkaa | muokkaa wikitekstiä]noinclude on nimensä mukaisesti tagi, joka estää mallineen ohjeiden, sisäisten luokkien ja muiden mallineeseen kuulumattomien tietojen vuotamisen artikkeleihin. Tagit kokonaisuudessaan ovat
<noinclude>.....</noinclude>
- Noinclude-tagien sisällä oleva materiaali vaikuttaa ainoastaan mallinesivuun. Siinä oleva teksti ei siis näy missään sellaisessa artikkelissa, johon malline on sisällytetty. Sisällytys tarkoittaa, että artikkelissa on mallineen kutsukoodi {{Mallineen nimi}}. Esimerkiksi yksinkertaisen mallineen käyttöohjeen voi sijoittaa noinclude-tagien sisälle. Näin ohje näkyy mallineessa, mutta ei ilmesty artikkeleihin.
includeonly
[muokkaa | muokkaa wikitekstiä]includeonly on niin ikään etenkin mallineita varten kehitetty tagi. Tagi sisällyttää ainoastaan kutsuvaan artikkeliin tagien sisällä olevan tiedon, ja se on hyödyllinen esimerkiksi silloin, kun mallineen tulee luokitella sitä käyttävä artikkeli tiettyyn ylläpitoluokkaan mutta mallineen itsensä ei tarvitse kyseiseen luokkaan kuulua. Tagit kokonaisuudessaan ovat
<includeonly>.....</includeonly>
- Includeonly-tagit toimivat päinvastoin kuin noinclude. Includeonly-tagien sisällä oleva materiaali vaikuttaa kaikkiin niihin artikkeleihin, joihin malline on sisällytetty, mutta ei itse mallinesivuun. Jos kuvitteellisen mallineen tehtävänä olisi tuottaa artikkeleihin teksti "Tämä artikkeli on tällä hetkellä sisällönarvioinnin kohteena", mutta itse mallineeseen ei haluta tuota tekstiä, niin teksti sijoitetaan includeonly-tagien sisään mallineessa.
Esimerkkimalline
[muokkaa | muokkaa wikitekstiä]Tässä on esimerkki mallineesta, joissa käytetään molempia tageja yhtäaikaa eri tarkoituksiin. Ensin viestipohjan tuottama viesti näkyy sekä mallineessa että artikkelissa. Sitten includeonly-tagien avulla kohdistetaan luokittelu vaikuttamaan vain artikkeleihin mutta ei itse mallineeseen, ja lopuksi noinclude-tagien sisällä oleva teksti, luokka ja kielilinkit vaikuttavat pelkästään mallineeseen.
Katso myös
[muokkaa | muokkaa wikitekstiä]- Wikipedian mallineiden etusivu
- Mallineprojektin etusivu
- Mallineprojektin linjaukset (heidän käyttämä opas mallineiden nimeämiseen, luokitteluun, ulkoasuun jne.)
- Kaikki vakiomuuttujat ja funktiot (englanniksi)