Ŝablono:Mapkadro/dokumentado

Ĉi tiu ŝablono kreas mapkadron uzante mw:Extension:Kartographer, per helpo de la modulo {{mapkadro}}.

Simpla varianto
{{mapkadro}}

La ŝablono transprenas informojn el la rilata vikidatuma ero de la artikolo.

Malgranda varianto
{{mapkadro | koordinatoj }}
Kompleta sintakso
{{mapkadro
    |type= |latitude= |longitude=  |zoom= 
    |height= |width= |text= |align= |frameless= |class= |item=
    |coordinates= |title= |description= |image= 
    |marker-color= |marker-size= |marker-symbol=
    |stroke= |stroke-width= |stroke-opacity=
    |fill= |fill-opacity=
    |geotype= |ids=
        |geotype1=Point |coordinates1/ids1= |marker-color1= |marker-size1= |marker-symbol1= |title1/description1/image1=
        |geotype2=LineString |coordinates2/ids2= |stroke2= |stroke-width2= |stroke-opacity2= |title2/description2/image2=  
        |geotype3=Polygon |coordinates3/ids3= |fill3= |fill-opacity3= |stroke3= |stroke-width3= |stroke-opacity3= |title3/description3/image3= 
        |geotype4=circle |radius4/radiuskm4 = |coordinates4/ids4= |edges4= |turn4= |fill4= |fill-opacity4= |stroke4= |stroke-width4= |stroke-opacity4= |title4/description4/image4=  
        |geotype5=(geoshape/geomask/geoline) |ids5= |fill5= |fill-opacity5= |stroke5= |stroke-width5= |stroke-opacity5= |title5= |description5= |image5= 
        |geotype6=page |commons6=  
        |geotype7=named |from7= 
        |titleN= ...
}}

La unika deviga datumo estas la koordinatoj, aŭ difinataj en la parametro aŭ disponeblaj en Vikidatumoj. Por eksteraj objektoj geotype estas deviga. Ĉiuj aliaj parametroj estas nedevigaj.

La numeritaj parametroj estas por kombini malsamajn objektojn. Devas okazi sinsekva numerado komenciĝanta per 1.

Parametroj

redakti
Datumoj de mapo
  • item (nedeviga): por specimenoj aŭ provoj, la Vikidata ero el kiu oni ĉerpas la defaŭltajn valorojn.
  • type (nedeviga): tipo de reprezentado. Valoroj:
    • type =mapframe (defaŭlte): kreas statan mapon en kadro kun antaŭrigardo por aliri al dinamika mapo.
    • type =maplink: montras ligilon al mapo kun ikono kaj teksto.
  • latitude / longitude (nedeviga): Koordinatoj de la centro de la mapo montrota, en decimala versio. Defaŭlte kalkulas la centron el ĉiuj montrataj punktoj, ĝi nur necesos, se vi volas koncentri la mapon sur alian punkton.
  • zoom (nedeviga): nivelo de zomo por la mapo (0-18): 0=mapo de la mondo, 9-11=regiono, 13=urbo, 19=konstruaĵoj. Defaŭlte kalkulas la minimuman zomon por persvadi ĉiujn punktojn en la kadro difinita laŭ alteco kaj larĝo. Por ununura punkto uzas la parametron default_zoom aŭ defaŭlte 9.

Datumoj de mapframe

  • height / width (nedeviga): alto kaj larĝo de la mapo en pikseloj. Defaŭlte estas 300 (300px x 300px), la kutima grandeco en informkestoj kaj taŭga por moveblaj aparatoj.
  • text (nedeviga): teksto por la malsupra parto de la mapo.
  • align (nedeviga): rektigo de la mapo. Valoroj: left, center, right. Defaŭlto estas right.
  • frameless (nedeviga): kun iu ajn valoro montras la mapon sen kadro. Ĝi estas malkongrua al la parametro text.
  • item (nedeviga): elemento de Vikidatumoj el kiu oni ricevas la datumojn de koordinatoj kaj areo. Defaŭlte uzas la elementon asociatan al la paĝo. Ne necesos, se la centraj koordinatoj jam estas difinitaj aŭ diversaj objektoj inkluzivas.

Datumoj de maplink

  • text (nedeviga): teksto de la ligilo. Defaŭlte estos montrataj la koordinatoj ĉe ununura objekto.
  • class (nedeviga): CSS-formato por apliki kun klaso difinita en Mediawiki:Common.css, ekzemple class = infobox. Kun class = no-ikon ĝi ne montras la ikonon antaŭ la ligilo.
Datumoj de la objektoj

Pli ol unu objekto povas esti difinita nombrante la N-parametrojn korekte de 1. Se parametroN ne ekzistas, ĝi prenos la valoron de la parametro sen numerado.

