SkipperGuide

SkipperGuide:Features/Karten und Skizzen: Unterschied zwischen den Versionen

← Zum vorherigen Versionsunterschied
VisuellWikitext
Extension 'Maps': weitere Elemente
K Textersetzung - „layers=osm-mapnik, osm-oseam, osm-oseam-cemt“ durch „layers=OpenSeaMap, OpenStreetMap“
 
(6 dazwischenliegende Versionen von einem anderen Benutzer werden nicht angezeigt)
Zeile 1: Zeile 1:
{{SkipperGuideFeatures}}
{{SkipperGuideFeatures}}
 
{{TOCright}}
== Karten ==
== Karten ==
=== MediaWiki-Extension 'Maps' ===
=== MediaWiki-Extension 'Maps' ===
In den Artikeln des SkipperGuides wird für Kartendarstellungen zum überwiegenden Teil die ''MediaWiki''-Extension '''Maps''' oder '''Semantic Maps''' verwendet. Sie hat den Vorteil, dass man aus mehreren Basiskartenanbietern wählen kann, und der Nutzer beziehungsweise Leser die Möglichkeit hat eventuell vorhandene zusätzliche Layer ein- und auszuschalten. Die anfangs oft verwendeten Daten von Google Maps sind inzwischen fast vollständig durch die von OpenSeaMap (OSeaM) ersetzt worden, so dass Karten aus diesem OpenStreetMap-Projekt (OSM) praktisch der Standard in diesem Wiki sind. Auslöser für die Umstellung waren Urheberschutzgründe, OSeaM hat sich darüber hinaus über die Jahre sowohl in Hinblick auf (nicht werbungsgesteuerter) Detailtiefe wie auch wegen der nautischen Inhalte offensichtlich durchgesetzt.  
In den Artikeln des SkipperGuides wird für Kartendarstellungen zum überwiegenden Teil die ''MediaWiki''-Extension '''Maps''' oder '''Semantic Maps''' verwendet. Sie hat den Vorteil, dass man aus mehreren Basiskartenanbietern wählen kann, und der Nutzer beziehungsweise Leser die Möglichkeit hat eventuell vorhandene zusätzliche Layer ein- und auszuschalten. Die anfangs oft verwendeten Daten von Google Maps sind inzwischen fast vollständig durch die von OpenSeaMap (OSeaM) ersetzt worden, so dass Karten aus diesem OpenStreetMap-Projekt (OSM) praktisch der Standard in diesem Wiki sind. Auslöser für die Umstellung waren Urheberschutzgründe, OSeaM hat sich darüber hinaus über die Jahre sowohl in Hinblick auf (nicht werbungsgesteuerter) Detailtiefe wie auch wegen der nautischen Inhalte offensichtlich durchgesetzt.  


