Wikipedia:Mallar

Wikipedia

Genväg:
WP:MALL

Stilguide

Innehåll

Formatering

Struktur

Länkar

En mall (engelska: template) är ett hjälpmedel för att infoga standardiserade textavsnitt, figurer, tabeller eller annat som man vill ska se ut på ett likartat sätt i många artiklar. Mallen är en stomme och i varje artikel anropas den med en enkel text. Därmed slipper man skriva in hela standardtexten i varje ny artikel.

Rätt använda kan mallar underlätta redigerandet för såväl en själv som ens medwikipedianer, men överdrivet bruk av mallar kan även ha risker. Se Wikipedia:Överdrivet bruk av mallar.

[redigera] Allmänt

En mall är en speciell artikel (i Kategori:mallar) som innehåller en stomme till en standardiserad text, ruta och liknande som del av en artikel. Mallar kan användas på många olika sätt, allt från att sätta in några ord eller en länk till utförliga "rutor" och avancerade programfunktioner.

För att inkludera denna stomme i en artikel anropar man mallartikeln i stället för att kopiera hela stommen. Med denna teknik blir utseendet det som mallen anger, man undviker skrivfel vid kopiering och sparar mycket arbete eftersom anropet är mycket enklare än mallen. Man slipper också att skriva /förstå komplicerad kodning. Dessutom visas alla senare ändringar i mallen på samtliga sidor som använder den mallen.

Mallar kan vara helt statiska och ge exakt samma resultat överallt eller, mycket vanligare, dynamiska med en gemensam stomme och vissa delar som varierar, antingen automatiskt (till exempel använder dagens datum eller sidans namn) eller via styrning i anropet (så kallade anropsparametrar, se nedan).

Tidigare kallades mallar för meddelandevariabler men den termen ska inte längre användas eftersom det är missvisande.

[redigera] Exempel på mallar

[redigera] Standardmeddelanden

Denna artikel är bara påbörjad. Hjälp till genom att fylla i mer!

Denna mall finns i mallartikeln Mall:stub. Flera liknande finns här.

[redigera] Faktarutor