Parametroj komunaj al ĉiuj objektospecoj:

  • geotype / geotypeN: objektospecoj. Valoroj:
    • Por desegnitaj objektoj (nedeviga): Point, MultiPoint, LineString, Polygon, circle. Vi ricevas ĝin el la koordinata formato. Ĝi estas bezonata nur en la kazo de MultiPoint, kiu havas la saman formaton kiel LineString. La tipo circle (cirklo) kreas formaton Polygon (poligono) de 32 anguloj.
    • Por eksteraj objektoj importitaj de OpenStreetMap per "ids" de Vikidatumoj (nedeviga se estas la asociita ero):
      • geoshape: poligono kun la markita ena areo,
      • geomask: poligono kun la markita ekstera areo,
      • geoline: poligono kun nur la konturlinio; por liniaj objektoj ĝi funkcias en kelkaj kazoj, pritraktata phab:T156433.
    • Por eksteraj objektoj importitaj de Komunejo kun la prefikso Data: kaj la etendaĵo .map:
      • page (nedeviga) aldonita por klarigo, kun la parametro "commons" jam uzas geotype=page.
    • Por la koordinatoj de paĝo difinita per {{koord}} ({{ coord}}):
      • named, akiras la koordinatojn de koord-ŝablonoj, kiuj havas la nomparametron por trakti ilin kiel MultiPoint.
    • Por preterpasi objekton, se temas pri multoblaj kondiĉe difinitaj sinsekvaj objektoj:
      • geotypeN=none, ignoras ĉiujn difinojn por la objekto N.
  • coordinates / coordinatesN (nedeviga): Koordinatoj en decimala versio. Alternative por unu sola objekto ĝi povas esti la unua nenomita parametro. Defaŭlte ĝi estas akirita de Vikidatumoj. Ĝi ne estas uzata por eksteraj datumoj. Formatoj:
    • Unu punkto: en la formato «latitudo , longitudo».
    • Unu linio aŭ multipunkto: ĝi konsistas el pluraj punktoj kun la koordinatoj apartigitaj per duonpunkto: «punkto ; punkto...»
    • Unu poligono: ĝi estas konturolinio kun la lasta koordinato egala al la unua, se temas pri fermi ĝin. Truo en la areo estas alia poligono apartigita per du punktoj: «konturolinio : konturolinio...»
  • idsN (nedeviga): kiel alternativo l coordinatesN por akiri ilin de Vikidat-Qid. Por linio, plurpunkto aŭ plurlatero (poligono) povas esti pluraj valoroj apartigitaj per komo. Por eksteraj datumoj havas alian funkcion, vidu sube.
  • title / titleN (nedeviga): Titolo de objekto-etikedo.
  • description / descriptionN (nedeviga): Priskribo de la objekto, kiel subtitolo sur la etikedo.
  • image / imageN (nedeviga): Bildo en la objekta etikedo, kun la dosiernomo sen prefikso.
Datumoj por punktoj
  • marker-color / marker-colorN (nedeviga): Koloro de markilo de la punkto en formato CSS. Defaŭlte estas "#7e7e7e". Vidu la liston de koloroj.
  • marker-size / marker-sizeN (nedeviga): Grando de markilo. Valoroj: small, medium, large; defaŭlto estas medium.
  • marker-symbol / marker-symbolN (nedeviga): Simbolo en la markilo, defaŭlte mankas. Valoroj:
    • marker-symbol(N) = -number, numeras ĉiujn punktojn korelative. Ĝi ankaŭ akceptas donitan nombron inter 0 kaj 9.
    • marker-symbol(N) = -letter, markas la punktojn per literoj A, B, C... Ĝi ankaŭ akceptas certan literon inter a kaj z, minuskle.
    • marker-symbol(N) = simbolo, kun la nomo de unu el la disponeblaj ikonoj: Ikonoj de Maki
Datumoj por linioj
  • stroke / strokeN (nedeviga): Koloro de la linio en formato CSS. Defaŭlto estas "#555555". Vidu la liston de koloroj.
  • stroke-width / stroke-widthN (nedeviga): Linia larĝo kun nombra valoro egala aŭ pli granda ol 0, defaŭlte 2.
  • stroke-opacity / stroke-opacityN (nedeviga): Opakeco de la linio kun dekuma valoro inter 0 kaj 1, defaŭlte 1.0.
Datumoj por poligonoj
  • fill / fillN (nedeviga): Koloro de la poligono, krom truoj, en formato CSS. Defaŭlto estas "#555555". Vidu la liston de koloroj. Enkaze de geotype=geoshape estas de la interno de la poligono, enkaze de geotype=geomask estas la ekstero.
  • fill-opacity, fill-opacityN (nedeviga): Opakeco de la poligono per decimala valoro inter 0 kaj 1, defaŭlte 0.6. Enkaze de geotype=geoshape estas de la interno de la poligono, enkaze de geotype=geomask estas la ekstero.

Ankaŭ uzas stroke / stroke-width / stroke-opacity por la linio de konturo de la poligono.

