Redigerer Mal:Kartposisjon+/dok

{{Dokumentasjonsunderside}}
<includeonly>{{Lua|Modul:Kartposisjon}}</includeonly>
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->

{{Kartposisjon+|England
|bredde=300
|alternativ=England_locator_map_with_North_East_England_highlighted.svg
|alt=Kart over England som viser beliggenheter for byer og slag. Bosworth ligger i midten, nordvest for London
|float=right
|undertekst=<span style="font-size:95%;">[[File:Battle icon active (crossed swords).svg|16px|link=]] [[Slaget ved Bosworth Field]]<br />[[File:Battle icon (crossed swords).svg|14px|link=]] andre slag</span> 
|steder=  {{Kartposisjon~ |England 
    |stedsnavn='''[[Slaget ved Bosworth Field|Bosworth]]'''
    |stedsnavn_str=86
    |posisjon=right
    |lat=52.591265
    |long=-1.410327
    |merke=Battle_icon_active_(crossed_swords).svg
    |merke_str=18
    |lenke=Slaget ved Bosworth Field
    }}

    {{Kartposisjon~ |England
    |stedsnavn=[[Slaget ved Blore Heath|Blore Heath]]
    |stedsnavn_str=86
    |posisjon=topp
    |lat=52.913611
    |long=-2.424722
    |merke=Battle_icon_(crossed_swords).svg
    |merke_str=16
    |lenke=Slaget ved Blore Heath
    }}
    
    {{Kartposisjon~ |England
    |stedsnavn=[[Slaget ved Barnet|Barnet]]
    |stedsnavn_str=86
    |posisjon=topp
    |lat=51.662233
    |long=-0.200039
    |merke=Battle_icon_(crossed_swords).svg
    |merke_str=16
    |lenke=Slaget ved Barnet
    }}

    {{Kartposisjon~ |England
    |stedsnavn=[[Slaget ved Stoke Field|Stoke]]
    |stedsnavn_str=86
    |posisjon=topp
    |lat=53.029058
    |long=-0.892586
    |merke=Battle_icon_(crossed_swords).svg
    |merke_str=16
    |lenk=Slaget ved Stoke Field
    }}

    {{Kartposisjon~ |England
    |stedsnavn=[[Slaget ved Tewkesbury|Tewkesbury]]
    |stedsnavn_str=86
    |posisjon=topp
    |lat=51.986389
    |long=-2.161389
    |merke=Battle_icon_(crossed_swords).svg
    |merke_str=16
    |lenke=Slaget ved Tewkesbury
    }}

    {{Kartposisjon~ |England
    |stedsnavn=Berwick
    |stedsnavn_str=86
    |posisjon=bunn
    |lat=55.771
    |long=-2.007
    |merke=Steel pog.svg
    |merke_str=6
    }}

    {{Kartposisjon~ |England
    |stedsnavn=London
    |stedsnavn_str=86
    |posisjon=bunn
    |lat=51.507778
    |long=-0.128056
    |merke=Steel pog.svg
    |merke_str=6
    }}

    {{Kartposisjon~ |England
    |stedsnavn=York
    |stedsnavn_str=86
    |posisjon=bunn
    |lat=53.958333
    |long=-1.096667
    |merke=Steel pog.svg
    |merke_str=6
    }}

    {{Kartposisjon~ |England
    |stedsnavn=Plymouth
    |stedsnavn_str=86
    |posisjon=bunn
    |lat=50.371397
    |long=-4.142431
    |merke=Steel pog.svg
    |merke_str=6
    }}

    {{Kartposisjon~ |England
    |stedsnavn=Poole
    |stedsnavn_str=86
    |posisjon=bunn
    |lat=50.71942
    |long=-1.98113
    |merke=Steel pog.svg
    |merke_str=6
    }}

    {{Kartposisjon~ |England
    |stedsnavn=Wem
    |stedsnavn_str=86
    |posisjon=venstre
    |lat=52.8555
    |long=-2.7211
    |merke=Steel pog.svg
    |merke_str=6
    }}

    {{Kartposisjon~ |England
    |stedsnavn=Northumberland
    |stedsnavn_str=86 |posisjon=right
    |lat=55.1
    |long=-1.68
    |merke=Steel pog.svg
    |merke_str=6
    }}

    {{Kartposisjon~ |England
    |stedsnavn=Shrewsbury
    |stedsnavn_str=86
    |posisjon=bunn
    |lat=52.7077
    |long=-2.7541
    |merke=Steel pog.svg
    |merke_str=6
    }}
   
    {{Kartposisjon~ |England
    |stedsnavn=Milford Haven
    |stedsnavn_str=86
    |posisjon=bottom
    |lat=51.71418
    |long=-5.04274
    |merke=Steel pog.svg
    |merke_str=6
    }}
}}

