Nápověda:Rozšíření:Kartographer/Začínáme

This page is a translated version of the page Help:Extension:Kartographer/Getting started and the translation is 100% complete.

Hlavní stránky nápovědy:

Jak vytvářet mapy pomocí Kartographeru ve VisualEditoru
current: Úvod do Kartographeru ve wikitextu
Kartographer - rozsáhlá stránka s nápovědou

Přehled

Kartographer je rozšíření MediaWiki, které umožňuje vytvářet vložené mapy a odkazy na mapy na celé obrazovce na stránkách wiki, a to stejně snadno jako napsání jediného řádku wikitextu nebo kliknutí na položku nabídky ve vizuálním editoru.

Tato příručka se zaměřuje na mapy ve wikitextu.

Některé wikiny zabalují funkcionalitu Kartographeru do šablon (často nazývaných Maplink a Mapbox). Běžně používané šablony naleznete na stránce nápovědy ke Kartographeru na vaší místní wiki.

Rychlý start: příklad

Tento kód vytvoří jednoduchou mapu o rozměrech 250x250 v rámečku, jako je ta, kterou vidíte v této části, s popiskem "Centrum San Francisca".

<mapframe text="Centrum města [[w:San Francisco|San Francisco]]" width=250 height=250 zoom=13  longitude=-122.3988 latitude=37.8013 />

Přidání mapy na stránku

`‎<mapframe>`

Map — mapframe width=400 height=400 zoom=15 longitude=13.377704 latitude=52.516275

Chcete-li přidat mapu, která se zobrazí v malém okně (nebo rámečku) na wiki stránce, použijte tag ‎<mapframe>. Kliknutím na malou mapu se otevře interaktivní mapa na celou obrazovku.

Na Wikipedii a dalších wiki stránkách Wikimedie je vložená mapa statická. Kliknutím na statický obrázek se otevře interaktivní mapa na celé obrazovce.
Na Wikivoyage a test2wiki je tato vložená mapa interaktivní. Kliknutím, podržením a pohybem kurzoru se mapa posouvá. Dvojitým kliknutím nebo kliknutím na ikonu celé obrazovky v horním rohu se otevře interaktivní mapa na celou obrazovku.

Ve své nejjednodušší formě používá ‎<mapframe> následující informace k zobrazení mapy určité oblasti:

místo (zeměpisná šířka a délka)
velikost rámu (šířka a výška)

Příklad: <mapframe width=400 height=400 zoom=15 longitude=13.377704 latitude=52.516275 />

Úplné vysvětlení syntaxe a seznam dostupných atributů naleznete na hlavní stránce nápovědy.

`‎<maplink>`

Místo interaktivní mapy na samotné wiki stránce můžete také vytvořit text (s volitelnou značkou), který odkazuje na interaktivní mapu na celé obrazovce, a to pomocí přepínače ‎<maplink>.

Minimální tag ‎<maplink> je ještě kratší – stačí jen umístění.

Příklad: <maplink text="Downtown San Francisco" longitude=-122.3988 latitude=37.8013 />

Downtown San Francisco

Úplné vysvětlení syntaxe a seznam dostupných atributů naleznete na hlavní stránce nápovědy.

GeoJSON

GeoJSON je strukturovaný způsob reprezentace geografických informací, který využívá standard JSON.

Mapa v Kartographeru nepotřebuje k fungování žádný GeoJSON, ale GeoJSON otevírá širokou škálu funkcí, které nejsou k dispozici pouze v Kartographeru, jako jsou značky, geotvary z externích zdrojů, jako je OpenStreetMap, speciální styling a další.

Sestavení GeoJSON

Bez ohledu na to, zda vytváříte mapu s využitím Kartographeru ve wikitextu nebo ve vizuálním editoru, pravděpodobně budete chtít pro tvorbu GeoJSON použít nástroj.

Skvělým začátkem je editor GeoJSON.io a k dispozici je i tento užitečný průvodce.

