Vorlage:Koordinate: Unterschied zwischen den Versionen

aus SkipperGuide, dem Online-Revierführer über die Segelreviere der Welt.
Zur Navigation springen Zur Suche springen
(Erster Wurf einer Dokumentation, tbcont)
K (Beschreibung erweitert)
Zeile 1: Zeile 1:
== Dokumentation ==
== Übersicht ==
Diese Vorlage hat mehrere Funktionen:  
Diese Vorlage hat mehrere Funktionen:  
*sie dient zur einheitlichen Darstellung von Koordinaten,  
*sie dient zur einheitlichen Darstellung von Koordinaten,  
Zeile 6: Zeile 6:
*beinhaltet eine Kurzbeschreibung, bestimmt für den Export in Google-Earth
*beinhaltet eine Kurzbeschreibung, bestimmt für den Export in Google-Earth


Im Artikel wird die Vorlage mit folgender Syntax eingebunden:  
== Syntax ==
Im ''SkipperGuide''-Artikel wird diese Vorlage mit folgender Syntax eingebunden:  
  <nowiki>{{Koordinate|U|Parameter1|Parameter2|Parameter3}}</nowiki>
  <nowiki>{{Koordinate|U|Parameter1|Parameter2|Parameter3}}</nowiki>
Die Bestandteile im Einzelnen:  
Die Bestandteile im Einzelnen:  
*<nowiki>{{ zeigt dem Programm an, dass eine Vorlage eingebunden werden soll. }} bedeutet das Ende eines Vorlagenbefehls</nowiki>
;<code>{{</code>
*"Koordinate" ist der Titel der Vorlage, die das Programm einfügen soll. Es folgt optional die Angabe von Parametern, getremmt durch einen senkrechten Strich. Bei dieser Vorlage sind es drei Parameter:  
:zeigt dem Programm an, dass eine Vorlage eingebunden werden soll ('''<code>}}</code>''' bedeutet das Ende eines Vorlagenbefehls).
* Parameter1: SkipperGuide verlinkt zur Zeit an dieser Stelle zu OpenSeaMap, an dieser Stelle werden die Koordinaten festgelegt, auf die sich die dort öffnende Karte zentriert ist. Erwartet wird eine Angabe in den 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) (Achtung: als Dezimaltrennzeichen wird ausschließlich ein Punkt erkannt, 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):  
;<code>Koordinate</code>  
**d.d_H_d.d_H
: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:  
**d_m.mmm_H_d_m.mmm
;<code>Parameter1</code>
**d_m_s.s_H_d_m_s.s_H
: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.
*Parameter2
: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):  
*Parameter3
::;<code>d.d_H_d.d_H</code>
:::beliebige Anzahl an Nachkommastellen
::;<code>d_m.m_H_d_m.m</code>
:::beliebige viele Nachkommastellen ausschließlich bei den Minuten
::;<code>d_m_s.s_H_d_m_s.s_H</code>
:::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.
;<code>Parameter2</code>
:Das Feld ist gedacht, um eine "lesbare" Form der Koordinaten anzugeben, der Inhalt wird im eigentlichen Artikel ausgegeben. Die Form ist frei wählbar, im Zweifelsfall übernehmt 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 (<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.
;<code>Parameter3</code>
:Hierhin gehört eine kurze Bezeichung, ursprünglich gedacht als Text, der beim Export zur Google-Earth-Darstellung die dort dargestellten Koordinaten beschreibt.


== Vorlage ==
== Beispiel ==
 
----
'''Die eigentliche Vorlage:'''
<onlyinclude>
<onlyinclude>
''Koordinaten: [http://www.skipperguide.de/extension/OSeaMRedirect.php?coord={{{1}}} {{{2}}}]''
''Koordinaten: [http://www.skipperguide.de/extension/OSeaMRedirect.php?coord={{{1}}} {{{2}}}]''
</onlyinclude>
</onlyinclude>

Version vom 18. September 2010, 14:50 Uhr

Übersicht

Diese Vorlage 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}}

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
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.
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.
Parameter2
Das Feld ist gedacht, um eine "lesbare" Form der Koordinaten anzugeben, der Inhalt wird im eigentlichen Artikel ausgegeben. Die Form ist frei wählbar, im Zweifelsfall übernehmt 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.
Parameter3
Hierhin gehört eine kurze Bezeichung, ursprünglich gedacht als Text, der beim Export zur Google-Earth-Darstellung die dort dargestellten Koordinaten beschreibt.

Beispiel


Die eigentliche Vorlage:

Koordinaten: {{{2}}}