Vis kilden til Mal:Flagg/dokumentasjon

{| class="beskjedboks diskusjon"
|-
| [[Fil:Dialog-warning.svg]]
| Denne malen brukes på mange tusen sider på Wikipedia. For å beskytte mot vandalisme er den derfor låst slik at bare administratorer kan redigere den. Om du vil legge til noen flagg kan du legge dem til på '''[[Mal:Flaggtest]]''', som er en kopi av denne, men ikke brukes på mange sider. Denne malen vil bli oppdatert fra den maks én gang per måned.
|}

=== Bruk ===
Følgende parametere kan brukes med denne malen:

;<span style="color:#339;">(1)</span>
:Dette er den eneste påkrevde parameteren. Den kan være en landskode ([[ISO 3166-2]] alpha-2 eller alpha-3), men helst det fulle navnet til et land, eller et annet område (f.eks. FN, EU, England, Massachusetts, Britisk Colombia osv. osv.). Om man kun har med denne parameteren vil kun et lite flagg vises: '''<code><nowiki>{{ flagg |</nowiki> <span style="color:#339;">Turkmenistan</span> <nowiki>}}</nowiki></code>''' blir til {{flagg|Turkmenistan}}.
;<span style="color:#393;">(2)</span>
:Denne parameteren kan være to forskjellige ting. Den vanligste bruken er nok at den er <code>lenke</code>. Da vil man ikke bare få opp et flagg, men også en lenke til landets artikkel: '''<code><nowiki>{{ flagg |</nowiki> <span style="color:#339;">De søramerikanske landenes union</span> | <span style="color:#393;">lenke</span> <nowiki>}}</nowiki></code>''' blir til {{flagg|De søramerikanske landenes union|lenke}}.
:Eventuelt kan denne parameteren være en angivelse for alternative flagg. Om man for eksempel skal vise [[Lesothos flagg]] som ble brukt fra 1967 til 2006, kan man skrive '''<code><nowiki>{{ flagg |</nowiki> <span style="color:#339;">Lesotho</span> | <span style="color:#393;">2006</span> <nowiki>}}</nowiki></code>''', som vil bli {{flagg|Lesotho|2006}}. Merk at dette ''ikke'' kan kombineres med '''<code style="color:#393;">lenke</code>'''; for å få med lenke må man da bruke vanlig lenkesyntaks: '''<code><nowiki>{{ flagg |</nowiki> <span style="color:#339;">Lesotho</span> | <span style="color:#393;">2006</span> <nowiki>}} [[Lesotho]]</nowiki></code>'''. Årstallet som brukes er vanligvis det årstallet et flagg gikk ut av bruk.
;<span style="color:#933;">(3)</span>
:Denne parameteren kan kun kombineres med '''<code style="color:#393;">lenke</code>'''; den vil være alternativ lenketekst for en lenke. For eksempel blir '''<code><nowiki>{{ flagg |</nowiki> <span style="color:#339;">Forente nasjoner</span> | <span style="color:#393;">lenke</span> | <span style="color:#933;">FN</span> <nowiki>}}</nowiki></code>''' til {{flagg|Forente nasjoner|lenke|FN}}.
;størrelse
:Om man vil ha en annen størrelse enn standarden (22px), angir man det med '''<code>størrelse</code>''': '''<code><nowiki>{{ flagg |</nowiki> <span style="color:#339;">Vanuatu</span> | størrelse=30px <nowiki>}}</nowiki></code>''' blir {{flagg|Vanuatu|størrelse=30px}}.
;attributter
:{{flagg|Mongolia|attributter=thumb{{!}}right|størrelse=100px}} Om man vil endre andre attributter enn størrelsen kan man bruke '''<code>attributter</code>''': '''<code><nowiki>{{ flagg |</nowiki> <span style="color:#339;">Mongolia</span> | attributter=thumb<nowiki>{{!}}</nowiki>right | størrelse=100px <nowiki>}}</nowiki></code>''' blir som eksempelet til høyre.

=== Hvorfor bruke denne malen ===
Denne malen erstatter det tidligere systemet, hvor man hadde maler for hvert enkelt land. Man brukte ISO 3166-1 alpha-3-kodene som malnavn; <code><nowiki>{{SWE}}</nowiki></code> for {{flagg|Sverige}}, <code><nowiki>{{CIV}}</nowiki></code> for {{flagg|Elfenbenskysten}} osv. Med dette systemet skriver man i stedet <code><nowiki>{{flagg|Sverige}}</nowiki></code> og <code><nowiki>{{flagg|Elfenbenskysten}}</nowiki></code>. Det fører til litt mer tekst i kildekoden, men man slipper å huske alle ISO 3166-1-kodene til hvert land i verden. Dette systemet har også rom til diverse aliaser, slik at man kan skrive både <code><nowiki>{{flagg|NO}}</nowiki></code>, <code><nowiki>{{flagg|NOR}}</nowiki></code>, <code><nowiki>{{flagg|Norge}}</nowiki></code> og <code><nowiki>{{flagg|Noreg}}</nowiki></code> og få samme resultat. (Bruk av ISO-koder i malen anbefales imidlertid ikke, da det ikke fungerer med <code style="color:#393;">lenke</code>, og gir ISO-koden som bildetittel.)

Dette systemet er også enklere å vedlikeholde, da det er én mal som inneholder all informasjonen, i stedet for at det er spredt ut over hundrevis av maler.

=== Hvordan legge til flere flagg i malen ===
Om det er et flagg du ønsker å legge inn som ikke er i malen fra før, legg det til på [[Mal:Flaggtest]] ved å redigere riktig seksjon og følge det eksisterende mønsteret. Pass på å søke etter filnavnet til flagget du ønsker å legge inn &ndash; det kan hende det ligger der allerede under et annet navn enn det du trodde det ville ha. Om det er saken kan du legge til det navnet du forventet at flagget ville ha som et alias.

Om du synes syntaksen i malen er for vanskelig, og ikke har lyst til å redigere den selv, er det bare å legge til en forespørsel om å legge til et flagg på [[Maldiskusjon:Flagg|malens diskusjonsside]], så vil noen andre legge det inn for deg.