Dokumentado

Ĉi tiu ŝablono havassubpaĝon, kiu enhavas pliajn uzajn ekzemplojn. Ili troviĝas sur aparta paĝo, ĉar alikaze la supre dekstre videblaj koordinatoj aperus unu sur alia aŭ miksiĝus kun la informo pri mankantaj koordinatoj.

Ŝablono

Pri la projekto Aplikoj Helpo Geografia lokigo Ŝablono:Koordinato Ŝablono:Koord Ŝablono:Situo sur mapo Ŝablono:Punkto sur mapo Ŝablono:GeoTemplate Kunlaboro

v •d •r

Ĉi tiuŝablono ebligas enmeti koordinatojn (kaj nedevige eĉ mapojn) en artikolojn. Por la mapo estas uzata interne la ŝablono {{situo sur mapo}}.

Bonvolu atenti, ke ĉi tiu ŝablono por koordinatoj kun|article=/ resp.|artikolo=/ ne estu samtempe uzata kune kun informkesto. La informkesto mem jam povas aperigi supre dekstre la koordinatojn kun ligilo al "Geohack". Vidu ankaŭpli detalan informon. Se vi havas demandojn pri tio, vi povas demandi en ladiskutopaĝo de la ŝablona projekto aŭ en ladiskutopaĝo de la projekto pri geografiaj koordinatoj.

Kelkaj parametroj povas esti transdonataj esperante aŭ angle. Sed prefere ne mikse, por eviti problemojn. Pro teknikaj kialoj kaj jam sufiĉe komplika kodigo certaj parametroj ne estas tradukitaj, nome tiuj, kiuj ankaŭ ĉe {{situo sur mapo}} restas anglaj. Krome iliaj valoroj devas esti en la angla, ĉar ili per helpaj ŝablonoj estas almetataj al la ligilo por "Toolserver"Geohack. Ĝi nur "komprenas" la anglajn vortojn.

Esperante (escepte de "Toolserver"aj parametroj)

• por meti en artikolon koordinaton:

{{Koordinato|latitudo=|longitudo=|type=|region=}}

• por meti koordinatan ligilon en artikolan tekston:

{{Koordinato|latitudo=|longitudo=|type=|region=|teksto=|name=}}

Angle

• por meti en artikolon koordinaton:

{{Coordinate|NS=|EW=|type=|region=}}

• por meti koordinatan ligilon en artikolan tekston:

{{Coordinate|NS=|EW=|type=|region=|text=|name=}}

→Mallonga gvidlinio

La parametroNS aŭ esperante eĉlatitudo difinas lalatitudon de la objekto. La parametroEW aŭ esperante eĉlongitudo difinas lalongitudon de la objekto.

NS staras por North/South (nordo kaj sudo) kajEW por East/West (oriento kaj okcidento). La indiko estas ĉiufoje ebla ne nur decimale engrado sed ankaŭ en „Degrees/Minutes/Seconds“-formato; la valoroj rilatas al laWGS84-referenco. La indiko delatitudo kajlongitudo estas deviga. Se mankas unu el tio, tio estas interpretata kielpeto pri geografia lokigo.

La decimala formatigo estas direktata al nordo resp. oriento, negativaj valoroj rilatas al la suda hemisfero resp. al terenoj okcidente de laGrenviĉa Meridiano. En la GMS-formatigo (angle DMS) Grado, Minutoj kaj Sekundoj devas havi pozitivajn valorojn. Ili kaj la indiko de la ĉieldirekto (N,O/E,S kajW) estas kombinataj per trioblikvoj unu kun alia. La loko por la sekundoj povas lasata libera; ne entjeraj valoroj estas tiam ankaŭ eblaj ĉe la minutoj. Ekzemplo:

|NS = 45.123456|EW = -12.123456|NS = 55/44/33.22/N|EW = 11/22/33.44/W

Svisaj landaj koordinatoj povas esti transkalkulataj per helpo de laŜablono:CH1903-WGS84. Ĉi tiu estas uzata por tiosubstituita:

Ekzemplo: Bern (600'000/200'000)

|NS = {{subst:CH1903-WGS84|600|200|koor=B}}|EW = {{subst:CH1903-WGS84|600|200|koor=L}}|region = CH-BE

