Wikipedia:Mallar.html

Genväg: WP:MALL

Stilguide

Innehåll

Formatering

Struktur

Länkar

En mall, tidigare kallad meddelandevariabel, ä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 på många sidor. Mallen är en stomme och i varje artikel anropas den med en enkel text. Därmed slipper man skriva in hela standardtexten på varje sida. 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.

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". I teorin går det även att använda mallar till avancerade programfunktioner; detta är de dock inte avsedda för, och Wikimedias utvecklare brukar avråda från det.

redigera Rubriktext

redigera Typer av mallar

redigera Standardmeddelanden

Exempel på standardmeddelanden är {{ickewiki}} och {{POV}}; flera liknande finns här. Oftast används den här typen av mallar för kvalitetkontroll. Standardmeddelanden bör motiveras med ett utvecklat resonemang på artikeln diskussionssida.

redigera Stubmallar

Stubbmallar, som {{stub}}, används för att markera ut stubbar.

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 Projektmallar

Projektmallar placeras på artiklars diskussionssidor, för att hugade användare ska kunna hitta till projektet. De kan dessutom innehålla uppgifter om artikeln ifråga ur projektets synpunkt, såsom hur viktig den är att förbättra eller hurpass långt utvecklad den är.

redigera Mallar för referenslitteratur

Källhänvisningar är viktiga för Wikipedia och inom ett projekt hänvisar man ofta till samma referenslitteratur. För att slippa upprepa hela källhänvisningen varje gång, med den risk detta innebär för skrivfel, kan man inrätta en mall som gör de vanligaste källorna tillgängliga med kortnamn. Ett exempel är mallen Ref orglar.

redigera Mallar för användares diskussionssidor

Denna typ av mallar är förmodligen den mest kontroversiella, då många användare ogillar att få opersonliga mall-meddelanden istället för text som användaren formulerat själv. Mest allmänt accepterade är nog klottermallarna, eftersom det ofta inte känns meningsfullt att lägga ner tid på personligt utformade meddelanden till klottrare. Därnäst kommer förmodligen välkommenmallarna, som ger mer eller mindre nytillkomna användare en introduktion till några nyttiga sidor att läsa.

redigera Namnstandard för mallar

Mallar är normalt artiklar i namnrymden Mall. En sådan mall är alltså en sida med namn på formen

Mall:mall-namn

Sidor som används som mallar kan dock i princip heta vad som helst och ligga i andra namnrymder (med vissa, små nackdelar). Ett exempel på användning av mallar utanför Mall-namnrymden är användarrutor, som med fördel läggs som undersidor i användarnamnrymden.

Precis som för andra typer av sidor skiljer mallarna på stora och små bokstäver i sidtiteln, förutom i första bokstaven, och blanksteg är ekvivalent med understeck ( _ ).

redigera Grafisk utformning av mallar

redigera Bilder i mallar

En mall kan innehålla en eller flera bilder, om det gör mallen lättare att förstå. Ett par riktlinjer för bilder i mallar:

Bilden måste vara fri från upphovsrätt. Till exempel ska inte företagslogotyper användas i mallar.
Bilden bör vara stor nog för att det ska synas vad den föreställer, men inte så stor att den stör mallens layout.
Det är ofta en fördel att välja enkla, entydiga och etablerade piktogram, som flaggor, vägmärken, stiliserade vardagsföremål och liknande.

Exempel finns att se i Kategori:Stubbmallar.

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 villkorssatser som i mall:Ortsfakta, dels med CSS-klasser (cascading style sheets) som i en del gamla mallar. Metoden som använder villkorssatser är nyare och bättre och bör därför användas i nya mallar.

Här är ett exempel (från mallen Ortsfakta) på hur värden kan utelämnas ur faktarutor. 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}}}}}

Avsnittet nedan är ett exempel på hur hiddenstrucures fungerar. Det är taget ur en gammal version av 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}}}

Namnet på en använd bild eller namnet på en annan mall bör 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 november och Fredrik fyller 15 år

redigera Blanksteg kan försvinna i #if:

Hej{{#if:{{{namn|}}}|, {{{namn}}}| där}}

borde resultera i "Hej, Kurt" eller "Hej där", beroende på om {{{namn}}} är Kurt eller inget alls. Men inledande blanksteg i if-satsens alternativ försvinner, så alternativet " där" blir bara "där", vilket ger "Hejdär". En lösning är att lägga till kommat i en separat if-sats och därefter ha ett gemensamt blanksteg före nästa if-sats:

Hej{{#if:{{{1|}}}|,|}} {{#if:{{{namn|}}}|{{{namn}}}|där}}

En annan lösning är att använda ett   inne i if-satsen. Det tas inte bort, men det hindrar samtidigt att den resulterande texten radbryts just dä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.

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 Se även

redigera Noter

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