Ĝi enhavas informojn pri la uzado de ŝablono, ĝiajn kategoriojn kaj eble eĉ interlingvajn ligilojn (Prefere ili estus aranĝataj per VP:VD). Kaj ĝi ne estas enhavo de la ŝablona paĝo mem.
Ĉi tiu ŝablono estas uzata sur 22000+ paĝoj Por eviti iujn ĝenojn kaj precipe servilan ŝargon, ŝanĝoj estu unue testataj en /provejo de la ŝablono aŭ sur subpaĝo por /testoj, aŭ en via vikipediista nomspaco.
Testitaj ŝanĝoj tiam povas esti aldonataj en nur unuopa redakto al ĉi tiu ŝablono. Kiel komplezo por aliaj uzantoj, bonvolu diskuti iujn ŝanĝojn sur la diskuta paĝo antaŭ ol enmeti ilin.
Ĉi tiu ŝablono kreas mapon kun markilo. Por tio ĝi per helpo de subŝablonoj transkalkulas koordinatojn al poziciaj valoroj por la markilo. Krome la markilo estas difinebla.
{{Situo sur mapo|<Nomo de la mapo>
<!-- Framo -->
|Bordo = <!-- Frama koloro aŭ none (neniu) -->
|Fono = <!-- Fonkoloro, defaŭlta valoro #F9F9F9 (transparenta) -->
|Titolo = <!-- Subskribo de la mapo -->
|Loko de titolo = <!-- Pozicio de la titolo. Eblas "center" aŭ "centre". Defaŭlte aperas maldekstre. -->
|Floso = <!-- left aŭ right La mapo estas rektigata maldekstre aŭ dekstre.
center La mapo estas bildigata sur bloka ebeno (de tabelo) kaj centriĝas.
inline En aktualaj foliumiloj la mapo estas bildigata sur inline-ebeno kaj ne
centriĝas, sed povas esti rektigata per text-align.
En malnoviĝintaj foliumiloj, kiuj ne subtenas la CSS-trajton display:inline-table
(IE <= 7, Firefox <= 2), restas ĉe bloka bildigado kun 1em
minimala distanco maldekstre kaj dekstre!
none Kiel center, sed kun 1em minimuma distanco maldekstre kaj dekstre anstataŭ centriĝo. -->
|Larĝo = <!-- ### (maksimuma) larĝeco de la mapo
x### maksimuma alteco,
###x### maksimuma ĉirkaŭa kvarangulo
= ›malplena‹ thumbsize-laŭuzanta valoro
default 240 pikseloj -->
|Mapospeco = reliefo <!-- Uzas fizikan mapon por la bildigo, se ĉi tiu ekzistas.
Alie estas uzata la normala mapo -->
|Alia_mapo = <!-- Croatia map modern.png (ŝanĝas la fonan mapon, Koordinatoj de la framo
estas transprenataj de la ĝenerala nomo de la mapo – ordono estu nur uzata de
ŝablonoj, ekz. informkestoj kun malsamaj regionaj reliefigoj -->
|Teksto = <!-- Teksto ĉe la markiga punkto -->
|Teksto-ampl = <!-- Grandeco de la skribo en procento -->
|Teksto-loko = <!-- left, right, top, bottom aŭ none –
Pozicio de la priskribo rilate al la markiga punkto, defaŭlta valoro right -->
|Linisalto = <!-- auto aŭ manual, defaŭlta valoro auto - linisalto de la teksto
auto:aŭtomata, manual:linisalto estas kaŭzata per alskribo de "<br />" en la teksto -->
|Marko = <!-- Dosiera nomo por la markiga punkto, defaŭlta valoro estas Red pog.svg -->
|Markospeco = <!-- Ĝi elektas markon laŭ speco, kiu estas difinita en {{Situo sur mapo/marko}}. -->
|Marko-ampl = <!-- Grandeco de la markiga punkto en pikseloj, defaŭlta valoro 8 -->
|Marko-celo = <!-- Ligila celo de la marko, defaŭlta valoro estas Geo-referenco -->
|Fono = <!-- Fonkoloro por la priskriba teksto, defaŭlta valoro transparent -->
<!-- Koordinatoj ligitaj al la markilo -->
|Lat = <!-- Latitudo en decimala valoro aŭ G/M/S (angle D/M/S) -->
<!-- |Lat-g= |Lat-m= |Lat-s= |Lat-dir= malnova! -->
|Lon = <!-- Longitudo en decimala valoro aŭ G/M/S (angle D/M/S) -->
<!-- |Lon-g= |Lon-m= |Lon-s= |Lon-dir= malnova! -->
<!-- La sekvaj parametroj ne povas esti tradukataj, ĉar ili influas la ligilon al
"toolserver" kaj la ŝablona kodo jam estas sufiĉe komplika. -->
|type = <!-- Typ -->
|pop = <!-- Loĝantoj -->
|elevation = <!-- Alteco -->
|dim = <!-- Dimensio -->
|region = <!-- ISO 3166-1/2 Kodo -->
|globe = <!-- Ĉielkorpo -->
|name = <!-- Nomo de objekto -->
<!-- Por la ŝablono {{Koord}} -->
|montrukoordinatojn = <!-- titolo (defaŭlte) - entekste - entekste,titolo - ne -->
|koordparam = <!-- koordinataj parametroj -->
}}
La parametro montrukoordinatojn ebligas ŝanĝi la elmontron de la koordinatoj per voko de {{Koord}}. Ĝi povas esti
titolo (defaŭlte) : la koordinatoj estas montritaj ĉe la titolo
entekste : la koordinatoj estas montritaj post la teksto de la mapo
entekste,titolo : la koordinatoj estas montritaj en ambaŭ lokoj
ne : la koordinatoj estas montritaj nenie
La parametro koordparam ebligas enigi koordinatajn parametrojn kiaj tipo, regiono. Rekonitaj de la mapservilo, provizitaj en formato parametro:valoro kaj interdisigitaj de suba streketo '_'. Komunaj koordinataj parametroj inkluzivas tipon, regionon, kaj skalon uzenda per la anglaj vortoj type, region, scale. Vidu
La koordinatoj povas esti difinataj diversmaniere, do per 8 aŭ per 2 parametroj:
Ok parametroj: la numeraj parametroj toleras nur pozitivajn valorojn! Ĉe la direktoj funkcias kaj E kaj O por oriento resp. kaj W kaj U por okcidento.
Kvar difinas la latitudon de la marko.
Lat-g
Lat-m
Lat-s
Lat-dir
Kvar difinas la longitudon de la marko.
Lon-g
Lon-m
Lon-s
Lon-dir
Nur du parametroj: ili toleras ankaŭ negativajn valorojn, sed nur, se oni ne uzas / por apartigi la gradojn disde la minutoj, sekundoj kaj direkto. Por la direkto nur eblas uzi la literojn E (por oriento), W (por okcidento), S (por sudo) kaj N (por nordo). U kaj O ne funkcias pro teknikaj kialoj. - Ĉi tiu maniero estas jam uzata en {{Informkesto insularo}}, kvankam tie la parametroj estas latitudo kaj longitudo.
Großglockner (Pozicio estas la centro de la baza linio)
Markiloj estas metataj ĉe tio kun sia centro al la dezirata koordinato. Por ke tio korekte funkciu, ĉe markiloj la larĝeco kaj longeco devas esti samaj, la ĉirkaŭanta kvarangulo do havas kvadratan formaton. Ĉe tio oni atentu, ke la optika centro ne ĉiam estas identa kun la geometria centro. Tiel kaŭzas la uzado de la dosiero por montaroj alian impreson ol de la dosiero (denove unu apud alia ), centro estas en la unua kazo la fokuso, en la dua kazo centro de la bazo kaj ĝi respondas ĉe tio optikan atendon por montaro ja pli bone. En la ekzemplo kuŝas la vera pozicio nur iomete sub la limo al Salcburgio. Ĉe la dua ikono Dosiero:RedMountain.svg metiĝas la centro de la bazo en la mezon de la bilda dosiero, per tio ke la ĉirkaŭantaj terenoj estas aldonataj travideble.
Subŝablonoj devas esti nomataj laŭ la skemo „Ŝablono:Situo sur mapo <nomo de mapoj>“. Kondiĉo, por krei novan subŝablonon, estas bildo, kiu montras la mapon, kies mapa projekcio (germane de:Kartennetzentwurf) estas konata aŭ povas esti taksata almenaŭ laŭeble ekzakte.
Nomo (alilingve name) priskribas la regionon, kiun la mapo montras, Kapvorto (alingve lemma) estas la titolo de la koncerna artikolo de la Vikipedio. La parametro Kapvorto povas ankaŭ foresti, se samas al Nomo.
Supro (alilingve top), Malsupro (alilingve bottom), Maldekstro (alilingve left) kaj Dekstro (alilingve right) estas koordinatoj de la mapaj limoj. La koordinatoj devas esti donataj decimale. La ĉielaj direktoj estas distingataj per la antaŭsigno (nordo kaj oriento pozitivaj, sudo kaj okcidento negativaj).
Bildo (alilingve image) estas la nomo de la bilda dosiero.
zono indikas la zonon de la koncerna mapo. Se temas pri lando, ĝi havas la valoron landoj. Nuntempe (do, ekde marto 2014) estas uzata de {{situo sur mapo}}, se oni uzas la nedevigan parametron Mapo en angulo. Se la nomita parametro restas malplena, tiam aŭtomate aperas mapo en angulo per helpo de {{surmapo}}. Ĉi tiu kategorio enhavas ĉiujn mapajn ŝablonoj kun la parametro zono, dum ke alia kategorio enhavas ĉiujn tiajn ŝablonojn sen ĝi.
Bildolarĝo kaj Bildoalto estas uzataj de la ŝablono {{Kartografia klarigo}}. Se ili mankas, la rilata ŝablono estas aldonata al la kategorioj
Se ekzistas en la subŝablono krom normala, politika pozicia mapo ankaŭ fizika mapo kun la samaj mapaj limoj kaj sama mapa projekcio, devas esti aldonata la parametra kombino Bildo|reliefo. Ĉe mankanta dua parametro aŭ nekonataj mapaj tipoj estas aldonata ĉiam la normala, politika pozicia mapo kiel defaŭlta:
Mapoj en ortografia projekcio (germane Quadratische Plattkarten) sin ofertas, se regiono, kiu estas surbildigata, ne havas tro malproksiman de la ekvatoro distancon kaj ne havas tro grandan dimension. Ili plej facile estas aranĝeblaj kaj povas esti uzataj en tre multaj Vikioj. Mapoj, kiuj krucas la 180an longan gradon, estas aŭtomate rekonataj kaj korekte traktataj; sed tio ne validas en ĉiuj aliaj Vikioj.
Por kelkaj regionoj kiel Kanado aŭ Ruslando aliaj mapaj projekcioj estas pli taŭgaj; Polusaj regionoj entute ne povas estis surbildigataj kiel mapoj en ortografia projekcio. La mapa parto de la aliaj mapaj projekcioj ne povas esti priskribata per la parametroj Supro, Malsupro, Maldekstro kaj Dekstro, sed bezonas specifajn parametrojn. Per helpo de ĉi tiu parametroj kaj matematikaj formuloj povas esti transkalkulata la geografia pozicio en relativan pozicion sur la bildo. La nova ŝablono devas por tio kalkuli laŭ la parametroj x kaj y la relativan pozicion de la markilo en procentoj. x havas valoron de 0 je la maldekstra ĝis 100 je la dekstra, y de 0 je la supra ĝis 100 je la malsupra rando de la mapo. Ĉe la kalkulado estas transdonata la latitudo kiel parametro {{{2}}} kaj la longitudo kiel parametro {{{3}}}.
Por la kutimaj projekciomanieroj ekzistas projekciaj ŝablonoj, kiuj transprenas la transkalkuladon. Por tio estas enmetata la koncerna projekcia ŝablono kune kun la specifaj parametroj de la mapa parto. Ekz:
Por pliaj projekcimanieroj aŭ specialaj kazoj povas esti difinata la relativa pozicio ankaŭ per po unu formulo por x kaj y rekte en la ŝablono, kiel ekzemple videblas en la fontoteksto de {{Situo sur mapo Antarkto}}.
Per la projekcia ŝablono {{Situo sur mapo/kun krommapo}} povas esti uzataj ankaŭ poziciaj mapoj kun krommapoj. Ĉe tio povas esti surbildigataj kaj ĉefa kaj kroma mapoj kiel plata mapo aŭ en ĉiu alia el la supre listigitaj projekciaj manieroj. La disbranĉiĝo, ĉu la pozicio estas montrata sur la ĉefa aŭ sur la kroma mapo, devas okazi en la ŝablono surbaze de libere elektita, matematike laŭeble facile kontrolebla kondiĉo. En la ekzemplo {{Situo sur mapo Brazilo Pernambuko}} estas montrataj ĉiuj pozicioj oriente de la 33° de okcidenta longitudo sur la kroma mapo.
Por aldoni dokumentadon, bonvolu uzi la sekvan kodon tuj post la supre nomita kodo:
<noinclude>{{Situo sur mapo/informoj}}</noinclude>
Inter la tiea ŝablono kaj </noinclude>-kodo povas stari aldonaj kategorioj kaj intervikiaj ligiloj. Eventualaj ekzemploj pri uzado staru post la ŝablono, sed antaŭ la aldonaj kategorioj kaj intervikiaj ligiloj.
Por regionoj, provincoj ktp. sen aparte difinita flago en la ŝablono {{flago}} bonvolu uzi la jenon:
<noinclude>{{Situo sur mapo/informoj|sen-flago=jes}}</noinclude>
Atentu
Atentu, ke kreata subŝablono provizore iom fuŝe aspektas pro la maniero, laŭ kiu funkcias {{Situo sur mapo/informoj}}. Vi povas korekti tion laŭ unu el la jenaj manieroj::
{{Situo sur mapo | Germanio Ŝlesvig-Holstinio
|Teksto=Husum
|Lat=54/29/37
|Lon=9/03/04
|region=DE-SH
|Titolo=Husum estas urbo
|montrukoordinatojn = ne
}}
Lat kaj Lon estas difinitaj laŭ G/M/S-skemo.
region kaŭzas aldonon de la koncerna valoro al la ligilo al "Toolserver". En la ekzemplo: region:DE-SH, kiu aperas en la ligilo antaŭ type:landmark. (Bonvolu atenti, ke "Toolserver" nur komprenas anglajn vortojn tie.)
{{Situo sur mapo | Kroatio
| Lat = 44.44
| Lon = <!--ekster la mapo-->11.05
| Teksto = Rubikono
| Teksto-loko = right
| Larĝo = 200
| Floso = right
| Titolo = Rubikono estas en Italujo (ekster la mapo)
| montrukoordinatojn = ne
}}
Atentu, ke la parametro mapospeco kun la valoro reliefo funkcias kiel en la germana kaj la sorabaj vikipedioj. Tial parametro reliefo, kiel en la angla vikipedio, ne necesas.
Sude de la ekvatoro, okcidente de la nula meridiano
{{Situo sur mapo | Bolivio
|Teksto=La Paz
|Lat=16/29/39/S
|Lon=68/08/51/W
|Pozicio=right
|Larĝo=250
|Floso=right
|Titolo=Situo de la urbo La Paz en Bolivio
|montrukoordinatojn=ne
}}
{{Situo sur mapo | Bolivio
|Teksto=La Paz
|Lat=16/29/39/S
|Lon=68/08/51/W
|Pozicio=right
|Larĝo=250
|Floso=right
|Titolo=Situo de la urbo La Paz en Bolivio
|Markospeco=ĉefurbo
|montrukoordinatojn=ne
}}
Ebla lokigo de la priskribo per la parametro Pozicio
Kiel defaŭlto la priskribo estas montrata en la malsupraj du trionoj de la mapo oblikve super la pozicio 10 resp. 2 (depende de la mapa duono) kaj en la supra triono oblikve sub la pozicio 8 resp. 4.
Kvankam la poziciaj mapoj subtenas la markigon per pluraj punktoj, ili ne taŭgas kiel pentrilo, ekzemple por marki la iradon de rivero per multaj punktoj. Ĉiu pentrita punkto plialtigas la ŝarĝotempon. En tiaj kazoj estas pli bone, uzi apartan mapon aŭ pozician mapon kun konvena marko.
Kelkaj loko en Germanujo
{{ Situo sur mapo/+
| Germanio
| Larĝo=375
| Floso=right
| Titolo=Kelkaj lokoj
| lokoj={{ Situo sur mapo/~
| Germanio
| Teksto=la teksto de la unua
lokonomo troviĝas maldekstre
de la punkto
| Pozicio=left
| Lat=53/10/14
| Lon=09/34/51
| region=DE
}}
{{ Situo sur mapo/~
| Germanio
| Teksto=la dua loko ne havas
tekston por la lokonomo
| Pozicio=none
| Lat=52/52/14
| Lon=10/44/51
| region=DE
}}
{{ Situo sur mapo/~
| Germanio
| Teksto=la teksto de la tria<br />loko
troviĝas sub la punkto<br />kun
manuala linisalto
| Pozicio=bottom | Linisalto=manual
| Lat=51/55/14
| Lon=11/12/51
| region=DE
}}
{{ Situo sur mapo/~
| Germanio
| Teksto=la teksto de la kvara
lokonomo troviĝas dekstre
de la punkto
| Pozicio=right
| Lat=49/55/14
| Lon=10/54/51
| region=DE
}}
{{ Situo sur mapo/~
| Germanio
| Teksto=la teksto de la kvina
lokonomo troviĝas super
la punkto
| Pozicio=top
| Lat=47/50/08
| Lon=10/52/16
| region=DE
}}
}}
Ekde la 20-a de marto 2014 eblas plia trajto, nome malgranda mapo en angulo super granda mapo.
Se la baza mapo estas tiu de lando, tiam la parametro "Mapo en angulo" sen donita valoro aperigas mapon de la tuta mondo. Bonvolu atenti, ke tio nur funkcias, se la koncerna lokumilo enhavas la parametron "zono" (Vidu la rilatan kategorion).
{{Situo sur mapo
|Essonne
|Lat=48.6173213
|Lon=2.4085969
|Teksto=Courcouronnes
|Teksto-loko=none
|Mapo en angulo=
|Mapospeco=reliefo
|Titolo=Lokigo de Courcouronnes en Essonne.
|montrukoordinatojn=ne
}}
Por aperigi mapon de la mondo, necesas difini la valoron mondo en la nova parametro "Mapo en angulo".
{{Situo sur mapo
|Essonne
|Lat=48.6173213
|Lon=2.4085969
|Teksto=Courcouronnes
|Teksto-loko=none
|Mapo en angulo=mondo
|Titolo=Lokigo de Courcouronnes en Essonne.
|montrukoordinatojn=ne
}}
{{Situo sur mapo
|Francio
|Lat=48.390833
|Lon=-4.485556
|Teksto=Brest
|Teksto-loko=none
|Mapo en angulo=Eŭropo
|Mapospeco=reliefo
|Titolo=Lokigo de Brest en Francio.
|montrukoordinatojn=ne
<!--la jenaj parametroj nur efikas kune kun "Mapo en angulo"-->
|mapo=Francio
|aldono={{Punkto sur mapo|Eŭropo|48.390833|-4.485556|Brest|testo}}
|dosiero=France in Europe (relief) (-mini map).svg
|stilo=;
}}
Noto : uzu stilo=; por subpremi la ruĝan kadron difinata defaŭlte.
Ekde la 13-a de junio 2019 funkcias pli konvena malaperigo de la ruĝa kadro per la parametro kadro kun la valoro neniu, jene:
{{Situo sur mapo
|Francio
|Lat=48.390833
|Lon=-4.485556
|Teksto=Brest
|Teksto-loko=none
|Mapo en angulo=Eŭropo
|Mapospeco=reliefo
|Titolo=Lokigo de Brest en Francio.
|montrukoordinatojn=ne
<!--la jenaj parametroj nur efikas kune kun "Mapo en angulo"-->
|mapo=Francio
|aldono={{Punkto sur mapo|Eŭropo|48.390833|-4.485556|Brest|testo}}
|dosiero=France in Europe (relief) (-mini map).svg
|kadro=neniu
}}
{{Situo sur mapo|Egiptio|Lat=25.69689|Lon=32.64219|name=Luxor |Teksto=[[Luxor]] |Larĝo=300x300 |Titolo=Lokoj en [[Egiptio]] | Floso= right
| montrukoordinatojn=ne
|lokoj=
{{Situo sur mapo/Loko|Egiptio|Lat=30.05|Lon=31.25|name=Kairo|Teksto=[[Kairo]]}}
{{Situo sur mapo/Loko|Egiptio|Lat=31.2|Lon=29.9167|name=Alexandria|Teksto=[[Alexandria]]|Teksto-loko=left}}
{{Situo sur mapo/Loko|Egiptio|Lat=24.0667|Lon=32.9167|name=Assuan|Teksto=[[Assuan]]}}
{{Situo sur mapo/Loko|Egiptio|Lat=25.48752|Lon=28.98339|name=Mūṭ|Teksto=[[Mūṭ|Mut]]}}
{{Situo sur mapo/Loko|Egiptio|Lat=28.6161|Lon=33.0876|name=Golf von Suez|Teksto=Golfo de<br />Suez| Teksto-stilo=<!--waterbody-->bold/italic/letterspacing/uppercase |Teksto-koloro=#2A6DB5| Linisalto=manual| Teksto-loko=bottom | Marko=Transparent.gif<!--none-->}}
{{Situo sur mapo/Objekto|Maldekstre=25px|Supre=120px|Objekto=Egiptio|Objekto-stilo=regiono}}
{{Situo sur mapo/Objekto|Maldekstre=25px|Malsupre=25px|Objekto={{Situo sur mapo|Mondo|Lat=30.05|Lon=31.25|name=Kairo|Teksto=Kairo|Larĝo=125x125|mapStyle= border: 1px solid #a0a0a0; | montrukoordinatojn=ne|senombre=jes}} }}
}}
Por regionoj grandaj kaj proksimaj al polusoj bezonata mapa projekcio faras grandan malformigon.
La parametroj Lat-g, Lat-m, Lat-s, Lon-g, Lon-m kaj Lon-s ne toleras negativajn valorojn. Do por okcidentaj lokoj estu uzata Lat-dir=U aŭ Lat-dir=W kaj por sudaj lokoj estu uzata Lon-dir=S.
Kaj la parametroj Lat-m, Lat-s, Lon-m kaj Lon-s nur toleras valorojn de 0 ĝis 59, tiel ke 60 jam estas tro granda.
{{Punkto sur mapo}} Ĝi estas malpli kompleksa, havas alian sintakson, sed ĝi uzas la samajn lokumilojn.
{{Informkesto/Geografia lokigo multobla}} Ĝi estas uzata ĉefe en la fontokodo de informkestoj, por aperigi pli ol unu mapon kun markilo. Krome ili estas ŝanĝeblaj per ĝavaskripto.
{{Mapo en angulo}} ebligas meti malgrandan mapon en unu el la kvar anguloj.
{{Kartografia klarigo}} ebligas meti klarigon pri la signifoj de diversaj markiloj.
por montaroj alian impreson ol de la dosiero 
(denove unu apud alia 
.svg)
_(-mini_map).svg)