La indiko de la parametrotype ebligas la difinon de la tipo de la geografie referencita objekto, varianto dekategorigo. Per tio eblas krei ekz. enGIS-programoj laŭtemajn prezentadojn, ĉar el la grandega amaso de koordinataj informoj ekz. nur ĉiuj insuloj aŭ montoj povas esti elfiltrataj. Ankaŭ ĉi tiu indiko estas deviga. La valoro estas transdonata al la ligilo por "Toolserver" kaj tial nur povas enhavi anglan valoron.

La parametroregion difinas perISO-3166-kodo la regionon, landon, ŝtaton aŭ subŝtaton de la objekto.

Ekzemple por objekto en Bavario, oni skribu:

|region = DE-BY

Ekzemplo pro objekto en Ruslando, oni skribu:

|region = RU

Por objektoj sur aliaj ĉielkorpoj ol la tero estas difinata ĉi tio per la parametroglobe. Ĝi anstataŭas la difinon de laregion, ISO-3166-kodoj nomas eksklude regionojn sur la tero. Eblaj valoroj estas la anglaj nomoj de la ĉielkorpoj en malgranda skribo; kompleta listo troviĝas perKategorio:Ŝablono:Info globe. Difino deglobe=earth estas superflua.

Ekzemplo por objekto sur la luno:

|globe = moon

Per la parametropop (population, eo.loĝantaro) estas difinata ĉe administraj unuoj, urboj kaj insuloj la nombro de loĝantoj. La natura nombro ne rajtas enhavi disigajn signojn por miloj.

Per la parametroelevation povas esti difinatajaltaĵoj. Relevante estas la ene de la nomitaregion (unua parto) oficialasupermara alteco en metroj je la pozicio de la koordinato. La alteco devas esti transdonata kiel numero, „de-ĝis“-difinoj ne eblas!

La parametrodim estas uzata por informo pri la dimensio resp. grandeco. Ĉe tio temas pri la proksimuma diametro de la objekto resp. la diagonalo en metroj. Ĉi tiu informo influas la komencan skaligon de ekstera mapa surekranigo kaj la#Rondigo de la eldono.

Ekzemplo de konstruaĵo kun 50 m diagonala dimensio:

|dim = 50

La nomo de la geografie referencita objekto povas, se ĉi tiu ne identas al la titolo de la artikolo, difinata per la parametroname. En flua tekstodevas esti metata ĉi tiu parametro. Se estas nomataj pluraj koordinatoj en la artikola flua teksto, do ĉi tiuj devas esti distingeblaj per sencoplenaj nomigoj.

La metado aŭ forlasado resp. malplenlasado de la parametrojarticle,text kajmap difinas la eldonon, ĉe kio eblas tri surekranigoj:

• Kiel artikola koordinato estas nomata la surekranigo de la ligiloj por la tuta artikolo.Aspektospecife ĝi estas kutime poziciata en la dekstra supra angulo. Post la ligiko estas aldonata la butono „mapo“, kiu ebligas la aperigon kaj malaperigon deOSM-mapo (→de:Hilfe:OpenStreetMap).
• La (flu-)teksta koordinato nomiĝas la eldono de la ligiloj je tiu pozicio, je kiu la ŝablono estas metata en la (fonto-)tekston. La ligila teksto estas ĉe tio libere elektebla.
• Lamap-opcio montras la koordinaton sur konvena al la regiono (alĝustigebla)pozicia mapo.

Se parametro estas plenigita, tiam la koncerna formato estas aktivigata; ĉiuj kombinoj estas eblaj (se ne ĉiam nepre sencohavaj). Se neniu el la parametroj estas difinita, tiam estas eldonata la artikola koordinato („norma eldono“).

La parametrotext ofertas diversajn eblecojn, formatigi la flutekstan eldonon:

