Cowboy am 10. März 2025 um 00:10 Uhr

2025-03-10T00:10:21Z

← Nächstältere Version		Version vom 10. März 2025, 02:10 Uhr
Zeile 2:		Zeile 2:
	Diese Vorlage dient der Verlinkung des „[[CowboysWiki:Technik/Cloud/geohack\|Geohacks]]“. 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 Vorlage dient der Verlinkung des „[[CowboysWiki:Technik/Cloud/geohack\|Geohacks]]“. 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 [[CW:VWS\|Vorlagenwerkstatt]], Wünsche und Vorschläge zu Formatänderungen sind im [[WD:WikiProjekt Georeferenzierung\|GEO-Projekt]] anzutragen.		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 [[CW:VWS\|Vorlagenwerkstatt]], Wünsche und Vorschläge zu Formatänderungen sind im [[CWD:WikiProjekt Georeferenzierung\|GEO-Projekt]] anzutragen.

	== Kopiervorlage ==		== Kopiervorlage ==

Cowboy: Neu angelegt

2025-03-10T00:07:06Z

Neu angelegt

Neue Seite

<noinclude>{{Dokumentation/Dokuseite}}</noinclude>
Diese Vorlage dient der Verlinkung des „[[CowboysWiki:Technik/Cloud/geohack|Geohacks]]“. 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 [[CW:VWS|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;">
{{CoordinateLink
|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 bezeichneten 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 jeweils 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

Cowboy am 10. März 2025 um 00:10 Uhr

Cowboy: Neu angelegt