Geiserich77: Die Seite wurde neu angelegt: „{{Dokumentation/Dokuseite}} Diese Vorlage dient der Verlinkung des „Geohacks“ auf dem Toolserver. Sie…“

2014-08-31T18:11:39Z

Die Seite wurde neu angelegt: „<noinclude>{{Dokumentation/Dokuseite}}</noinclude> Diese Vorlage dient der Verlinkung des „Geohacks“ auf dem Toolserver. Sie…“

Neue Seite

<noinclude>{{Dokumentation/Dokuseite}}</noinclude>
Diese Vorlage dient der Verlinkung des [[tools:~geohack/geohack.php|„Geohacks“]] auf dem Toolserver. Sie weist dabei umfangreiche Formatierungsmöglichkeiten hinsichtlich des Linktextes und des Tooltips auf. Sie beinhaltet keinerlei Fehlererkennung mehr und unbenutzte Parameter dürfen nicht weggelassen werden; Ihre Einbindung sollte daher nur aus anderen Vorlagen erfolgen.

Diese Dokumentation richtet sich an Vorlagenautoren, die genau wissen was sie tun, für Endanwender und Infoboxautoren sei auf die Dokumentationen der [[Vorlage:Coordinate]]/[[Vorlage:CoordinateComplex|CoordinateComplex]] sowie [[Vorlage:Positionskarte]][[Vorlage:Positionskarte+|(+)]] verwiesen. Fragen zur Programmierung an die [[WP:WVW|Vorlagenwerkstatt]], Wünsche und Vorschläge zu Formatänderungen sind im [[WD:WikiProjekt Georeferenzierung|GEO-Projekt]] anzutragen.

== Kopiervorlage ==
…bedeutet: Nicht (so) verwenden, aber das hier ist die offizielle Aufstellung der verwendeten Parameter.
<pre style="white-space:pre-wrap;">
{{Coordinate/Link
|NS =
|EW =
|globe =
|type =
|pop =
|elevation =
|dim =
|dim_safe =
|region =
|name =
|label =
|trenner =
|tooltip =
|ttf =
|format =
|datei =
|0 =
|1 =
|2 =
}}
</pre>

== Parameter ==

