Vorlage:Koordinate/Dokumentation: Unterschied zwischen den Versionen

aus SkipperGuide, dem Online-Revierführer über die Segelreviere der Welt.
Zur Navigation springen Zur Suche springen
Zeile 10: Zeile 10:
  <nowiki>{{Koordinate|U|Parameter1|Parameter2|Parameter3|Parameter4}}</nowiki>
  <nowiki>{{Koordinate|U|Parameter1|Parameter2|Parameter3|Parameter4}}</nowiki>
Die Bestandteile im Einzelnen:  
Die Bestandteile im Einzelnen:  
;<code>{{</code>
; <code>{{</code>
:zeigt dem Programm an, dass eine Vorlage eingebunden werden soll ('''<code>}}</code>''' bedeutet das Ende eines Vorlagenbefehls).  
: zeigt dem Programm an, dass eine Vorlage eingebunden werden soll ('''<code>}}</code>''' bedeutet das Ende eines Vorlagenbefehls).  
;<code>Koordinate</code>  
 
:ist der Titel der Vorlage, die das Programm einfügen soll. Es folgt optional die Angabe von Parametern, getrennt durch einen senkrechten Strich. Bei dieser Vorlage sind es drei Parameter:  
; <code>Koordinate</code>  
: ist der Titel der Vorlage, die das Programm einfügen soll. Es folgt optional die Angabe von Parametern, getrennt durch einen senkrechten Strich. Bei dieser Vorlage sind es drei Parameter:  
 
;<code>Parameter1</code>
;<code>Parameter1</code>
:Festlegung, welche Art von Landmarke die Koordinate definiert.
:Festlegung, welche Art von Landmarke die Koordinate definiert.
Zeile 23: Zeile 25:
[leer] - nicht definiert
[leer] - nicht definiert
</pre>
</pre>
;<code>Parameter2</code>
 
:SkipperGuide verlinkt zur Zeit zu OpenSeaMap, an dieser Stelle werden die Koordinaten festgelegt, auf die die sich dort öffnende Karte zentriert ist. Außerdem dienen sie zur Festlegung der Ankerpunkte in den OpenSea-Karten für die Verlinkungen von ebendort zurück zu den ''SkipperGuide''-Artikeln.  
; <code>Parameter2</code>
:Erwartet wird eine Angabe in den folgenden Formaten (<code>d</code> steht für Gradzahl, <code>m</code> für Minutenzahl, <code>s</code> für Sekundenzahl, <code>H</code> für Angabe der Hemisphäre, also N oder S, bzw. E oder W):  
: SkipperGuide verlinkt die hier eingefügte Koordinate mit OpenSeaMap. Bei Klick auf die Koordinate im Artikel öffnet sich automatisch die Karte und zeigt ein Hafen-Icon an der angegebenen Stelle. Bei Klick auf das Icon in der Karte erscheint automatisch der zugehörige Artikel in SkipperGuide.
::;<code>d.d_H_d.d_H</code>
: Erwartet wird eine Angabe in den folgenden Formaten (<code>d</code> steht für Gradzahl, <code>m</code> für Minutenzahl, <code>s</code> für Sekundenzahl, <code>H</code> für Angabe der Hemisphäre, also N oder S, bzw. E oder W):  
:::beliebige Anzahl an Nachkommastellen
::; <code>d.d_H_d.d_H</code>
::;<code>d_m.m_H_d_m.m</code>
::: beliebige Anzahl an Nachkommastellen
:::beliebige viele Nachkommastellen ausschließlich bei den Minuten
::; <code>d_m.m_H_d_m.m</code>
::;<code>d_m_s.s_H_d_m_s.s_H</code>
::: beliebige viele Nachkommastellen ausschließlich bei den Minuten
:::beliebige viele Nachkommastellen ausschließlich bei den Sekunden
::; <code>d_m_s.s_H_d_m_s.s_H</code>
::*Als Dezimaltrennzeichen erkennt OSeaM ausschließlich einen Punkt, kein Komma.  
::: beliebige viele Nachkommastellen ausschließlich bei den Sekunden
::*Unterstriche als Trennung von Gruppen können bei eindeutiger Angabe weggelassen werden.  
::* Als Dezimaltrennzeichen erkennt OSeaM ausschließlich einen Punkt, kein Komma.  
::*Leerzeichen werden allerdings falsch interpretiert, ebenso Schriftzeichen für Grad, Minuten oder Sekunden.  
::* Unterstriche als Trennung von Gruppen können bei eindeutiger Angabe weggelassen werden.  
::*Möglicherweise werden noch andere Formate erkannt.  
::* Leerzeichen werden allerdings falsch interpretiert, ebenso Schriftzeichen für Grad, Minuten oder Sekunden.  
;<code>Parameter3</code>
::* Möglicherweise werden noch andere Formate erkannt.  
:Das Feld ist gedacht, um eine "lesbare" Form der Koordinaten anzugeben - so wie sie im eigentlichen Artikel erscheinen sollen. Die Form ist frei wählbar, im Zweifelsfall kopiert ihr den Inhalt vom ersten Parameter.  
 
:Für ein einheitliches Erscheinungsbild empfiehlt sich jedoch das Format  
; <code>Parameter3</code>
: Das Feld ist gedacht, um eine "lesbare" Form der Koordinaten anzugeben - so wie sie im eigentlichen Artikel erscheinen sollen. Die Form ist frei wählbar, im Zweifelsfall kopiert ihr den Inhalt vom ersten Parameter.  
: Für ein einheitliches Erscheinungsbild empfiehlt sich jedoch das Format  
  dd° mm,mmm' H  ddd° mm,mmm' H
  dd° mm,mmm' H  ddd° mm,mmm' H
:*Bei den Grad- wie bei den Minutenangaben wird eine eventuelle führende Null (bei der Längengradzahl sind zwei Nullen möglich) immer mit ausgeschrieben.  
:* Bei den Grad- wie bei den Minutenangaben wird eine eventuelle führende Null (bei der Längengradzahl sind zwei Nullen möglich) immer mit ausgeschrieben.  
:*Bei den Minuten werden nach Bedarf bis zu drei Nachkommastellen angegeben.  
:* Bei den Minuten werden nach Bedarf bis zu drei Nachkommastellen angegeben.  
:*Den größeren Abstand zwischen Breiten und Längenangabe erreicht man durch die Eingabe von zwei geschützen Leerzeichen (<code>&amp;nbsp;&amp;nbsp;</code>). Diese Form wird auch in offiziellen Veröffentlichen verwendet, und so ist sie im Funkverkehr einschließlich der Sicherheits- und Notmeldungen zur Übermittlung von Koordinaten vorgegeben.  
:* Den größeren Abstand zwischen Breiten und Längenangabe erreicht man durch die Eingabe von zwei geschützen Leerzeichen (<code>&amp;nbsp;&amp;nbsp;</code>). Diese Form wird auch in offiziellen Veröffentlichen verwendet, und so ist sie im Funkverkehr einschließlich der Sicherheits- und Notmeldungen zur Übermittlung von Koordinaten vorgegeben.  
:Die Koordinatendarstellungen werden sukzessive auf dieses Format umgestellt.  
: Die Koordinatendarstellungen werden sukzessive auf dieses Format umgestellt.  
;<code>Parameter4</code>
 
:Hierhin gehört eine kurze Bezeichung, ursprünglich gedacht als Text, der beim Export zur Google-Earth-Darstellung die dort dargestellten Koordinaten beschreibt.  
; <code>Parameter4</code>
: Hierhin gehört eine kurze Bezeichung, ursprünglich gedacht als Text, der beim Export zur Google-Earth-Darstellung die dort dargestellten Koordinaten beschreibt.


=== Beispiel ===
=== Beispiel ===

Version vom 5. Juni 2012, 12:10 Uhr

Beschreibung

Die Vorlage:Koordinaten hat mehrere Funktionen:

  • sie dient zur einheitlichen Darstellung von Koordinaten,
  • sie verlinkt zu Kartenanbietern und liefert Koordinaten für die Kartenauswahl,
  • verfügt über ein Feld für die frei wählbare Darstellung der Koordinaten im Artikel,
  • beinhaltet eine Kurzbeschreibung, bestimmt für den Export in Google-Earth

Syntax

Im SkipperGuide-Artikel wird diese Vorlage mit folgender Syntax eingebunden:

{{Koordinate|U|Parameter1|Parameter2|Parameter3|Parameter4}}

Die Bestandteile im Einzelnen:

{{
zeigt dem Programm an, dass eine Vorlage eingebunden werden soll (}} bedeutet das Ende eines Vorlagenbefehls).
Koordinate
ist der Titel der Vorlage, die das Programm einfügen soll. Es folgt optional die Angabe von Parametern, getrennt durch einen senkrechten Strich. Bei dieser Vorlage sind es drei Parameter:
Parameter1
Festlegung, welche Art von Landmarke die Koordinate definiert.
H - Hafen/Harbour
M - Marina
A - Ankerbucht/Anchorage
R - Region
[leer] - nicht definiert
Parameter2
SkipperGuide verlinkt die hier eingefügte Koordinate mit OpenSeaMap. Bei Klick auf die Koordinate im Artikel öffnet sich automatisch die Karte und zeigt ein Hafen-Icon an der angegebenen Stelle. Bei Klick auf das Icon in der Karte erscheint automatisch der zugehörige Artikel in SkipperGuide.
Erwartet wird eine Angabe in den folgenden Formaten (d steht für Gradzahl, m für Minutenzahl, s für Sekundenzahl, H für Angabe der Hemisphäre, also N oder S, bzw. E oder W):
d.d_H_d.d_H
beliebige Anzahl an Nachkommastellen
d_m.m_H_d_m.m
beliebige viele Nachkommastellen ausschließlich bei den Minuten
d_m_s.s_H_d_m_s.s_H
beliebige viele Nachkommastellen ausschließlich bei den Sekunden
  • Als Dezimaltrennzeichen erkennt OSeaM ausschließlich einen Punkt, kein Komma.
  • Unterstriche als Trennung von Gruppen können bei eindeutiger Angabe weggelassen werden.
  • Leerzeichen werden allerdings falsch interpretiert, ebenso Schriftzeichen für Grad, Minuten oder Sekunden.
  • Möglicherweise werden noch andere Formate erkannt.
Parameter3
Das Feld ist gedacht, um eine "lesbare" Form der Koordinaten anzugeben - so wie sie im eigentlichen Artikel erscheinen sollen. Die Form ist frei wählbar, im Zweifelsfall kopiert ihr den Inhalt vom ersten Parameter.
Für ein einheitliches Erscheinungsbild empfiehlt sich jedoch das Format
dd° mm,mmm' H  ddd° mm,mmm' H
  • Bei den Grad- wie bei den Minutenangaben wird eine eventuelle führende Null (bei der Längengradzahl sind zwei Nullen möglich) immer mit ausgeschrieben.
  • Bei den Minuten werden nach Bedarf bis zu drei Nachkommastellen angegeben.
  • Den größeren Abstand zwischen Breiten und Längenangabe erreicht man durch die Eingabe von zwei geschützen Leerzeichen (&nbsp;&nbsp;). Diese Form wird auch in offiziellen Veröffentlichen verwendet, und so ist sie im Funkverkehr einschließlich der Sicherheits- und Notmeldungen zur Übermittlung von Koordinaten vorgegeben.
Die Koordinatendarstellungen werden sukzessive auf dieses Format umgestellt.
Parameter4
Hierhin gehört eine kurze Bezeichung, ursprünglich gedacht als Text, der beim Export zur Google-Earth-Darstellung die dort dargestellten Koordinaten beschreibt.

Beispiel

Als Beispiel dient die Einfahrt zum Rheinauhafen in Köln:

Folgende Beispiele unterscheiden sich in den Eingaben für Parameter1:

{{Koordinate|H|50.9321833_N_6.9637333_E|50° 55,931' N  006° 57,824' E|Rheinauhafen}}
{{Koordinate|H|50_55.931_N_6_57.824_E|50° 55,931' N  006° 57,824' E|Rheinauhafen}}
{{Koordinate|H|50_55_55.86_N_6_57_49.44.824_E|50° 55,931' N  006° 57,824' E|Rheinauhafen}}
{{Koordinate|H|50.9321833N6.9637333E|50° 55,931' N  006° 57,824' E|Rheinauhafen}}

Auf der Artikelseite wäre das Erscheinungsbild in allen vier Fällen:

Koordinaten: 50° 55,931' N  006° 57,824' E Die folgende Koordinate wurde nicht erkannt: 50° 55,931' N  006° 57,824' E.