Ŝablono:Koordinato

 Dokumentado

Ĉi tiu ŝablono havas subpaĝ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 la diskutopaĝo de la ŝablona projekto aŭ en la diskutopaĝ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 parametro NS aŭ esperante eĉ latitudo difinas la latitudon de la objekto. La parametro EW aŭ esperante eĉ longitudo difinas la longitudon de la objekto.

NS staras por North/South (nordo kaj sudo) kaj EW por East/West (oriento kaj okcidento). La indiko estas ĉiufoje ebla ne nur decimale en grado sed ankaŭ en „Degrees/Minutes/Seconds“-formato; la valoroj rilatas al la WGS84-referenco. La indiko de latitudo kaj longitudo estas deviga. Se mankas unu el tio, tio estas interpretata kiel peto pri geografia lokigo.

La decimala formatigo estas direktata al nordo resp. oriento, negativaj valoroj rilatas al la suda hemisfero resp. al terenoj okcidente de la Grenviĉ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 kaj W) estas kombinataj per tri oblikvoj 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 tio substituita:

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 parametro type ebligas la difinon de la tipo de la geografie referencita objekto, varianto de kategorigo. Per tio eblas krei ekz. en GIS-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 parametro region difinas per ISO-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 parametro globe. Ĝi anstataŭas la difinon de la region, 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 per Kategorio:Ŝablono:Info globe. Difino de globe=earth estas superflua.

Ekzemplo por objekto sur la luno:

|globe = moon

Per la parametro pop (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 parametro elevation povas esti difinataj altaĵoj. Relevante estas la ene de la nomita region (unua parto) oficiala supermara alteco en metroj je la pozicio de la koordinato. La alteco devas esti transdonata kiel numero, „de-ĝis“-difinoj ne eblas!

La parametro dim 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 parametro name. En flua teksto devas 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 parametroj article, text kaj map 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 de OSM-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.
• La map-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 parametro text 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 uzu gemeinfreie dosierojn, vidu de: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 en ordigeblaj tabeloj, povas esti farataj ordigiblaj la koordinataj informoj per la parametro sortkey. Eblaj valoroj estas ĉe tio:

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

Ĉe tio estas Nordo (pozitiva decimala grado) pli granda ol Sudo (negativa decimala grado) kaj Oriento (pozitiva decimala grado) pli granda ol West (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 kampo article kaj text 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 donita regiono 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 parametro article 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 ne kiel 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 la parametro dim, do la grandeco de la objekto, enfluas en la rondigon. Se ĝi ne estas donata, tiam la rondigo estas elkalkulata el la parametro type. Ĉiuj specialaj formatoj ne estas rondigataj.

1. ↑ Ĉe la ekvatoro inter meridianoj, do plej alte ebla distanco

Per la parametro map oni povas enmeti kompletan pozician 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ŭ la regiona kodo (resp. ties unua parto) kaj krome trovi al tiu konvenan bildan subskribon.

La enhavo de map difinas la pozicion de la mapo en la artikolo. Ĝi korespondas per tio al la parametro float 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 parametro mapsize (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 parametro maptype 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 parametro maplevel 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 propra Top-Level-Code en ISO-3166); ĉi tiu norma enplekto korespondas al maplevel=national . Mapoj pri subnaciaj administraciaj ebenoj sur ŝtupo 1 (Gouvernements, kantonoj, federaciaj landoj, provincoj ktp.) kaj ŝtupo 2 (Departementoj ktp.) estas elektitaj per maplevel=adm1st resp. maplevel=adm2nd. Kondiĉo por tio estas, ke la region-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. Per maplevel=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 enplektita el subpaĝo. Paĝo por provejo de ŝablono, kie estas evoluigata nova versio. (Helpo) Ekzemploj kaj testoj de funkcieco estas sur la testa paĝo. (Helpo) Listo de subpaĝoj.