• La plej ofta varianto estas unu aŭ pluraj#Eldonformatoj por la koordinataj valoroj mem. Kutimas la facile kiel koordinato rekonebla „GMS“ (angle „DMS“), aliaj formatoj rezultiĝu el la kunteksto.
• Per la valoroj „ICON0“, „ICON1“ aŭ „ICON2“ estas eldonata la kromsignoj resp. simboloj ‚⊙‘, ‚▼‘ respektive ‚‘ kun ligado al la „Geohack“. Ili asociigas tiel informon pri loko, sen interrompi ĉe la uzado en fluteksto la legofluon.
• Ĉiu valoroj, kiuj komenciĝas per „Dosiero“, kaŭzas enplektadon de medio per Dosiera ligilo. Nur uzugemeinfreie dosierojn, vidude:H:Bilder#Link! En la artikola nomspaco rajtas esti uzataj nur la „oficialaj“ simboloj!
• Ĉiuj aliaj tekstoj, kiuj kovras neniun al la supraj kazoj(Praktika regulo: Ne komenciĝu per/,Icon aŭDosiero), estas rekte eldonataj kiel ligila teksto. Tio ebligas la enmeton de decaj tekstoligiloj en la fluan tekston, ekzemple „situo“.

Se la teksteldono estas uzata enordigeblaj tabeloj, povas esti farataj ordigiblaj la koordinataj informoj per la parametrosortkey. Eblaj valoroj estas ĉe tio:

• „NS“ por ordigo laŭ latitudo
• „EW“ por ordigo laŭ longitudo

Ĉe tio estasNordo (pozitiva decimala grado) pli granda olSudo (negativa decimala grado) kajOriento (pozitiva decimala grado) pli granda olWest (okcidento; negativa decimala grado). La parametro estas utila nur en tabeloj kaj tial estu uzata nur en tiuj. Kromefekto de la ordiga ŝlosilo estas, ke ĉe minutoj kaj sekundoj estas aldonataj komencaj nuloj.

La enhavo de la kampoarticle kajtext difinas la eldonan formaton. Formataj deklaroj konsistas ĉe tio el formatkodo aŭ du per oblikva streko/ disigitaj. Disiga streko sen antaŭa kodo, poste aŭ tute sola kaŭzas aŭtomatan determinadon de la koordinata formato, kiu estas preferata en la donitaregiono per helpo de laŜablono:CoordinateRR DEFAULT. Tio okazas ankaŭ en la norma eldono.

Por ĉiu eldono eblas maksimume du formatoj, tro similaj (kiel DM kaj DMS) ekskludas unu la alian.

• Por la artikola koordinato estas uzata ĉiam la formato GMS, elektebla (ĉu per la parametroarticle aŭ aŭtomate) estas nur eventuala dua. Ĉi tiu speciala formato estas disigata per punktokomo kaj nomata per nomo, por ke ĝi estu ekkonebla de la leganto.
• Se estas eldonataj en fluteksto pluraj formatoj, la dua estas aligata sen nomo en krampoj.

Ekzemplo „Uzu norman eldonformaton“: nur difinu,ke kaj nekiel koordinato estas surekranigata en fluteksto resp. artikola kaplinio.

|text=/|text=situo|article=/

Ekzemplo: UTM-formato, post tio en krampoj decimale en gradoj:

|text=UTM/DEC

Ekzemplo: Montru DMS-formaton kaj post tio, se loke preferata formato ekzistas, tiu en krampoj:

|text=DMS/

Ekzemplo: Montru en la artikola kaplinio post la kutima DMS ankoraŭ la Svisajn landajn koordinatojn (diversaj eblecoj):

|article=DMS/CH1903|article=CH1903|article=CH1903/DMS|article=/CH1903

Aŭtomata rondigo okazas ĉe la norma eldono DMS kaj ĉe DEC, ĉe kio laparametrodim, do la grandeco de la objekto, enfluas en la rondigon. Se ĝi ne estas donata, tiam la rondigo estas elkalkulata el laparametrotype. Ĉiuj specialaj formatoj ne estas rondigataj.

1. ↑Ĉe laekvatoro intermeridianoj, do plej alte ebla distanco

Per la parametromap oni povas enmeti kompletanpozician mapon. Krom la evitado de redundo kompare al aldona enmetado de plia ŝablono kun validigo de la valoroj ĉi tiu opcio havas la avantaĝon, aŭtomate elekti mapon laŭ laregiona kodo (resp. ties unua parto) kaj krome trovi al tiu konvenan bildan subskribon.

