Vis kilden til Mal:Flagg/dok

{{Dokumentasjonsunderside}}

== Hurtiggaid ==
{{flagg/dok/Hurtiggaid}}

== Formål ==

Dette er en mal som brukes for å forenkle innlegging av flagg. Den viser flagget til et land eller område og gjør at dette lenker til artikkelen om området, alternativt med ei tekstlenke ved siden av flagget.

== Bruk ==
Malen har én obligatorisk parameter, nemlig navnet på landet/området, parameter <span style="color:#339;">(1)</span>. De andre parameterne kan kombineres på forskjellige måter.

;<code style="color:#339;">(1)</code>
:Dette er den eneste påkrevde parameteren. Den bør være navnet på landet eller området, fortrinnsvis det samme som områdets artikkelnavn på Wikipedia. Om man kun har med denne parameteren vil kun et lite flagg vises: '''<code><nowiki>{{flagg|</nowiki><span style="color:#339;">Bhutan</span><nowiki>}}</nowiki></code>''' blir til {{flagg|Bhutan}}.

;<code style="color:#393;">(2)</code>
:Denne parameteren gjør at det brukes et alternativt flagg i stedet for det nåværende (eller nyligste) flagget. Dette gjøres som regel for å bruke gamle flagg når et land har endra flagget sitt. Da bruker man årstallet hendelsen gjelder, så får man automatisk flagget landet brukte denne perioden. Om man for eksempel skal vise flagget som ble brukt av [[Lesotho]] mellom 1967 og 2006 kan man skrive '''<code><nowiki>{{flagg|</nowiki><span style="color:#339;">Lesotho</span>|<span style="color:#393;">2005</span><nowiki>}}</nowiki></code>''', som blir til {{flagg|Lesotho|2002}}, altså flagget som ble brukt i [[Lesotho]] i 2005.
:Det er også noen andre alternative flagg som ikke har med hvilke årstall de ble brukt; [[Republikken Kina]] bruker for eksempel ikke sitt vanlige flagg under OL. For å vise dette kan man skrive '''<code><nowiki>{{flagg|</nowiki><span style="color:#339;">Republikken Kina</span>|<span style="color:#393;">OL</span><nowiki>}}</nowiki></code>''', som vises som {{flagg|Republikken Kina|OL}}.
:Hvilke årstall eller andre parametere som virker kan man se på hvert lands malunderside, f.eks. [[Mal:Flagg/Ecuador]].