;NS, EW
: Breiten- und Längengrad als Zahl. Es werden nur ihre Absolutwerte ausgegeben, als Suffix dazu die jeweilige Himmelsrichtung.
;dim
: Dimension des Objektes in Metern, wird ungeprüft übernommen
;globe
: Referensystem der Koordinatenangabe, z.B. <code>moon</code>. Anstatt <code>earth</code> ist der Parameter leerzulassen, da dieses System als Standard keine Ausgabe haben soll.
;region, type
: Werden nur (ungeprüft) ausgegeben, wenn '''globe''' leer ist.
;pop
: Wird bei type = (<code>country</code>|<code>state</code>|<code>adm1st</code>|<code>adm2nd</code>|<code>city</code>|<code>isle</code>) ausgegeben
;elevation
: Wird nur bei type = <code>mountain</code> ausgegeben.
;name
: Wird url-encodiert ausgegeben, darf also Leerzeichen enthalten.
Für alle diese URL-Parameter '''dim''', '''globe''', '''region''', '''type''', '''pop''', '''elevation''' und '''name''' gilt, dass ihre Link-Präfixe nur vorangestellt werden wenn die Parameter nicht leer sind.
;dim_safe
: Dieser Zahl-Parameter ist für den den Formatierungsvorlagen übergebenen Rundungsparameter zuständig. Es gilt
{| class="wikitable" style="margin-left:2em;"
! dim_safe !! round-wert
|-
| leer || -2
|-
| >50000 || -4
|-
| >10000 || -2
|-
| >250 || 0
|-
| >25 || 1
|-
| <=25 || 2
|-
| keine Zahl || grausige Fehlermeldung
|}
;label
: Steuert, ob der zweite Koordinatenausgabe ihre Bezeichnung vorangestellt wird. Dieser Parameter ist nur bei Ausgabe eines zweiten Formats erforderlich.
;trenner
: Wird zwischen erster und zweiter Koordinatenausgabe angezeigt, ist also nur bei Ausgabe eines zweiten Formats erforderlich. Muss das Leerzeichen enthalten, falls eines gewünscht ist. Ist der Parameter mit <code>&32;(</code> belegt, so wird hinter der zweiten Ausgabe eine schließende Klammer eingefügt.
;tooltip
: Wird dieser Parameter angeben, wird die gesamte Ausgabe mit einem [[Tooltip]] belegt. Dies muss nicht immer sinnvoll sein, da einige Ausgabeformate eigene Tooltips mitbringen. In den Ausgabeformaten '''0''' und '''datei''' wird standardmäßig der '''name''' verwendet, wenn der Parameter leer ist.
;ttf
: Kurz für ToolTipFormat. In den Ausgabeformaten '''0''' und '''datei''' wird - so der Parameter nicht leer ist - an den Tooltip eine Ausgabe im bezeichnten Format angehängt. Dazu muss eine entsprechende [[#Formate|tagless-Vorlage]] vorhanden sein. Sollte es keinen Tooltip geben, wird der automatisch verwendete '''name''' mit einem Doppelpunkt ergänzt.
;format
: Dieser Parameter steuert spezielle [[#Formate|Ausgabeformate]] bei Nutzung der Textausgabe mittels der Parameter '''1''' und '''2'''. Einzig sinnvoller, nicht-leerer Wert ist <code>sortable</code>.
;datei
: Ist dieser Parameter gefüllt, so wird ein Wikilink ausgeben. Neben Debugzwecken dient er zur Ausgabe des Geohack-Links als Parameter einer Dateieinbindung. Die Syntax des Links sieht folgendermaßen aus: <code><nowiki>[[{{{datei}}}|link=<toolserver-link>|<generierte Tooltips>]]</nowiki></code>. Es sollte daher ein Wert wie <code><nowiki>Datei:<name>.<endung>{{!}}AxBpx{{!}}alt=<alt-Text></nowiki></code> oder andere [[H:Bilder|Bildersyntax]] verwendet werden. Bitte berücksichtige die [[H:Bilder#Link|Richtlinien]] zum Einbinden von Bildern ohne Link auf deren Dateibeschreibungsseite! Für die korrekte Tooltipausgabe ist es notwendig, dass der Parameter '''0''' gefüllt wird.
;0
: Ist dieser Parameter gefüllt (und '''datei''' leer), so wird er als Linktext ausgegeben. Zudem wird immer ein Tooltip generiert, siehe oben.
;1, 2
: Sind diese Parameter gefüllt (und weder '''datei''' noch '''0'''), so werden die entsprechenden [[#Formate|Ausgabeformat-Vorlagen]] als Linktext eingebunden. Es gilt zu berücksichtigen, dass das zweite Format nicht ausgegeben wird, wenn beide gleich sind, dies gilt auch für <code>|1=DM|2=DMS</code>. Vor der zweiten Ausgabe wird der '''trenner''' angezeigt, ob sie bezeichnet wird ist über den Parameter '''label''' steuerbar.

=== Formate ===
Es stehen die folgenden Formate zur Verfügung: {{Spezial:Präfixindex/Vorlage:Coordinate/to }}
Neben den verschiedene Systemen (<code>DMS</code>, <code>CH1903</code>, <code>DEC</code>) stehen jeweilse verschiedene Spezialformate zur Verfügung, neben der Normalausgabe ohne Suffix sind das <code>sortable</code> und <code>tagless</code>. Sie lassen sich bei den Ausgaben '''1''' und '''2''' mit dem Parameter '''format''' anwählen; der Tooltip (Parameter '''ttf''') verwendet immer <code>tagless</code>. Eingebunden werden die Vorlagen folgendermaßen:
<pre style="white-space:pre-wrap;">
{{Coordinate/to <Formatname>
|label = leer oder gefüllt: Name (Label) des Koordinatensystem ausgeben?
|NS = Zahl (Parameter NS)
|EW = Zahl (Parameter EW)
|round = der oben bei Parameter „dim“ beschriebene round-Wert (als #expr-Ausdruck)

}}
</pre>

Eventuell sind für zukünftige Formatierungen noch weitere Parameter (<code>elevation</code>, <code>region</code>) erforderlich<ref>[http://www.geodatenzentrum.de/geodaten/gdz_rahmen.gdz_div?gdz_spr=deu&gdz_akt_zeile=6&gdz_anz_zeile=3&gdz_user_id=0 Georeferenzierungen Deutschland]</ref><ref>[http://www.ordnancesurvey.co.uk/oswebsite/gps/osnetfreeservices/furtherinfo/questdeveloper.html Ordnance Survey Grait Britain] Ausführliche Dokumentation zum Herunterladen (englisch)</ref>, etwa für eine [[Helmert-Transformation]].

<references />

Vorlage:CoordinateLink/Doku - Versionsgeschichte

Geiserich77: Die Seite wurde neu angelegt: „{{Dokumentation/Dokuseite}} Diese Vorlage dient der Verlinkung des „Geohacks“ auf dem Toolserver. Sie…“