Help:Template (Suomi)

From ArchWiki
Jump to navigation Jump to search

Malline (englannin Template) on valmiiksi tehty osanen wikitekstiä, joka on mahdollista laittaa omaan artikkeliin. Mallineita käytetään lähinnä sisällön muotoiluun ja wikitekstin koristeluun.

Käyttö

Mallineita lisätään seuraavanlaisella merkkauksellä:

{{Mallineen nimi}}

Suurin osa mallineista hyväksyy/tarvitsee lisäargumentteja, kuten esim. Template:Huomautus:

{{Huomautus|Tämä teksi on huomiona lukijalle.}}

mistä tulee tämän näköinen:

Huomautus: Tämä teksi on huomiona lukijalle.

Jotkin mallineet ottavat nimettyjä parametrejä, kuten Template:hc:

{{hc|head=/etc/rc.local|output=exit 0}}

mistä tulee tämän näköinen:

/etc/rc.local
exit 0

Yleinen muoto onkin tämä:

{{Mallineen nimi|param1|param2|...|paramN}}

Näe jokaisen mallineen sivu käyttöohjeita varten.

Tyyli

  • Mallineissa pitää muistaa oikeat alkukirjaimet kuten esimerkeissä mallineiden sivuilla on näytettynä, esimerkiksi {{Pkg|... ja {{ic|... ovat oikein, kun taas {{pkg|... ja {{Ic|... eivät ole.
  • Mallineen nimen ympärille ei voi jättää väliä: {{Mallineen nimi|... on oikein, kun taas {{ Mallineen nimi |... ei ole.
  • Mallinetta ei voi luokitella.

Mallineita rikkovien merkkien syöttäminen

On olemassa joitain merkkejä jotka, käytettynä mallineen sisällä, rikkovat sen tulosteen: useimmiten tämä tapahtuu merkin "=" (yhtäsuuruus merkki) kanssa ja "|" (putki merkki). Ratkaisuja tähän ongelmaan on esitettynä alapuolella.

Vinkki: putki merkki "|" voidaan syöttää käyttämällä {{!}} taikasanaa.

Nimetyt ja numeroidut parametrit

Jos ongelmana on vain "=" merkki, suositeltuna ratkaisuna on selvästi laittaa mallinne parametreja niiden järjestyksellisillä numeroilla tai nimillä.

Esimerkki: {{Vinkki|1=https://www.archlinux.org/?foo=bar}}

Tulos:

Tämä on hyödyllinen tapa:

  • Muuttuville määritelmille.
  • Shell merkkijonoille ja komennoille.
  • Riveille koodia.
Useita parametreja
  • Käyttäen järjestyksellisiä parametrejä 1 ja 2
{{hc|1=$ echo "="|2==}}

Tulos:

$ echo "="
=
  • Käyttäen nimettyjä parametrejä head ja output
{{hc|head=$ echo "="|output==}}

Tulos:

$ echo "="
=

nowiki tägit

Jos tulee ongelmia muiden kuin "=" merkin kanssa, kuten esim. "}", suositeltuna ratkaisuna on aidata koko parametri <nowiki> tägeihin. Tämä metodi näyttää kaikki mahdolliset merkit, mutta kokonaan estää wikikoneen toiminnan tekstin merkkauksessa, kuten linkkejä ja muita mallineita. Kuten esimerkiksi:

{{Vinkki|<nowiki>= | }} https://www.archlinux.org/ {{ic|foo}}</nowiki>}}
Vinkki: = | }} https://www.archlinux.org/ {{ic|foo}}

Aitaamalla vain tiettyjä kohtia (tai vain yksittäisiä kirjaimia) <nowiki> tägeillä toimii myös, mutta luettavuuden takia on suositeltavaa käyttää tätä metodia vain jos linkkejä tai muita mallineita pitää esittää normaalisti. Esimerkiksi:

{{Vinkki|<nowiki>= | }}</nowiki> https://www.archlinux.org/ {{ic|foo}}}}
Vinkki: = | }} https://archlinux.org/ foo

HTML merkinnät

Korvaamalla loukkaavat kirjaimet niitä vastaavilla HTML merkinnöillä toimii aina, mutta koska se laskee lähde tekstin luettavuutta, sitä suositellaan vain kun ratkaisut joita on esitetty yläpuolella eivät ole syystä tai toisesta mahdollisia. Esimerkiksi:

{{Vinkki|&#61; &#124; &#123;&#123; &#125;&#125;}}
Vinkki: = | {{ }}

Luominen

Huomautus:
  • Ennen mallineen luontia, keskustele tästä muiden wikikäyttäjien kanssa Help talk:Template.
  • Luo vain oleellisia mallineita. Jos aiot luoda mallineen jota saatetaan käyttää vain hyvin harvassa artikkelissa, älä vaivaudu luomaan mallinetta, vältä nimitilan käyttämistä turhaan.
  • Luo vain lyhytsanaisia mallineita. Muista Arch-tapa: Pidetään kaikki yksinkertaisena!
  • Katso myös kaikki englanninkieliset mallineet ensin, joiden pohjalta voisit mahdollisesti suomentaa mallineen. Kaikkia mallineita ei välttämättä ole vielä suomennettu.

Seuraavaa mallipohjaa tulisi käyttää kun uutta mallinetta luodaan helpottamaan käyttöä ja muokkaamista:

<noinclude>
{{Template (Suomi)}}

Lyhyt kuvaus mallineesta.

== Käyttö ==

<nowiki>{{Mallineen nimi|param1|param2|...|paramN}}</nowiki>

== Esimerkki ==

{{Mallineen nimi|param1|param2|...|paramN}}</noinclude><includeonly>Malline koodi tulee tähän...</includeonly>

Luomisen aloittamiseksi, mene sivulle Template:Mallineen nimi (korvaa Malline nimi halutulla malline nimellä ja mieluiten englanniksi), muokkaa ja lisää oleellinen wikiteksti.

Lista mallineista

Mallineet, joita käyttäjä voi suoraan käyttää artikkeleissa ArchWikissä, ovat listattuna alla. Klikkaa linkeistä nähdäksesi niiden yksityiskohtainen käyttö. Lista josta löytyy myös paikallistaminen ja metamallineet katso Special:AllPages/Template:, Special:PrefixIndex/Template: tai Special:MostLinkedTemplates.

Varoitus: Älä muokkaa jo valmiita mallineita. Jos haluat muokata suojaamattomia mallineita, kopioi teksti Template:Sandbox tänne, muokka ja testaa sitä siellä ja kopioi se takaisin kun se toimii. Vahvasti suositellaan (ja joka on tarpeen suojatuille mallineille) esittää muutoksia keskustelu sivulla ensin ennenkuin muokkauksia tehdään.

Kokeileminen

Artikkelin tilamallineet

Nämä mallineet tulisi lisätä artikkeleiden tai otsikoiden jälkeen alkuun, kun ne ovat tarpeellisia. Katso myös Help:Style#Article status templates.

Suomentajien tulisi myös katsoa ohjeet sivulta ArchWiki:Translation Team.

Sivut joita on merkitty artikkeli status mallineella seurataan niitä vastaavissa ylläpito kategorioissa ja ArchWiki:Statistics#Maintenance statistics.

Huomaa ettei kaikkien mallineiden tarvitse olla suomeksi!

Nimi Suositeltu käyttö Parametrit
Template:Style Sisältö josta löytyy sisältö wikisyntaksi tai tyyliongelmia. 1 — syy, 2 — vapaaehtoinen keskustelu-sivu, section — vapaaehtoinen kohta oletus keskustelu-sivulla
Template:Accuracy Väärä, harhaanjohtava tai sekava sisältö.
Template:Expansion Täydennettävä sisältö.
Template:Out of date Vanhentunut sisältö.
Template:Remove Epäolennainen tai hyödytön sisältö.
Template:Archive Vanhentunut sivu.
Template:Laptop style Läppäri artikkelit, jotka ovat kopiona muille artikkeleille.
Template:Translateme (Suomi) Epätäydellinen käännös.
Template:Bad translation Viallinen käännös.
Template:TranslationStatus (Suomi) Käännöksen tila. 1 — alkuperäinen otsikko, 2 — käännös päiväys, 3 — version numero
Template:Merge Sisältö menee osittain toisen artikkelin päälle. 1 — kohde sivu, 2 — syy, 3 — vapaaehtoinen keskustelu-sivu, section — vapaaehtoinen kohta oletus keskustelu-sivulla
Template:Move Sivun uudelleennimeäminen, osan siirto toiseen artikkeliin.
Template:Redirect Ohjaa sivu toiseen artikkeliin.
Template:Unsupported Käyttäjien sivut, joita Arch Linux ei tue. 1 — viimeisin päiväys kun sivun laatija on tehnyt muutoksia.

Artikkeliin liittyen-mallineet

Koodin muotoilumallineet

Huomiomallineet

Vain keskustelu sivuille luonnosteluina:

Sekalaisia mallineita

Pakettimallineet

Taulun solun mallineet

Tekstin linjaus:

Nimi Linjaus Wiki merkkaus Tulos
Template:C keskellä {{C|teksti}} teksti
Template:L vasemmalla {{L|teksti}} teksti

Solun tausta:

Nimi Väri Wiki merkkaus Tulos
Template:R punainen {{R|teksti}} teksti
Template:O oranssi {{O|teksti}} teksti
Template:Y keltainen {{Y|teksti}} teksti
Template:G vihreä {{G|teksti}} teksti
Template:B sininen {{B|teksti}} teksti
Template:V violetti {{V|teksti}} teksti
Template:Grey harmaa {{Grey|teksti}} teksti

Yleinen teksti:

Nimi Wiki merkkaus Tulos
Template:Yes (Suomi) {{Kyllä}} Kyllä
{{Kyllä|https://wiki.archlinux.org/}} Kyllä
Template:No (Suomi) {{Ei}} Ei
{{Ei|https://wiki.archlinux.org/}} Ei
Template:- {{-}}
Vinkki: Voit käyttää määreitä taulun solun mallineissa antamalla niille etuliitteen, kuten esimerkiksi: | colspan=2 {{Kyllä}}.

Kategoria malline

Katso myös