Datumoj por cirkloj
  • radius / radiusN (deviga): Radiuso de la cirklo en metroj. Kun la koordinatoj kiel centro, ĝi kreas poligonon proksimuman al cirklo.
  • radiuskm / radiuskmN: Alternativa valoro por radiuso en kilometroj.
  • edges / edgeskmN (nedeviga): Nombro de angluloj de la poligono. Defaŭlte estas 32 por alproksimigi cirklon.
  • turn / turnN (nedeviga): Rotacio de la poligono kun valoro inter 0 kaj 1. Defaŭlte estas 0 kreanta la unuan punkton de la poligono ĉe 0º de la cirklo. Ekzemple ĉe edges=3 kaj turn=0.5 invertas la trianglon kun la unua punkto al 180º.

Uzas la samajn parametrojn kiel poligono.

Datumoj por eksteraj objektoj
  • ids / idsN (nedeviga) de OSM: Vikipedia identigilo (Q...) Povas esti pluraj identigiloj apartigitaj per komo. Defaŭlte ĝi akiras la identigilon de la aktuala paĝo. Kun ĉi tiu identigilo vi ricevas la objekton OpenStreetMap se la Vikidatuma=Q...- propraĵo estas difinita tie. Povas esti uzataj ankaŭ la parametroj por la poligonoj.
  • commons / commonsN: titolo de la dosiero de Komunejo sen la prefikso "Data:" kaj kun la etendaĵo ".map". Vidu c:Special:Allpages/Data: ikaj mw:Help:Map Data.
Datumoj por la koordinatoj de paĝo

Ĉe geotype=named,

  • from / fromN (nedeviga): paĝa titolo, defaŭlte la aktuala. Ĝi povas inkluzivi sekcion por pli da efikeco de la datuma transkluda procezo.

Ĝi ankaŭ uzas la parametrojn por punktoj.

Ekzemploj

redakti
Kodo Rezulto
{{mapkadro}}
Mapo kun unu punkto

{{Mapkadro|37.851667, 40.663333}}

Map
Mapo kun punkto kun simbolo (mw:Maps/Icons)

{{Mapkadro|37.851667, 40.663333|marker-symbol1=star|marker-color1=#208020|image1=Bismil panorama.jpg|title1=Bismil}}

Map
Mapligilo kun koordinatoj

{{Mapkadro|37.851667, 40.663333|type=maplink}}

37°51′6″N 40°39′48″E
Mapligilo kun teksto

{{Mapkadro|37.851667, 40.663333|text=Cihê Bismilê|type=maplink}}

Cihê Bismilê
Mapo kun geoformo

{{Mapkadro|37.851667, 40.663333|geotype=geoshape|ids=Q546905}}

Map
Mapo kun inversa geoformo resp. geomasko

{{Mapkadro|37.851667, 40.663333|geotype=geomask|ids=Q546905}}

Map
Kodo Rezulto
Mapo kun tri punktoj
{{Mapkadro|
|geotype1=Point |coordinates1= 37.910833, 40.23666 |marker-color1=f00 |marker-size1=small|title1 = Amed
|geotype2=Point |coordinates2= 38.503611, 43.395556 |marker-color2=0050d0 |marker-size2=small|title2 = Wan
|geotype3=Point |coordinates3= 39.106389, 39.5425 |marker-color3=208020 |marker-size3=small|title3 = Mamekî
}}
Map
Mapo kun numerita punkto
{{mapkadro
 | marker-symbol=-number
 | zoom=7
 | title1=[[Regiono de Murcia]]
| coordinates1=38.00211,-1.48523
}}
Map
Mapo kun linio - Vojo de Santiago
{{mapkadro | geotype1=LineString | coordinates1= 42.45981, -6.05518; 42.48900,-6.06703; 42.49033, -6.09192; 42.49349, -6.10840; 42.49640, -6.12144; 42.51931, -6.12522; 42.52804, -6.16385; 42.54138, -6.19414; 42.59031, -6.22161; 42.59258, -6.27216; 42.60301, -6.26573; 42.59720, -6.32435; 42.58753, -6.33671; 42.60326, -6.39121; 42.61773, -6.41971; 42.60427, -6.43979; 42.60238, -6.47438; 42.59530, -6.50270; 42.58848, -6.51996; 42.55814, -6.54845; 42.54815, -6.59154
| zoom=9 
| height=420 | width=420 
}}
Map
Mapo kun poligono - Bermuda triangulo
{{mapkadro
 | text = [[Bermuda triangulo]]
 | title = [[Bermuda triangulo]]
 | 18.45, -66.066667; 25.775278, -80.208889; 32.333333, -64.75; 18.45, -66.066667
 | fill=#1E90FF
}}
Cirklo
{{mapkadro
 | geotype1 = circle
 | radius1 = 45000
 | ids1 = Q1049092
 | fill-opacity1 = 0.2
 | text = [[Tertremo kaj cunamo de Sumatro de 2010|Cunamo de Sumatro de 2010]]
}}

Vidu ankaŭ

redakti

En tiu ĉi artikolo estas uzita traduko de teksto el la artikolo Plantilla:Map draw en la kataluna Vikipedio.