La enhavo demap difinas la pozicion de la mapo en la artikolo. Ĝi korespondas per tio al la parametrofloat de laŜablono:Situo sur mapo; por la signifo de la unuopaj valoroj vidu ties dokumentadon. Defaŭlta valoro estas ĉe tio normala miniatura enplekto en la grandeco laŭ la preferoj de la koncerna uzanto. La grandeco estas alĝustigebla per la parametromapsize (en px); por la dokumentado validas analoga.

Ekzemplo por miniatura enplekto je la dekstra marĝeno:

|map=right

Ekzemplo por centrigita enplekto kun konstanta larĝo:

|map=center|mapsize=300

Same povas esti elektataj per la parametromaptype kaj kiel ĉe laŜablono:Situo sur mapo aliaj (eble topografiaj) mapoj La eblaj valoroj dependas de la elektita mapo kaj estas tie dokumentitaj.

Maponivelo

Per la parametromaplevel povas esti influata la elektado de la pozicia mapo. Per ĉi tiu mapa ebeno estas difinata, de kiu el la ISO-3166-unuoj la mapo estu uzata. Norme estas enplektata la mapo de la ŝtato (pli ekzakte: la aĵo kun propraTop-Level-Code en ISO-3166); ĉi tiu norma enplekto korespondas almaplevel=national. Mapoj pri subnaciaj administraciaj ebenoj sur ŝtupo 1 (Gouvernements, kantonoj, federaciaj landoj, provincoj ktp.) kaj ŝtupo 2 (Departementoj ktp.) estas elektitaj permaplevel=adm1st resp.maplevel=adm2nd. Kondiĉo por tio estas, ke laregion-kodo de la plej malsupra ebeno estis donata. Se la mapo ne ekzistas por la dezirata administracia ebeno, estas enplektata la sekva pli alta ekzistanta pozicia mapo kiel anstataŭaĵo. Permaplevel=continental aŭmaplevel=global povas esti devigataj ankaŭ mapoj de la kontinentoj resp. de la tero.

Pli detalaj informoj troveblas en artikoloŜablono:Koordinato/ekzemploj.

Esperante (escepte de "Toolserver"aj parametroj)

{{Koordinato |artikolo=/ |mapo=dekstre |latitudo=38.103267 |longitudo=58.207401 |type=landmark |region=TM-A|mapogrando=250px}}

Angle

{{Coordinate |article=/ |map=right |NS=38.103267 |EW=58.207401 |type=landmark |region=TM-A|mapsize=250px}}

Simpla

{{Coordinate|text={{#if:{{{latitudo|}}}|/}} |article=/ |NS={{{latitudo|}}} |EW={{{longitudo|}}} |type=isle |pop={{{loĝantoj|}}} |elevation= |region={{{regiono-ISO|}}} |dim=}}

• Vidu la tuton en {{informkesto insularo}}

Kompleksa

{{Coordinate |text={{#if:{{{latitudo|}}}{{{kromkesto|}}}|/}} |article={{#if:{{{kromkesto|}}}||/}} |NS={{{latitudo|}}} |EW={{{longitudo|}}} |type=isle |pop={{#switch:{{{loĝantaro|}}}|neloĝata|(neloĝata)=0|#default={{{loĝantaro|}}}}} |elevation={{{alteco|}}} |region={{{regiono-ISO|}}} |dim={{#iferror:{{#if:{{{longo|}}}{{{larĝo|}}}{{{areo|}}}|{{#expr: trunc ({{max|(0{{{areo|}}})^0.5|{{{longo|}}}|{{{larĝo|}}}}}*1000)}}}}|}} |name={{#if:{{{kromkesto|}}}|{{{nomo|}}}|{{#if: {{{nomo|}}}|{{{nomo}}}|{{PAGENAME}}}}}}}}

• Vidu la tuton en {{informkesto insulo}}

• {{Koordinato/+}} estas la ŝablono, kiu vere aranĝas la tuton. La ĉefa nur esperantigas kelkajn parametrojn.
• {{koord}} ĝi havas iomete alian sintakson, tute alian kodigon kaj ne subtenas mapojn.

Uzado de la ŝablono en artikoloj. (Helpo pri la koncerna Dok-parametro) Ĉi tiu dokumentado estas enplektitael subpaĝo. Paĝo porprovejo de ŝablono, kie estas evoluigata nova versio. (Helpo) Ekzemploj kaj testoj de funkcieco estas sur latesta paĝo. (Helpo) Listo de subpaĝoj.