Lähdekoodi sivulle Wikiprojekti:Mallineet/Metatieto

{{TOCoikea}}
Mallineiden '''[https://fi.wikipedia.org/wiki/Metatieto metatieto]''' on kaikki mallineeseen liittyvä sisältö pois lukien itse mallinekoodi. Metatiedot sijaitsevat seuraavasti:
* mallineen alasivulla (Malline:MallineenNimi/ohje)
** kaikki muu paitsi mallineen luokat
* itse mallineen sivulla (Malline:MallineenNimi)
** mallineen luokat

Jokaisen mallineen ohjeessa tulisi vähintään mainita mihin mallinetta käytetään ja olla kopioitava mallinekutsu. Lisäksi tietolaatikoilla ja muilla mallineilla, joilla on parametreja, tulisi olla [[AutoWiki:Visuaalinen muokkain/TemplateData|TemplateData]] (josta haetaan tidot VisualEditoriin).

Mallineen sivulle koodin loppuun lisätään
<nowiki><noinclude>{{Mallineohje|Luokka1|Luokka2}}</noinclude></nowiki>
, jossa Luokka1, Luokka2 jne. ovat mallineen luokkia. Tämä Mallineohje-malline tulostaa ohje-alasivulla olevan ohjeen näkyväksi itse mallineeseen.

Esimerkit:
Tietolaatikkomalline:
* [[Malline:Malli]] ja [[Malline:Malli/ohje]]

== Ohje-sivun rakenne ==
Kukin osio tulee tyypillisesti omaan kappaleeseensa, pois lukien:
* mallinehuomio, jos se ylipäätään on tarpeen, tulee sivun alkuun
* luokat annetaan varsinaisen mallineen sivulla mallineohje-mallinekutsuun
<pre><nowiki>
{{Mallineen ohjesivu}}
{{Mallinehuomio}}
== Käyttötarkoitus ==

== Ohje ==

== Parametrit ==

== Templatedata ==
</nowiki>
</pre>

== Metatiedot ==

=== Mallinehuomio ===
Mallinehuomio on malline, jolla merkitään mallineen normaalista käyttökunnosta poikkeava tila kuten, onko siinä jotain vikaa, sopiiko sitä käyttää, yms.
;[[Malline:Mallinehuomio]]
:Malline sisältää huomattavasti ohjelmallisuutta
;[[Malline:Mallinehuomio/korjattava]]
:Mallineessa on jokin vika
;[[Malline:Mallinehuomio/kesken]]
:Malline on vasta kehitteillä. Eli ei yleiseen käyttöön.
;[[Malline:Mallinehuomio/vanhentunut]]
:Malline poistetaan tai on jo poistettu käytöstä mutta itse malline säilytetään arkistoituna.

=== Käyttötarkoitus ===
Kertoo mihin mallinetta käytetään.

=== Ohje ===
Seikkaperäinen ohje, siitä miten mallinnetta käytetään