använder med fördel mallar för att återge ett återkommande "paket" av information i samma uppställning men med viss variation i innehåll. Se till exempel serien om landskap (använder Mall:Landskapsfakta eller fältslag (använder Mall:Krigsbox). Läs mer på sidan om faktarutor.

[redigera] Navigationsrutor

för att underlätta hopp mellan en grupp av närbesläktade artiklar, skapas lätt med en mall, till exempel serien om Solsystemet (använder Mall:Solsystemet).

[redigera] Namnstandard för mallar

Mallar är normalt artiklar i namnrymden Mall, d.v.s. de är artiklar med namn av typen

Mall:mall-namn

De kan dock i princip heta vad som helst och ligga i andra namnrymder (med vissa, små nackdelar). Ett exempel på använding av mallar utanför Mall-namnrymden är för att inkludera beskrivningstexten för bilder i en artikel, eller temporärt då man experimenterar med mallar under sin egen användarsida (se nedan).

I övrigt gäller samma regler för namngivning som för vanliga artikelsidor: stor eller liten bokstav är relevant utom för den första bokstaven, och mellanslag är ekvivalent med understrykning ( _ ).

[redigera] Inkludering av mallar = anrop

För att anropa en mall i en artikel skriver man helt enkelt

{{mall-namn}}

som är en förkortning av det fullständiga skrivsättet:

{{Mall:mall-namn}}

någonstans i artikeln. Normalt utelämnar man namnrymden Mall:, den kommer kommer automatiskt att läggas till vid sökningen efter den angivna mallen. Om det inte finns någon sida med namnet Mall:mall-namn så fungerar det som [[Mall:mall-namn]] d.v.s. en länk till redigeringssidan för mallen.

Mallar kan i sin tur anropa andra mallar, men rekursion ^[1] är inte tillåtet, dvs en mall kan inte direkt eller indirekt anropa sig själv eller en överordnad mall.

Om man vill använda mallar som inte ligger i namnrymden Mall: måste man ange en annan namnrymd eller skriva ett inledande : (kolon) före namnet om det är en mallartikel som ligger i artikel-namnrymden (den "vanliga" huvud-namnrymden).

Ett exempel på det första sättet är om man vill inkludera den beskrivande texten för en bild. Man skriver då:

{{Bild:bild-namn}}

För att använda en helt vanlig artikel som mall skriver man

{{:artikel-namn}}

[redigera] Parametrar = styrmedel

En mall kan innehålla variabel text genom att man definierar parametrar i mallens text och sedan tilldelar dessa parametrar värden när man anropar mallen på någon sida. Parametrar kan antingen vara namngivna eller numrerade.

[redigera] I mallen

anger man en parameter med 3-dubbla klamrar, så här:

{{{parameter-namn}}} (för namngivna parametrar) eller

{{{1}}}, {{{2}}} etc. (för numrerade parametrar)

För parametrar som utelämnats i anropet kan default-värden (skönsvärden) anges, så här:

{{{parameternamn|defaultvärde}}}

{{{land|Sverige}}} -- om parametern "land" inte har angivits, så används värdet "Sverige"

{{{dödsår|}}} -- om parametern "dödsår" inte har angivits (eftersom personen fortfarande lever), så utelämnas detta helt

Det finns ytterligare två rätt avancerade sätt att hantera utelämnade värden. Dels med CSS-klasser (cascading style sheets) som i exemplet mall:Filmfakta, dels med villkorssatser som i mall:Ortsfakta. Metoden som använder villkorssatser är nyare och bättre och bör därför användas i nya mallar. Avsnittet nedan är taget ur mallen Filmfakta, som ställer upp en liten tabell med en tabellrad för varje parameter. Tabellraden inleds med |- och därefter följer attribut för tabellraden. Om parametern "land" har ett värde, till exempel "Norge", så blir tabellradens attribut class="hiddenStructureNorge", en CSS-klass som är odefinierad och därför blir synlig. Men om "land" har utelämnats blir i stället attributet class="hiddenStructure" som är definierad till att vara osynlig i den färdiga webbsidan. Alltså döljs hela tabellraden om mallanropet inte anger något land.

|- class="hiddenStructure{{{land|}}}"
! style="text-align: left; vertical-align: top;" | Produktionsland
| {{{land}}}

Det andra sättet att utelämna värden ur faktarutor visas av mallen Ortsfakta, se nedan. Även denna mall gör faktarutan i form av en tabell. Inom tabellraden används villkorskonstruktionen {{#if: som avslutas med ett extra }} på sista raden. Detta är alltså i sig ett mallanrop där första parametern är ett villkor, nämligen värdet av ortsparametern täthet, med blankt defaultvärde ({{{täthet|}}}). Andra parametern är det värde som bara ska infogas om villkorsvärdet är definierat. Eftersom vi befinner oss inne i ett mallanrop används !-mallen för att återge de |-tecken som krävs för konstruktionen av tabellcellerna.

|- style="vertical-align:top;"
{{#if:{{{täthet|}}}|
{{!}}  '''Folktäthet'''<sup>({{{täthetår|}}})</sup>
{{!}} {{{täthet}}}}}

Namnet på en använd bild eller namnet på en annan mall kan inte bero på parametervärden. Däremot är det tillåtet att låta sådana namn bero på variabler (till exempel {{PAGENAME}} eller {{CURRENTYEAR}}). Obs att variabler omges av bara två klamrar.

Av tekniska skäl kan ett parameternamn inte innehålla vertikalstrecket: | eftersom detta tecken används för att avskilja parametrarna vid "anropet" (se nedan).

[redigera] I anropet

till mallen ger man parametrarna deras värden genom att skriva

{{mall-namn|parameternamn1=värde1|parameternamn2=värde2}} (för namngivna parametrar, valfri ordningsföljd)

{{mall-namn|värde1|värde2}} (för numrerade parametrar, ordningsföljden avgör !)

[redigera] Exempel

Mallen som heter "fdag" ser ut så här:

Idag är det den {{{CURRENTDAY}}} {{{CURRENTMONTHNAME}}} och {{{namn}}} fyller {{{1}}} år

anropas {{fdag|namn=Fredrik|15}}

resulterar i Idag är det den 17 april och Fredrik fyller 15 år

[redigera] Statisk kopia av mall

En av fördelarna med mallar är att ändringar i mallen direkt visas på alla de sidor som använder mallen. Om man inte vill ha denna effekt skriver man ordet subst (engelskans substitute=ersätt) framför mallens namn

Då kopieras mallens innehåll till den plats där den anropas när man sparar artikelsidan (se "Gör så här" nedan). Det blir alltså inte längre ett anrop till mallen utan en statisk ("engångs"-) kopia. Allt som mallen är gjord för visas, men förändringar i mallen som görs senare kan inte påverka artikeln. Tekniken kan även användas om man vill göra modifieringar för att passa en viss artikel utan att påverka alla andra artiklar som använder mallen. Se vidare Wikipedia:Substitution.

Om man vill kopiera in innehållet i en mall utan att dess wiki-kod utförs så skriver man

Då hämtas mallens text och omges med <nowiki>-markeringar så att mallens text visas helt utan tolkning.

OBS att båda dessa kopieringar fungerar enbart om mallen ligger i namnrymden "mall" - inte om mallen ligger bland vanliga artiklar.

Gör så här:

Skriv in anrop enligt ovan (med sina dubbla klamrar)
Spara artikeln (det räcker inte med förhandsvisning !)
Starta redigering igen. Då finns hela mallens innehåll inkopierat i artikeln där anropskoden tidigare stod.

[redigera] Att hitta existerande mallar

Alla mallar läggs i Kategori:Mallar eller dess underkategorier så där kan man leta. För att leta i en strukturerad lista går man till Wikipedia:Lista över mallar eller någon av dess undersidor.

Om Du själv skapar en mall så kom ihåg att ge den Kategori:Mallar och att lägga in den på lämpligt ställe i listan. Så slipper andra att uppfinna "ditt" hjul igen.

[redigera] Att ändra i existerande mallar

Ett par små varningar är här på sin plats.

Mallar har oftast en avancerad syntax (programspråk) så man måste kunna en del för att få det rätt.
Kolla hur många sidor som använder mallen innan du ändrar något. Det kan bli mycket jobb att kolla att den nya varianten fungerar i alla dessa.
Om det inte fungerade kan man återställa till senast fungerande version i mallens historik.

[redigera] Aktuellt

8 augusti 2006: Om man begränsar sig till mallhänvisningar från artikel-namnrymden till mall-namnrymden (och alltså utesluter faktarutor på användarsidorna m.m.) så finns det enligt aktuell databasdump 104.473 sidor som gör 266.368 hänvisningar till 4097 olika mallar. Hälften av mallarna (2396 stycken) har använts färre än tio gånger och 1219 mallar har bara använts en enda gång. Att lägga in "alla mallar" i en lista över mallar verkar inte längre realistiskt, och inte heller särskilt meningsfullt. De mallar som oftast används i artiklarna är följande:

Antal sidor	Mall	Förklaring
5674	Förgrening, Gren, Gaffel	Förgreningssidor
5251	!	En teknisk fint för att kunna använda \|-tecknet i mallanrop
4228	F, FÅ, F2	Filmåret. Se kategori:Filmmallar och Wikipedia:Projekt film.
4173	Ugglan	Berättar att texten bygger på material ur "ugglan". Se Wikipedia:Projekt Nordisk familjebok.
4015	Personstub	Se Wikipedia:Projekt biografier.
3846	Stub
3465	Commons	Mer material om ämnet finns på Wikimedia Commons.
3436	Ortsfakta	Faktaruta för orter i Sverige. Se Wikipedia:Projekt Sveriges geografi.
3349	Filmfakta	Faktaruta för filmer. Se kategori:Filmmallar och Wikipedia:Projekt film.
3042	Border	Ritar en ram runt ett textavsnitt.
3005	Geografistub-Finland	Se Wikipedia:Projekt geografi.
2167	Stubavsnitt, Bidrag_saknas	Stubbmarkering för ett avsnitt av en artikel
2057	Taxonomy, Taxobox_end_placement, Taxobox_end, Taxobox_begin_placement, Taxobox_begin, Taxobox_regnum_entry, Taxobox_classis_entry, Taxobox_ordo_entry, Taxobox_image, Taxobox_familia_entry, Taxobox_genus_entry, Taxobox_section_binomial, Taxobox_domain_entry, Taxobox_portal_växter, Taxobox_species_entry, Taxobox_division_entry, Taxobox_subdivision_entry, Taxobox_subphylum_entry, Vetenskapligt_namn, Taxobox_phylum_entry, Taxobox_portal_djur	Byggelement för faktarutor (infoboxar) inom biologisk taxonomi. Se Wikipedia:Projekt djur och Wikipedia:Projekt växter. Dessa var bland de första faktarutorna och är uppbyggda med många små mallar. Modernare och enklare exempel på faktarutor är mallarna filmfakta och ortsfakta. Efter deras mönster håller nu en modernare och enhetlig mall:taxobox på att införas.
1892	Imdb, IMDb, IMDb-namn, Imdb_namn	Hänvisning till Internet Movie Database (IMDb). Se kategori:Filmmallar och Wikipedia:Projekt film.
1584	Geografistub-USA	Se Wikipedia:Projekt geografi.
1578	Årtal, Årtal_Å1, Årtal_LÅ6_800-1599, Årtal_LÅ5_800-1599, Årtal_L1_800-1599, Årtal_L11_800-1599, Årtal_EN1_800-1599, Årtal_EN11_800-1599, Årtal_EÅ1_800-1599, Årtal_EÅ11_800-1599, Årtal_E5_800-1599, Årtal_E4_800-1599, Årtal_800-1599, Årtal_1-799, Årtal_RT1_800-1599, Årtal_RT11_800-1599, Årtal_RN1_800-1599, Årtal_RN11_800-1599, Årtal_RÅ1_800-1599, Årtal_RÅ11_800-1599, Årtal_R6_800-1599, Årtal_R5_800-1599, Årtal_R1_800-1599	Byggelement för artiklarna om varje årtal, årtionde och århundrade, till exempel 1582 och 1970-talet.
1524	Musikerstub
1463	Geografistub-Schweiz	Se Wikipedia:Projekt geografi.
1445	Sportstub
1266	Skådespelarstub
1231	Start_box, End_box
1188	Sportpersonstub
1185	Succession_box
1139	Spoiler
1086	Faktaruta_kommun_Schweiz	Se Wikipedia:Projekt geografi.
924	Filmstub
866	Gp-flag	Flaggor m.m. i artiklar om racing. Se kategori:GP-mallar.
838	Politikerstub
821	Commonsbilder
792	Litteraturstub
781	Navigationsruta1mf, Navigationsruta1	Navigationsruta med flagga.
762	Bandstub
750	Författarstub
733	Musikstub
711	Navigationsruta1uf, Navigationsruta2	Navigationsruta utan flagga.
704	Företagsstub
645	Geografistub-Skåne, Geografistub-Västra_Götaland	Se Wikipedia:Projekt Sveriges geografi.
619	Ickewiki
614	Album_infobox
610	Spelstub
609	Geografistub-Sverige
600	Geografistub-Frankrike
586	Medicinstub
581	Historiestub
580	Albumstub
578	Geografistub-Ungern
575	Psalmse	Se kategori:Psalmverktyg och Wikipedia:Projekt Psalmer.
558	Taxobox	Modern faktaruta-mall för biologisk taxonomi. Jämför mallarna taxobox_... ovan.
532	Datorstub
516	Psabok	Se kategori:Psalmverktyg och Wikipedia:Projekt Psalmer.
515	Psbref	Se kategori:Psalmverktyg och Wikipedia:Projekt Psalmer.
515	Inlnkrub
505	UA
503	Historiskperson-stub
501	Geografistub-Nederländerna

[redigera] Se även

[redigera] Noter

^ betyder återvända, dvs det blir oändlig rundgång

Den här artikeln är hämtad från http://sv.wikipedia.org../../../m/a/l/Wikipedia%7EMallar_e047.html

Kategorier: Wikipedia Referens | Wikipedia:Redigering