;<code style="color:#933;">lenke</code>
:Denne parameteren kan oppgis som nr <span style="color:#393;">(2)</span> eller <span style="color:#933;">(3)</span>. Den fører til at det kommer ei tekstlenke til landets/områdets artikkel ved siden av flagget. Den kan brukes uten spesifikasjon (<code>lenke</code>) eller med (<code>lenke=''artikkelnavn''</code>). For eksempel blir '''<code><nowiki>{{flagg|</nowiki><span style="color:#339;">Basjkortostan</span>|<span style="color:#933;">lenke</span><nowiki>}}</nowiki></code>''' til {{flagg|Basjkortostan|lenke}}, og '''<code><nowiki>{{flagg|</nowiki><span style="color:#339;">Norge</span>|<span style="color:#393;">2010</span>|<span style="color:#933;">lenke=Norge under Vinter-OL 2010</span><nowiki>}}</nowiki></code> til {{flagg|Norge|2010|lenke=Norge under Vinter-OL 2010}}.

;<code style="color:#399;">lenketekst</code>
:Denne brukes dersom man vil ha en lenketekst som lenker til noe annet enn standard lenketekst (som er områdets navn eller det som oppgis i <code style="color:#933;">lenke=</span>). For eksempel vil '''<code><nowiki>{{flagg|</nowiki><span style="color:#339;">USA</span>|<span style="color:#399;">lenketekst=Sambandsstatene</span><nowiki>}}</nowiki></code>''' vises som {{flagg|USA|lenketekst=Sambandsstatene}} (lenker til [[USA]], vises som «Sambandsstatene». Med noe angitt i <code style="color:#393;">lenke</code>-parameteren blir det slik: '''<code><nowiki>{{flagg|</nowiki><span style="color:#339;">Sør-Korea</span>|<span style="color:#393;">lenke=Sør-Korea under Vinter-OL 2010</span>|<span style="color:#399;">lenketekst=Sør-Korea</span><nowiki>}}</nowiki></code>''' → {{flagg|Sør-Korea|lenke=Sør-Korea under Vinter-OL 2010|lenketekst=Sør-Korea}}.

;<code style="color:#993;">størrelse</code>
:Denne brukes om man ønsker en annen størrelse på flagget enn standardstørrelsen (22px). Størrelsen oppgis i <code>px</code>. Eksempel: '''<code><nowiki>{{flagg|</nowiki><span style="color:#339;">Niue</span>|<span style="color:#993;">størrelse=70px</span><nowiki>}}</nowiki></code>''' → {{flagg|Niue|størrelse=70px}}.

<templatedata>
{
	"params": {
		"1": {
			"description": "Land eller organisasjon",
			"type": "string",
			"default": "",
			"required": true
		},
		"2": {
			"description": "Alternativt flagg: Årstall for gammelt flagg.",
			"type": "string",
			"default": "Nå"
		},
		"størrelse": {
			"description": "Overstyring av bildestørrelse.",
			"default": "22px"
		},
		"lenke": {
			"description": "Artikkeltittel man vil lenke til",
			"type": "string"
		},
		"lenketekst": {
			"description": "Overstyring av lenketekst",
			"type": "string"
		}
	},
	"description": "Setter inn et flagg, evt. med lenke",
	"paramOrder": [
		"1",
		"2",
		"lenke",
		"lenketekst",
		"størrelse"
	]
}
</templatedata>

== Eksempler ==

;Kun flagg
*<code><nowiki>{{flagg|Nauru}}</nowiki></code>
*:→ {{flagg|Nauru}}
*<code><nowiki>{{flagg|Burma|2005}}</nowiki></code>
*:→ {{flagg|Burma|2005}}

;Kun flagg, annen størrelse
*<code><nowiki>{{flagg|Tsjuvasjia|størrelse=100px}}</nowiki></code>
*:→ {{flagg|Tsjuvasjia|størrelse=100px}}

;Flagg med lenke
*<code><nowiki>{{flagg|Tanzania|lenke}}</nowiki></code>
*:→ {{flagg|Tanzania|lenke}}
*<code><nowiki>{{flagg|Bermuda|lenke=Bermuda under Vinter-OL 2010}}</nowiki></code>
*:→ {{flagg|Bermuda|lenke=Bermuda under Vinter-OL 2010}}

;Flagg med annen lenketekst
*<code><nowiki>{{flagg|Florida|lenketekst=Solskinnsstaten}}</nowiki></code>
*:→ {{flagg|Florida|lenketekst=Solskinnsstaten}}

;Flagg med annen lenke og lenketekst
*<code><nowiki>{{flagg|Kasakhstan|lenke=Kasakhstan under Vinter-OL 1994|lenketekst=KAZ}}</nowiki></code>
*:→ {{flagg|Kasakhstan|lenke=Kasakhstan under Vinter-OL 1994|lenketekst=KAZ}}

;Alle parametere
*<code><nowiki>{{flagg|Lesotho|1972|størrelse=40px|lenke=Lesotho under Sommer-OL 1972|lenketekst=Lesotho}}</nowiki></code>
*:→ {{flagg|Lesotho|1972|størrelse=40px|lenke=Lesotho under Sommer-OL 1972|lenketekst=Lesotho}}

== Hvordan malen fungerer ==
Denne malen kaller på en undermal, som ligger på formen <code>Mal:Flagg/''område''</code>, der ''<code>område</code>'' er parameter nr. 1. Denne undermalen inneholder informasjon om navn, artikkelnavn (for tilfeller som [[Georgia (USA)]]), nåværende flagg, alternative flagg og historiske flagg.

Om man angir et årstall som parameter nr. 2 vil denne malen sjekke om det finnes noen historiske flagg som var i bruk dette årstallet, og om det ikke var det vil den returnere det nåværende flagget. I motsetning til den tidligere versjonen av denne malen trenger ikke årstallet å være det året flagget gikk ut av bruk, malen sjekker automatisk om det har vært noen flaggendringer mellom nåværende år og året som er oppgitt i parameter nr. 2.

For å opprette en ny undermal eller redigere en eksisterende undermal, gå til dennes underside og følg mønsteret som er der. Gode eksempler på forskjellige alternativer er [[Mal:Flagg/Nepal]], [[Mal:Flagg/Georgia (USA)]], [[Mal:Flagg/Republikken Kina]] og [[Mal:Flagg/Ecuador]]. Omdirigeringer fungerer som ellers med tanke på undermalene, for eksempel er [[Mal:Flagg/KAZ]] ([[ISO 3166-1 alfa-3]]-kode) en omdirigering til [[Mal:Flagg/Kasakhstan]], slik at <code>KAZ</code> fungerer som innputt.

== Se også ==
* [[Spesial:Prefiksindeks/Mal:Flagg/|Liste over undermaler]]
* {{tl|Flagg-h}}
<includeonly>
<!-- KATEGORIER OG INTERWIKIER UNDER DENNE LINJEN -->
[[Kategori:Flaggmaler| ]]

</includeonly>