==== Mallinekutsu ====
Tilanteen mukaan ohjeessa voi olla vaikkapa seuraavanlaisia [[Wikipedia:Sanasto#mallinekutsu|mallinekutsuja]]:
* Ohjeeksi ja esimerkikksi tarkoitettu täysin täytetty mallinekutsu.
* Muokkauksen aloittamiseksi yleisellä wikikoodilla täytetty mallinekutsu.

=== Parametrit ===
Tarvittaessa annetaan tiedot kustakin mallineen parametrista. Käytä [[Malline:Mallineen parametrit -ohje/alku|Mallineen parametrit -ohje/alku]] mallinesysteemiä. Huomaa, että toiminto koostuu kolmesta mallineesta.

=== Luokat ===
Mallineluokan nimessä tulee esiintyä päätteenä sana "mallineet", jotta se ei sekoitun artikkeliluokkiin. Luokan nimen tulee noudattaa [[Ohje:Tyyliopas/Kielioppi|suomen kielen kielioppia]]
Navigaatiomallineiden luokkien tulee sisältää pääte "navigaatiomallineet" ('''ei''' "navigointimallineet")

[[:Luokka:Mallineet]] on pääluokka kaikille mallineille. Luokat annetaan Mallineohje-mallineen parametreinä.

Mallineet luokitellaan kahteen eri luokkahierarkiaan tyypin mukaan ja aiheen mukaan. Näin jotta luokittelu palvelisi kahta varsin erilaista tarkoitus. Mallineiden hallinnoinnista kiinnostuneet mallineprojektilaiset haluvat löytää mallineita tyypin mukaan (Esimerkiksi tietolaatikot tarvitsemat kiireemmin kelpo ohjeen kuin navigaatiot). Mallineiden käyttäjät tyypillisesti hakevat mallineita taasen aiheen mukaan.  Luokitus aiheiden mukaan seurailee artikkelien luokitusta.

Käytössä olevat tyypin mukaiset luokat:
* Tietolaatikko
** [[:Luokka:Tietolaatikkomallineet]]
* Pohjamallineet - mallineet joita käytetään toisten mallineiden tekemiseen; käytetään tehdessä mallineita, joissa on toistuvia elementtejä
** [[:Luokka:Pohjamallineet]]
* Vaakanavigaatio, sijaitsee artikkelin lopussa ja on koko sivun levyinen
** [[:Luokka:Vaakanavigaationmallineet]]
* Pystynavigaatio, sijaitsee yleensä artikkelin alussa, vie yleensä kuvan verran tilaa
** [[:Luokka:Pystynavigaatiomallineet]]

=== TemplateData ===
[[AutoWiki:Visuaalinen muokkain/TemplateData|TemplateData]] on vakiomuotoisesti annettu tieto mallineen käytöstä ja parametreistä. [[AutoWiki:Visuaalinen muokkain|Visuaalinen muokkain]] käyttää TemplateDataa.

TemplateDataa voi muokata koodina tai kaavakkeessa. Kun malline on muokkaustilassa sivun yläosaa ilmestyy "Hallitse mallineen dokumentaatiota" -painike, josta aukeaa TemplateDatan muokkauskaavake.

Mallineen TempalateData-parametrit <ref>https://en.wikipedia.org/wiki/Wikipedia:VisualEditor/TemplateData/Tutorial#Completing_the_TemplateData_information</ref>
;label
: VisualEditorissa näkyvä parametrin nimi
: Arvona versaalilla alkava lyhyt teksti
;description
: Arvona monisanaisempi kuvaus parametrin käytöstä
: Tässä voi antaa myös esimerkkejä
;type
: Parametrin sisällön tyyppi
: Määrittää sen, kuinka VisualEditor tulkitsee parametrin arvon
:;string
:: Teksti
:;number
:: kokonaisluku
:;string/wiki-user-name
::
:;string/wiki-page-name
::
:;string/line
:: Short text field - use for names, labels, and other short-form fields.
;default
: contains the default value of this parameter (in quotes). The information can be skipped, if the parameter has no default value as in this example.
;required
: controls whether filling out the parameter is mandatory for that template. Enter true if the value is required for the template and false if it is not required. In this case, both count and sub_string are required values.
;aliases
: (optional) List of aliases eg "aliases": [ "2", "Caption", "imagecaption" ]. An alias is an alternative name for the parameter that may be used instead of (not in addition to) the primary name. Aliases are not documented in a separate parameter object. If they need more information, they should be in their own property marked "deprecated".
;deprecated
:Vain tarvittaessa
: Tooltip for the user detailing the intent for the deprecated parameters, a boolean or string value.
;inherits
:Vain tarkittaessa
:Key to another parameter. The current parameter will inherit from that one, with local properties overriding the inherited ones.

== Toiminnan mahdollistavat mallineet ja muut sivut ==
[[AutoWiki:Visuaalinen_muokkain/TemplateData]]

[[:Luokka:Mallineohjemallineet]]

Nykyiset viralliset mallineet:
* [[Malline:Mallineohje]] - tulostaa mallinesivulle ohjeet ohje-alasivulta
* [[Malline:Mallineen ohjesivu]] - tulostaa ohjesivulle ohjeen/huomautuksen
* [[Malline:Mallineen parametrit -ohje/alku]] - käytetään parametrien ohjeiden antamiseen
* [[Malline:Mallineohjeen luontilaatikko]] - Lataa mallineohjepohjan annetulle nimelle.

Esimerkkejä ja pohjia:
* [[AutoWiki:Artikkelipohja/Malline-ohje]] - esimerkkipohja ohjesivulle
* [[AutoWiki:Sivupohja/Mallineohje]] - käsin kopioitava pohja
* [[AutoWiki:Sivupohja/Mallineohje luontilaatikolle]] - pohja sellaisessa muodossa, että se toimii [[Malline:Mallineohjeen luontilaatikko|luontilaatikkomallineen]] kanssa
* [[Malline:Mallineohjemalli]] - malline ja sen ohje esisemrkiksi

Kehitteillä tai testauksessa olevat:
:Entä jos ohje onkin mallineen pääsivulla:
* [[Malline:Dokumentaatio]] - lisää laatikon, johon varsinainen mallineen käyttöohje sijoitetaan, kun ohje on mallineen sivulla eikä tämän ohje-alasivulla.
* [[Malline:Mallineen dokumentaatio]] - lisää laatikon, johon varsinainen mallineen käyttöohje sijoitetaan, kun ohje on mallineen sivulla eikä tämän ohje-alasivulla.

Käytöstä poistettavat:
* [[Malline:Mallineohjepohja]] - /ohje-alasivun muotoilun hoitava malline. Käytetään ohje-alasivulla tulostamaan /ohjesivun muokkausohje.
** [[Malline:Mallineohjepohja/avattava]], [[Malline:Mallineohjepohja/avattavaLoppu|/avattavaLoppu]] - Käytetään harvemmin tarvittavan sisällön piilottamiseen avattavaan laatikkoon
** [[Malline:Mallineohjepohja/parametrit]], [[Malline:Mallineohjepohja/parametririvi|/parametririvi]], [[Malline:Mallineohjepohja/parametritLoppu|/parametriLoppu]] - Käytetään listaamaan mallineen parametrit.
* [[Malline:Mallinerivi2]] - Tulostaa tiivistelmän mallinelistauksiin. (Käyttöön otto vaatii botin, joka osaa hakea mallineiden tiivistelmät.)
* [[Malline:Mallineohje-vanha]] - 
* [[Malline:Mallinerivi]] - tulostaa tiivistelmän mallinelistauksiin eli ohjeistaviin näkymiin. Nykyisellään listaukset ovat vanhentuneet ja harvassa on tiivistelmä eli ne eivät oli niin hyödyllisiä kuin voisivat olla.

== Viitteet ==
{{Viitteet}}