Následuje stručný přehled běžně používaných výkonných prvků GeoJSON. Pro podrobnější informace o tomto tématu se podívejte na Help:Extension:Kartographer#GeoJSON a náš úplný seznam zdrojů GeoJSON.

Značky

Místo jednoduchého vycentrování mapy na oblast, kterou chcete zvýraznit, můžete k umístění jedné nebo více informativních značek na mapu použít GeoJSON.

Chcete-li umístit značku na mapu, použijte objekt GeoJSON "Feature". Můžete si vybrat přesné umístění značky na mapě, použitý symbol, její barvu a velikost, název, popisný obrázek a další – včetně toho, zda u více značek použít písmena nebo čísla.

Níže uvedený příklad je dobrým výchozím bodem. Úplný seznam atributů a možností naleznete v sekci automatických čítačů na hlavní stránce nápovědy.

<mapframe text="Colorado State Capitol" longitude="-104.98491" latitude="39.73939" zoom="17" width="250", height="250">
{  "type": "Feature",
   "properties": 
       { "marker-symbol": "town-hall", 
         "marker-color": "46ea5f", 
         "marker-size": "medium", 
         "title": "[[w:Colorado_State_Capitol|CO Capitol]]", 
         "description": "[[File:Coloradocapitolhill2.JPG|150px]]"
       },
    "geometry": 
       { "type": "Point", 
       "coordinates": [-104.98485267162323, 39.73928364167763] 
       }
}
</mapframe>

Tvary

GeoJSON umožňuje kreslit tvary na mapě. Jednoduché tvary můžete definovat přímo v textu nebo je importovat z míst, jako jsou Wikidata a OpenStreetMap.

Ačkoli níže uvádíme několik ilustrativních příkladů, velkou část této práce lze nejsnadněji provést v editoru GeoJSON. Pokud má vaše wiki povolený vizuální editor, podívejte se na našeho průvodce použití VisualEditoru k vytváření map nebo použijte tento editor.

Inline

Pomocí GeoJSON vám Kartographer umožňuje definovat body (značky), čáry a polygony, které se mají vykreslit přes vámi definovanou oblast mapy, a to pomocí speciální syntaxe a souřadnic zeměpisné délky/šířky.

<mapframe latitude="46.528635" longitude="-122.299805" zoom="6" width="246" height="272" align="right">
    {
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [-122.321777, 47.598526],
          [-122.629395, 45.505662]
        ]
}}]} 
</mapframe>

Více informací naleznete v sekci Inline na hlavní stránce nápovědy.

Externí data

Kromě zobrazování a označování map může Kartographer čerpat také z rozsáhlých zdrojů geodat, které nabízí Wikidata a OpenStreetMap. Tato data vám mohou pomoci zvýraznit oblasti mapy pomocí geotvarů, což jsou geografická data popisující fyzikální vlastnosti dané oblasti.

Geotvary lze vykreslit třemi různými způsoby pomocí atributu "service":

"service": "geopoint": Nakreslí značku.
"service": "geoline": Nakreslí jednoduchou čáru.
"service": "geoshape": Nakreslí mnohoúhelník se stínovaným vnitřkem.
"service": "geomask": Nakreslí polygon a vystínuje vše mimo polygon.

Jednoduchý příklad:

<mapframe text="Madagascar" width=300 height=300 zoom=4 longitude=46.523 latitude=-19.86>
{
  "type": "ExternalData",
  "service": "geoshape",
  "ids": "Q1019"
}
</mapframe>

Kromě umístění jednoho geotvaru na mapu můžete také použít dotazy SPARQL k načtení několika souvisejících geotvarů z Wikidat. (Potřebujete-li pomoc s psaním SPARQL, podívejte se na Query Builder na Wikidatech.)

Více informací naleznete v sekci Externí data na hlavní stránce nápovědy.

Další zdroje

Svět map a geografických dat Kartographer je rozsáhlý a ani naše hlavní stránka nápovědy nedokáže pokrýt všechny jeho aspekty. Další informace naleznete v tomto seznamu zdrojů.