Help:Template (Suomi)

From ArchWiki
Jump to navigation Jump to search

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

Käyttö

Mallinteita lisätään seuraavanlaisella merkkauksellä:

{{Mallinteen nimi}}

Suurin osa mallinteista 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 mallinteet 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ä:

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

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

Tyyli

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

Mallinteita rikkovien merkkien syöttäminen

On olemassa joitain merkkejä jotka, käytettynä mallinteen sisällä, rikkovat sen tulosteen: useimmiten tämä tapahtuu merkin "=" (yhtäkuin 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 mallinteita. 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 mallinteita pitää esittää normaalisti. Esimerkiksi:

{{Vinkki|<nowiki>= | }}</nowiki> https://www.archlinux.org/ {{ic|foo}}}}
Vinkki: = | }} https://www.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 mallinteen luontia, keskustele tästä muiden wikikäyttäjien kanssa Help talk:Template.
  • Luo vain oleellisia mallinteita. Jos aiot luoda mallinteen jota saatetaan käyttää vain hyvin harvassa artikkelissa, älä vaivaudu luomaan mallinnetta, vältä nimitilan käyttämistä turhaan.
  • Luo vain lyhytsanaisia mallinteita. Muista Arch tapa: Pidetään kaikki yksinkertaisena!
  • Katso myös kaikki englanninkieliset mallinteet ensin, joiden pohjalta voisit mahdollisesti suomentaa mallinteen. Kaikkia mallinteita ei välttämättä ole vielä suomennettu.

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

<noinclude>
{{Template (Suomi)}}

Lyhyt kuvaus mallinteesta.

== Käyttö ==

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

== Esimerkki ==

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

Luomisen aloittamiseksi, mene sivulle Template:Mallinteen nimi (korvaa Mallinne nimi halutulla mallinne nimellä ja mieluiten englanniksi), muokkaa ja lisää oleellinen wikiteksti.

Lista mallinteista

Mallinteet, 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 meta mallinteet katso Special:AllPages/Template:, Special:PrefixIndex/Template: tai Special:MostLinkedTemplates.

Varoitus: Älä muokkaa jo valmiita mallinteita. Jos haluat muokata suojaamattomia mallinteita, 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 mallinteille) esittää muutoksia keskustelu sivulla ensin ennenkuin muokkauksia tehdään.

Testaus

Artikkelin status mallinteet

Nämä mallinteet tulis 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 mallinteella seurataan niitä vastaavissa ylläpito kategorioissa ja ArchWiki:Statistics#Maintenance statistics.

Huomaa ettei kaikkien mallinteiden tarvitse olla suomeksi!

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

Artikkeliin liittyen -mallinteet

Koodin muotoilu mallinteet

Huomio mallinteet

Vain keskustelu sivuille luonnosteluina:

Sekalaisia mallinteita

Paketti mallinteet

Taulun solun mallinteet

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 mallinteissa antamalla niille etuliitteen, kuten esimerkiksi: | colspan=2 {{Kyllä}}.

Kategoria mallinne

Katso myös