==== Offizielle Dokumentation ====
Auf dieser [https://www.semantic-mediawiki.org/wiki/Extension:Maps/mapping_service#Available_values Dokumentationsseite] zur Extension findet man einige Infos, allerdings stößt man schnell auf einen Wermutstropfen: offensichtlich wird ''OpenLayers'' in neueren Versionen nicht weiter unterstützt, was sich in der inzwischen weitergeführten Beschreibung bemerkbar macht - die entsprechenden Punkte bleiben unbehandelt. Es ist also möglich, dass bei einer eventuellen Aktualisierung der MediaWiki-Software, auf der der ''SkipperGuide'' beruht, entweder eine neue Extension oder ähnliches gesucht werden muss, oder auf ''Leaflet'' als Implementierer umgestellt werden muss. Bis dahin gibt es eine Zusammenstellung der häufigsten Elemente im Artikel-Quellcode von 'Maps':  
Auf dieser [https://www.semantic-mediawiki.org/wiki/Extension:Maps/mapping_service#Available_values Dokumentationsseite] zur Extension findet man einige Infos, allerdings stößt man schnell auf einen Wermutstropfen: offensichtlich wird ''OpenLayers'' in neueren Versionen nicht weiter unterstützt, was sich in der inzwischen weitergeführten Beschreibung bemerkbar macht - die entsprechenden Punkte bleiben unbehandelt. Es ist also möglich, dass bei einer eventuellen Aktualisierung der MediaWiki-Software, auf der der ''SkipperGuide'' beruht, entweder eine neue Extension oder ähnliches gesucht werden muss, oder auf ''Leaflet'' als Implementierer umgestellt werden muss. Bis dahin gibt es eine Zusammenstellung der häufigsten Elemente im Artikel-Quellcode von 'Maps':  


==== Elemente der Extension ====
* Die Karte wird eingeleitet mit ''<nowiki>{{#display_map:</nowiki>''
* Die Karte wird eingeleitet mit ''<nowiki>{{#display_map:</nowiki>''
* Es folgt eine oder mehrere Positionen. Nach denen wird der Kartenausschnitt automatisch bestimmt, falls keine Angaben zu ''center'' und ''zoom'' gemacht werden. Die Positionsangaben sind getrennt durch Tilden&nbsp;(~). Im Einzelnen:  
* Es folgen eine oder mehrere Positionen. Nach denen wird der Kartenausschnitt automatisch bestimmt, falls keine Angaben zu ''center'' und ''zoom'' gemacht werden. Die Positionsangaben setzen sich zusammen aus:  
** Längengrad im dezimalen Format (''dd.dddd'', W-liche Angaben als negative Zahl), und nach einem Komma als Trennzeichen der
** Längengrad im dezimalen Format (''dd.dddd'', W-liche Angaben als negative Zahl), und nach einem Komma als Trennzeichen der
** Breitengrad im dezimalen Format (also ''dd.dddd'', S-liche Angaben negativ),
** Breitengrad im dezimalen Format (also ''dd.dddd'', S-liche Angaben negativ).
** nach der trennenden Tilde kann ein Text angegeben werden, der als Überschrift in einem Popup erscheint. Der Text erscheint immer, die Formatierung als Überschrift zeigt sich allerdings erst, wenn nachfolgend ein Beschreibungstext angelegt wird.  
** Nach der trennenden Tilde kann ein Text angegeben werden, der als Überschrift in einem Popup erscheint. Ein eingebener Text erscheint immer, die Formatierung als Überschrift zeigt sich allerdings erst, wenn - wie nachfolgend beschrieben - auch ein Beschreibungstext angelegt ist.  
** Nach der nächsten Tilde kann man weitere Eingaben machen, die im Popup als Beschreibung unterhalb der Überschrift erscheinen. <br>
** Nach der nächsten Tilde kann man weitere Eingaben machen, die im Popup als Beschreibung unterhalb der Überschrift erscheinen. Wenn außer den Feldtrennertilden keine Eingabe für Beschreibung und deren Überschrift gemacht wird, erscheint auch kein Popup. Diese Konstellation ergibt sich, wenn man nur ein Icon für den Marker festlegen will.  
Wenn außer den Feldtrennertilden keine Eingabe für Beschreibung und deren Überschrift gemacht wird, erscheint auch kein Popup. Diese Konstellation ergibt sich, wenn man nur ein Icon für den Marker festlegen will.  
** Optional folgt nach einer weiteren Tilde ein Link zu einer Grafikdatei, die als Icon für die Position dargestellt werden soll. Bei fehlender Angabe wird ein rotes Standardsymbol verwendet.  
** Optional folgt nach der nächsten Tilde ein Link zu einer Grafikdatei, die als Marker für die Position verwendet werden soll. Bei fehlender Angabe wird ein rotes Standardsymbol verwendet.  
** Achtung: Zeilen mit Positionsangaben müssen mit einem Semicolon&nbsp;(;) abgeschlossen werden, wenn eine weitere Positionsangabe folgt. Ein abschließendes Semicolon in der letzten Positionszeile kann jedoch zu einem Fehler führen.  
** Achtung: Zeilen mit Positionsangaben müssen mit einem Semicolon&nbsp;(;) abgeschlossen werden, wenn eine weitere Positionsangabe folgt. Ein abschließendes Semicolon in der letzten Positionszeile kann jedoch zu einem Fehler führen.  
* mit dem ''Pipe''-Zeichen&nbsp;(|) als Trenner können optional weitere Angaben gemacht werden:  
* Mit dem ''Pipe''-Zeichen&nbsp;(|) als Trenner können optional weitere Angaben gemacht werden:  
** ''center='' gefolgt von einer Positionsangabe mit Länge und Breite, Format wie oben beschrieben. Damit wird der Kartenmittelpunkt bestimmt, die Angabe kann bei vorhandenen Positionsangaben entfallen.  
** ''center='' gefolgt von einer Positionsangabe mit Länge und Breite, Format wie oben beschrieben. Damit wird der Kartenmittelpunkt bestimmt, die Angabe kann bei vorhandenen Positionsangaben entfallen.  
** ''zoom='' Angabe der Kartenzoomstufe.  
** ''zoom='' Angabe der Kartenzoomstufe.  
Zeile 33: Zeile 34:
*** ein Beschreibungstext,  
*** ein Beschreibungstext,  
*** Linienfarbe HTML-codiert, also eine Raute (#) direkt gefolgt von einer sechsstelligen Hexadezimalzahl (Beispiel: #00FF00 für ein Quietschegrün),  
*** Linienfarbe HTML-codiert, also eine Raute (#) direkt gefolgt von einer sechsstelligen Hexadezimalzahl (Beispiel: #00FF00 für ein Quietschegrün),  
*** ihre Deckkraft von 0 bis 1,  
*** ihre Opazität (von 0 = transparent bis 1 = deckend),  
*** sowie die Linienbreite in Pixel.  
*** sowie die Linienbreite in Pixel.  
*** Nach einem Semicolon kann eine weitere, neue Linie angegeben werden, nach der letzten Linie darf es allerdings KEIN Semicolon mehr geben.  
*** Nach einem Semicolon kann eine weitere, neue Linie angegeben werden, nach der letzten Linie darf es allerdings KEIN Semicolon mehr geben.  
** ''polygons'' Darstellung von geschlossenen Flächen. Die erforderlichen Angaben sind ähnlich denen für die ''lines'':  
** ''polygons='' Darstellung von geschlossenen Flächen. Die erforderlichen Angaben sind ähnlich denen für die ''lines'':  
*** Koordinatenangaben wie oben beschrieben mit Komma als Trenner für Länge und Breite und Doppelpunkt für die Koordinatenpaare.  
*** Koordinatenangaben wie oben beschrieben mit Komma als Trenner für Länge und Breite und Doppelpunkt für die Koordinatenpaare.  
*** Überschrift, Beschreibung, Farbe der Randlinie, sowie deren Deckkraft wie bei den ''lines'',  
*** Überschrift, Beschreibung, Farbe der Randlinie, deren Deckkraft sowie Breite wie bei den ''lines'',  
*** gefolgt von Farbe und Deckkraft für die Flächenfüllung.  
*** gefolgt von Farbe und Deckkraft für die Flächenfüllung.  
*** Und wieder entweder ein Semicolon, falls ein weiteres Polygon folgt, oder eben genau kein Semicolon.  
*** Und wieder entweder ein Semicolon, falls ein weiteres Polygon folgt, oder eben genau kein Semicolon.  
Zeile 45: Zeile 46:
Bei den Koordinatenangaben gibt es kein Limit für die Stellen, die Angaben sind also nicht auf vier Stellen hinterm Komma beschränkt.  
Bei den Koordinatenangaben gibt es kein Limit für die Stellen, die Angaben sind also nicht auf vier Stellen hinterm Komma beschränkt.  


==== Icons ====
Bei den Kartenpositionen wird eine Standardgrafik [[Datei:Symbol_Marker_standard.png]] verwendet, wenn nicht explizit eine andere Datei angegeben ist. Grundsätzlich kann jede Bilddatei als Icon verwendet werden, die alle von der Extension auf das gleiche Maß verkleinert dargestellt werden. Für die Zwecke der Kartendarstellung sind jedoch eine ganze Anzahl an Grafiken hochgeladen worden, die meisten vermutlich selbst erstellt. So hat [[User:GeorgHD|GeorgHD]] einen ganzen Satz an Logos bereitgestellt, die viel in den Artikeln zur Ostsee Verwendung gefunden haben. Eine weiterer Icon-Satz entsteht mit Dateien, die mit ''Symbol_'' im Dateinamen beginnen (zum Beispiel Symbol_Hafen.svg). Bei letztgenannter Reihe ist zu beachten, dass die aktuellen Dateien im Format SVG erstellt sind. Die ursprünglichen Pixeldateien (JPG, PNG) sind Auslaufmodelle, falls sie nicht mehr anderweitig verwendet werden.
Die Grafikfiles findet man wie alle Bilddateien auf der Spezialseite [[Spezial:Dateien|Dateiliste]], unter der Rubrik ''Medien''. Und als Piktogramm kategorisierte Grafiken sind in der dazugehörigen [https://www.skipperguide.de/wiki/Kategorie:Piktogramm Kategorieseite] zusammengeführt.
==== Vorlagen zur Kartenbeschreibung ====
Die Vorlage ''<nowiki>{{MaßstabGM}}</nowiki>'' versucht die in der Karte verwendeten Maßstäbe zu beschreiben. Die dort angegebenen Einheiten ändern sich mit unterschiedlichen Zoomstufen. Leider kann man - zumindest in der aktuell verwendeten Extension-Version - die Grundeinheiten nicht ändern, so gibt es immer metrische und imperiale, aber keine nautischen Längenangaben.  
Die Vorlage ''<nowiki>{{MaßstabGM}}</nowiki>'' versucht die in der Karte verwendeten Maßstäbe zu beschreiben. Die dort angegebenen Einheiten ändern sich mit unterschiedlichen Zoomstufen. Leider kann man - zumindest in der aktuell verwendeten Extension-Version - die Grundeinheiten nicht ändern, so gibt es immer metrische und imperiale, aber keine nautischen Längenangaben.  
==== Beispiel ====
{{#display_map:
50.896565409146, 7.0046392682163 ~ Standardstelle;
50.897161908399, 7.0045759683126 ~ Unbucht ~ Ehemalige militärische Landungsstelle, inzwischen verlandend. ~ Symbol_Hafen.svg;
50.896788153445, 7.0036540031654 ~ ~ ~ Symbol_Achtung.svg
| center=50.896910520501, 7.0043603184785
| width=40%
| height=400
| zoom=17
| service=openlayers
| layers=OpenSeaMap, OpenStreetMap
| copycoords=yes
| resizable=yes
| polygons=
50.896854017711,7.0040556192724:50.896813416446,7.0043077469198:50.896864168021,7.0045223236411:50.896969054435,7.0042380094855:50.896985971577,7.0040502548544 ~ Schatzeck ~ Link führt zur [[#MediaWiki-Extension 'Maps'|Überschrift]]. ~ #0000ef ~ 1 ~ 3 ~ #ffff00 ~ 0.9
| lines=
50.896781386612,7.0037344694354:50.896588529937,7.004549860976~Rote Linie ~ Überschreitung möglich abhängig vom Wasserstand ~ #ff0000 ~ 0.6 ~ 6;
50.89660206376,7.0031497478703:50.896196047324,7.0052311420659:50.896426123842,7.0063040256718 ~ Grüne Linie ~ ~ #44aa44 ~ 0.8 ~ 4
}}
{{MaßstabGM}}


=== Karten direkt aus OpenSeaMap ===
=== Karten direkt aus OpenSeaMap ===
Abgerufen von „https://skipperguide.de/wiki/SkipperGuide:Features/Karten_und_Skizzen“