Denne malen plasserer en eller flere kartmarkører på et kart, med valgfrie stedsnavn/tilhørende tekst. Malen er i samme familie som {{tl|Kartposisjon}} og dokumentasjonen for denne kan være til nytte.
Denne malen benytter seg av en hjelpemal, {{tl|Kartposisjon~}}, en eller flere ganger for å generere et merke for hvert ønsket sted.

== Bruk==

{|
|- style="vertical-align:top;"
|<pre style="width:15em; margin-right:2em;">
{{Kartposisjon+ | {{{1}}}
| bredde        =
| float         =
| ramme         =
| undertekst    =
| alt           =
| relieff       =
| alternativ    =
| overlay_bilde =
| steder        =
}}</pre>
|<pre style="width:15em;">
{{Kartposisjon~| {{{1}}}
| stedsnavn     =
| stedsnavn_str =
| posisjon      =
| farge         =
| merke         =
| merke_str     =
| lenke         =
| lat_deg       =
| lat_min       =
| lat_sec       =
| lat_dir       =
| lon_deg       =
| lon_min       =
| lon_sec       =
| lon_dir       =
}}</pre>
|}

=== Parametre ===
{| class="wikitable" style="width:100%;"
|+ Parametre for Kartposisjon+
! Parameter
! Beskrivelse
|-
| <var>{{{1}}}</var>
| '''Påkrevd'''. Bruk navnet til kartet som første ubenevnte parameter. Hvis denne parameteren settes til, for eksempel, ''Norge'', vil data bli hentet fra [[Modul:Kartposisjon/data/Norge]]. Se [[#Eksempler|eksempler]] under.
|-
| <var>bredde</var>
| Angir bredde på kartet i piksler, og overskriver standardbredden. Ikke inkluder <code>px</code>, for eksempel <code>bredde=300</code>, ikke <code>bredde=300px</code>.
|-
| <var>standardbredde</var>
| Angir standard bredde på kartet i piksler, ment for bruk av maler som for eksempel infobokser. Standardverdien er 240. Ikke inkluder <code>px</code>, for eksempel <code>bredde=300</code>, ikke <code>bredde=300px</code>. Denne verdien multipliseres med parameteren <code>standardskala</code> angitt i individuelle kartmaler, hvis denne er angitt, for å oppnå passende størrelser for vertikale kart. For eksempel, hvis <code>standardbredde=200</code> og <code>standardskala=0.6</code> er gitt, vil et kart vises med 200 * 0.6 = 120 piksler.
|-
| <var>float</var>
| Angir posisjonen til kartet på siden. Gyldige verdier er <code>left</code>, <code>right</code>, <code>center</code> og <code>none</code>. Standardverdi er <code>right</code> (trenger ikke angis).
|-
| <var>ramme</var>
|  Angir fargen på den 1px tykke rammen rundt kartet. Standard er lysegrå (''lightgrey'', se [[webfarger]]). Hvis den settes til <code>none</code>, vil det ikke vises noen ramme. Denne parameteren brukes sjelden.
|-
| <var>undertekst</var>
| Teksten som vises under kartet. Ved å angi undertekst, vil kartet vises med ramme. Hvis <code>undertekst</code> er definert, men ikke gitt noen verdi, vil kartet ikke bli satt inn med ramme og ingen undertekst vil vises. Hvis <code>undertekst</code> ikke er definert, vil kartet bli satt inn uten ramme og en standard undertekst blir satt inn. Standard undertekst lages av <var>stedsnavn</var>-parameteren (eller sidenavn dersom stedsnavn ikke er angitt) og <var>navn</var>-parameteret fra kartdefinisjonsmalen. Se [[#Eksempler|eksempler]] under.
|-
| <var>alt</var>
| Alternativ tekst for kartet.
|-
| <var>relieff</var>
| Enhver ikke-blank verdi (1, ja, etc.) gjør at malen viser kartet som i kartdefinisjonsmalen er angitt under <var>relieff</var>.
|-
| <var>alternativ</var>
| Muliggjør bruk av alternativt kart. Kartet må ha de samme grensekoordinatene som kartposisjonsmalen.
|-
| <var>overlay_bilde</var>
| Muliggjør et lag oppå kartet. Denne parameteren brukes sjelden. Se eksempler på [[Mal:Kartposisjon+/overlay|Kartposisjon+/overlay]]
|-
| <var>steder</var>
| Angir en eller flere markører ved bruk av {{tl|Kartposisjon~}}.
|}

{| class="wikitable" style="width:100%;"
|+ Parametre for Kartposisjon~
! Parameter
! Beskrivelse
|-
| <var>{{{1}}}</var>
| '''Påkrevd'''. Bruk navnet til kartet som første ubenevnte parameter. Hvis denne parameteren settes til, for eksempel, ''Norge'', vil data bli hentet fra [[Modul:Kartposisjon/data/Norge]]. Se [[#Eksempler|eksempler]] under.
|-
| <var>stedsnavn</var>
| Teksten som vises i tilknytning til markøren; kan wikilenkes. Som standard vises bare markøren dersom <var>stedsnavn</var> ikke angis.
|-
| <var>stedsnavn_str</var>
|  Størrelsen på teksten i tilknytning til markøren, gitt som et prosenttall i forhold til normal tekststørrelse (<100 = mindre, >100 = større). Standardverdi er 90. Ikke inkluder <code>%</code>, for eksempel <code>stedsnavn_str=80</code>, ikke <code>stedsnavn_str=80%</code>. Hvis den settes til 0, vises teksten bare når man fører pekeren over markøren.
|-
| <var>posisjon</var>
| Tekstens posisjon i forhold til markøren. Gyldige verdier er <code>venstre</code>, <code>høyre</code>, <code>topp</code> og <code>bunn</code>. Standardverdien er <code>høyre</code>.
|-
| <var>farge</var>
| Bakgrunnsfargen for teksten (se [[webfarger]]. Standard er ingen bakgrunnsfarge, dvs kartet vises bak teksten.
|-
| <var>merke</var>
| Navnet på bildet som vises som markør. Standard er [[:File:Red pog.svg|Red pog.svg]] ([[File:Red pog.svg|8px]]). Se eksempler på [[Commons:Location markers]] og [[Commons:Category:Map icons]].
|-
| <var>merke_str</var>
| Størrelsen på markøren i piksler. Standard er 8. Ikke inkluder <code>px</code>, for eksempel <code>merke_str=10</code>, ikke <code>merke_str=10px</code>.
|-
| <var>lenke</var>
| Angir en wikilenke som følges hvis leseren klikker på markøren. Ikke inkluder <code>[[]]</code>, for eksempel: <code>lenke=Oslo</code>, ikke <code>link=[&#91;oslo&#93;]</code>.
|-
|<var>lat_deg</var>
| '''Påkrevd'''. Gradene for [[breddegrad]]. Denne verdien kan angis ved å bruke [[desimalgrader]], men da bør ikke minutter og sekunder angis.<ref group=Note name="precision" />
|-
| <var>lat_min</var>
| Minuttene for breddegraden.<ref group=Note name="precision" />
|-
| <var>lat_sec</var>
| Sekundene for breddegraden. Vanligvis ikke nødvendig.<ref group=Note name="precision" />
|-
| <var>lat_dir</var>
| N hvis nord (standardverdi) eller sør for sør for [[Ekvator]]. Andre verdier vil bli avvist. Ikke nødvendig hvis det benyttes desimalgrader med negative nummer for sørlige breddegrader).
|-
| <var>lon_deg</var>
| '''Påkrevd'''. Gradene for [[lengdegrad]]en. Denne verdien kan angis ved å bruke [[desimalgrader]], men da bør ikke minutter og sekunder angis.<ref group=Note name="precision" />
|-
| <var>lon_min</var>
| Minuttene for lengdegraden.<ref group=Note name="precision" />
|-
| <var>lon_sec</var>
| Sekundene for lengdegraden. Vanligvis ikke nødvendig.<ref group=Note name="precision" />
|-
| <var>lon_dir</var>
| E for øst (standardverdi) og W for vest for [[nullmeridianen]]. Andre verdier vil bli avvist. Ikke nødvendig hvis det benyttes desimalgrader med negative nummer for vestlige lengdegrader).
|}

Noter:
{{Reflist 
| group = Note 
| refs =
<ref group=Note name="precision">Passende nøyaktighet bør benyttes.</ref>
}}

== Eksempel 1 ==
Dette eksempelet angir ikke parameteren <code>undertekst</code>. Eksempelet viser bruk av standard undertekst. Merk at standardteksten er sidenavnet etterfulgt av teksten ''på kartet over ....'' og at plasseringen automatisk justeres dersom den er for nærme en av kantene. Eksempelet viser også kartets plassering på siden (senter).

<pre style="width:35em;">
{{Kartposisjon+ | Australia
| float=center
| steder=
  {{Kartposisjon~ | Australia
    | stedsnavn= Sydney
    | lat_deg = -33.86
    | lon_deg = 151.21 }}
  {{Kartposisjon~ | Australia
    | stedsnavn= Melbourne
    | lat_deg = -37.81
    | lon_deg = 144.96 }}
}}</pre>
{{Kartposisjon+ | Australia
| float=center
| steder=
  {{Kartposisjon~ | Australia
    | stedsnavn= Sydney
    | lat_deg = -33.86
    | lon_deg = 151.21 }}
  {{Kartposisjon~ | Australia
    | stedsnavn= Melbourne
    | lat_deg = -37.81
    | lon_deg = 144.96 }}
}}

== Eksempel 2 ==
Dette eksempelet bruker oppført men tom <code>undertekst</code>. Det viser koordinater via [[desimalgrader]] og 10px markører med en wikilenke.

{{Kartposisjon+ | Frankrike
| undertekst =
| steder =
  {{Kartposisjon~ | Frankrike
    | stedsnavn = Paris
    | posisjon = topp
    | merke_str = 10
    | lenke = Paris
    | lat_deg = 48.8567
    | lon_deg = 2.3508
  }}
  {{Kartposisjon~ | Frankrike
    | stedsnavn = Marseille
    | posisjon = topp
    | merke_str = 10
    | lenke = Marseille
    | lat_deg = 43.2964
    | lon_deg = 5.3610
  }}
}}
<pre style="width:35em;">
{{Kartposisjon+ | Frankrike
| undertekst =
| steder =
  {{Kartposisjon~ | Frankrike
    | stedsnavn = Paris
    | posisjon = topp
    | merke_str = 10
    | lenke = Paris
    | lat_deg = 48.8567
    | lon_deg = 2.3508
  }}
  {{Kartposisjon~ | Frankrike
    | stedsnavn = Marseille
    | posisjon = topp
    | merke_str = 10
    | lenke = Marseille
    | lat_deg = 43.2964
    | lon_deg = 5.3610
  }}
}}
</pre>

== Eksempel 3 ==
Dette eksempelet bruker <code>undertekst</code> med en angitt verdi. Det viser koordinater angitt vha grader, minutter og sekunder og et relieff-kart, lenkede markører og bakgrunnsfarge på markørtekst.

{{Kartposisjon+ | USA
| bredde = 300
| undertekst = Noen byer i USA
| relieff = 1
| steder =
  {{Kartposisjon~ | USA
    | stedsnavn = [[New York City|New York]]
    | posisjon =
    | farge = white
    | merke = Cyan pog.svg
    | alt = alt text for New York City
    | lenke = New York City
    | lat_deg = 40 | lat_min = 43 | lat_dir = N
    | lon_deg = 74 | lon_min = 0  | lon_dir = W
  }}
  {{Kartposisjon~| USA
    | stedsnavn = [[San Francisco]]
    | posisjon =
    | farge = white
    | merke = Purple pog.svg
    | alt = alt text for San Francisco
    | lenke = San Francisco
    | lat_deg = 37  | lat_min = 46 | lat_dir = N
    | lon_deg = 122 | lon_min = 25 | lon_dir = W
  }}
}}
<pre style="width:35em;">
{{Kartposisjon+ | USA
| bredde = 300
| undertekst = Noen byer i USA
| relieff = 1
| steder =
  {{Kartposisjon~ | USA
    | stedsnavn = [[New York City|New York]]
    | posisjon =
    | farge = white
    | merke = Cyan pog.svg
    | alt = alt text for New York City
    | lenke = New York City
    | lat_deg = 40 | lat_min = 43 | lat_dir = N
    | lon_deg = 74 | lon_min = 0  | lon_dir = W
  }}
  {{Kartposisjon~| USA
    | stedsnavn = [[San Francisco]]
    | posisjon =
    | farge = white
    | merke = Purple pog.svg
    | alt = alt text for San Francisco
    | lenke = San Francisco
    | lat_deg = 37  | lat_min = 46 | lat_dir = N
    | lon_deg = 122 | lon_min = 25 | lon_dir = W
  }}
}}
</pre>

== Template data ==
{{TemplateDataHeader}}
<templatedata>
{
	"description": "Denne malen plasserer en eller flere stedsmarkører på et kart.",
	"params": {
		"1": {
			"label": "Kartnavn",
			"type": "string",
			"required": true,
			"description": "Bruk navnet til kartet som første ubenevnte parameter. Hvis denne parameteren settes til, for eksempel, Norge, vil data bli hentet fra [[Modul:Kartposisjon/data/Norge]]. Se eksempler over"
		},
		"bredde": {
			"label": "Kartbredde",
			"type": "number",
			"description": "Angir bredde på kartet i piksler, og overkriver standardbredden. Ikke inkluder px, for eksempel bredde=300, ikke bredde=300px."
		},
		"standardbredde": {
			"label": "Standardbredde",
			"type": "number",
			"description": "Angir standard bredde på kartet i piksler, ment for bruk av maler som for eksempel infobokser. Standardverdien er 240. Ikke inkluder px, for eksempel bredde=300, ikke bredde=300px. Denne verdien multipliseres med parameteren standardskala angitt i individuelle kartmaler, hvis denne er angitt, for å oppnå passende størrelser for vertikale kart. For eksempel, hvis standardbredde=200 og standardskala=0.6 er gitt, vil et kart vises med 200 * 0.6 = 120 piksler."
		},
		"float": {
			"label": "Posisjon",
			"type": "string",
			"description": "Angir posisjonen til kartet på siden. Gyldige verdier er left, right, center og none. Standardverdi er right."
		},
		"ramme": {
			"label": "Rammefarge",
			"type": "string",
			"description": "Angir fargen på den 1px tykke rammen rundt kartet. Standard er lysegrå (lightgrey). Hvis den settes til none, vil det ikke vises noen ramme. Dette parameteret brukes sjelden. "
		},
		"undertekst": {
			"label": "Undertekst",
			"type": "string",
			"description": "Teksten som vises under kartet. Ved å angi undertekst, vil karet vises med ramme. Hvis undertekst er definert, men ikke gitt noen verdi, vil kartet ikke bli satt inn med ramme og ingen undertekst vil vises. Hvis undertekst ikke er definert, vil kartet bli satt inn uten ramme og en standard undertekst blir satt inn. Standard undertekst lages av stedsnavn-parameteren (eller sidenavn dersom stedsnavn ikke er angitt) og navn-parameteren fra kartdefinisjonsmalen. Se eksempler under."
		},
		"alt": {
			"label": "Alternativ tekst for kartet.",
			"type": "string",
			"description": "Alternativ tekst for kartet."
		},
		"relieff": {
			"label": "Relieff-kart",
			"type": "string",
			"description": "Enhver ikke-blank verdi (1, ja, etc.) gjør at malen viser kartet som i kartdefinisjonsmalen er angitt under relieff."
		},
		"alternativ": {
			"label": "Alternativt kart",
			"type": "string",
			"description": "Muliggjør bruk av alternativt kart. Kartet må ha de samme grensekoordinatene som kartposisjonsmalen."
		},
		"overlay_bilde": {
			"label": "Ekstra lag",
			"type": "string",
			"description": "Muliggjør et lag oppå kartet. Denne parameteren brukes sjelden."
		},
		"steder": {
			"label": "Stedsmarkører",
                        "type": "string",
			"required": true,
			"description": "Angir en eller flere markører ved bruk av {{Kartposisjon~}}."
		}
	}
}
</templatedata>

== Se også ==
*{{tl|Kartposisjon}}
*{{tl|Kartposisjon~}}
*{{tl|Kartposisjon mange}}

<includeonly>
<!-- KATEGORIER OG INTERWIKIER UNDER DENNE LINJEN -->
[[Kategori:Kartmaler|{{PAGENAME}}]]
</includeonly>