Vorlage:Quickbar Ort/Doku

Aus Wikivoyage
Zur Navigation springen Zur Suche springen

Funktion

Die Vorlage dient zur Ausgabe von Kurzdaten für Städte, Großstädte oder Kleinstädte aber auch Flughäfen. Die Anzeige erfolgt als umflossene Box am rechten Rand, die Box ist 300px breit. Alle angezeigten Infos sind optional und zum großen Teil in der Lage, ihre Werte auch von Wikidata zu beziehen. Alle Parameter funktionieren nach dem folgenden Prinzip:

  • Parameter angeben -> Information wird in die Quickbar als neue Zeile eingefügt.
  • Parameter aktivieren -> Information wird aus Wikidata geholt (Normalfall bei Flaggen, Siegeln, Lagekarten, evtl. Hauptstadt).
  • Parameter benutzen und befüllen -> Übergebene Information wird ausgegeben.

Etwas weiter unten wird die Funktionalität und ihre Handhabung noch ein mal genau beschrieben. Ausnahme: Die Positionskarte am unteren Ende der Quickbar wird nach Möglichkeit immer erzeugt, auch wenn der entsprechende Kartenparameter nicht angegeben ist. Erst wenn auf Wikidata keine Landeskennung und Koordinaten verfügbar sind, wird die Ausgabe unterdrückt.

Verwendung

{{Quickbar Ort |parameter-1=wert-1 |parameter-2=wert-2 |... |parameter-n=wert-n }}

Groß- und Kleinschreibung spielt bei den Parametern keine Rolle:

  • |id= ist gleich |ID=
  • |bild= ist gleich |Bild=

Allgemein gültige Parameter

Die allgemein gültigen Parameter sind in allen Vorlagen verfügbar, die auch das Submodul Check2 benutzen. Durch die Verwendung dieser Parameter kann man Fehlermeldungen bei der Verwendung der Vorlage individuell unterdrücken/aktivieren. Bei den meisten Vorlagen sind die Fehlermeldungen aktiviert. Benutzt man die Vorlage zu Demonstrationszwecken an unvorhergesehener Stelle ist es manchmal vonnöten, den Fehler zu akzeptieren und die Meldung zu unterdrücken.

  • |ignore_errors= auf 1 oder true gesetzt, werden die Ausgabe der Fehlermeldungen der Funktionen unterdrückt. Standardmäßig werden die Fehler angezeigt.
  • |no_category= auf 1 oder true gesetzt, werden die Artikel bei Fehlermeldungen des Moduls einer Fehlerkategorie zugeordnet. Standardmäßig werden Fehlermeldungen in die Kategorie Fehlerberichte des Moduls Quickbar Ort eingefügt. Wurden unbekannte Parameter verwendet landen die Artikel zusätzlich in der Kategorie Vorlagen mit unbekannten Parametern.
  • |error_category= gibt den Namen einer Fehlerkategorie an, in der der Artikel bei auftretenden Fehlern einsortiert wird. Standardmäßig ist das Fehlerberichte des Moduls Quickbar Ort.

Folgende Einstellungen werden in dieser Vorlage verwendet

  • |ignore_errors=false – Fehler werden im Artikel angezeigt
  • |no_category=false – Artikel, bei denen die Vorlage falsch benutzt wurde, werden kategorisiert
  • |error_category= – Die Fehlerkategorie lautet Fehlerberichte des Moduls Quickbar Ort

Position im Artikel

Platziere die Quickbar immer an den Anfang des Artikels. Manchmal wirst du sie bei bestehenden Artikeln noch hinter dem Einleitungssatz vorfinden. Bitte positioniere sie dann noch vor die Einleitung. Dies ist wichtig für eine ansprechende Darstellung in der mobilen Version, speziell auf dem Smartphone.

Steuerung der Parameter / Nutzung von Wikidata

Alle Parameter können auch mit Werten belegt werden, die bestimmte Verhaltensweisen der Quickbar beeinflussen.

  • Ein Parameter wird benutzt und enthält einen Wert wie 1/ja/yes/j/y/true: Die Quickbar zeigt diese Information in der Quickbar an und holt sich die nötigen Informationen von Wikidata. Steht dort nichts, wird nichts angezeigt. Nutzer von den Wikidata Tools bekommen die Meldung, dass keine Daten vorhanden sind sowie einen Link zur Erfassung auf Wikidata.
  • Ein Parameter wird benutzt und enthält keinen Wert: Dei Wirkung ist identisch mit der obigen Variante. Allerdings löscht der Visual Editor derzeit noch leere Parameter aus den Vorlagen. Sicherer ist es derzeit, ein 1/ja/yes/j/y/true mit anzugeben.
  • Ein Parameter wird benutzt und enthält eine beliebige Information: Die Quickbar stellt diese Information dar und ignoriert mögliche Informationen von Wikidata. Für Nutzer der Wikidata Tools wird die Information aber mit Wikidata verglichen und Unterschiede werden zusätzlich angezeigt und die Daten können editiert gleich werden.
  • |auto= Dieser Parameter neutralisiert die obige Funktionalität der Verwendung von Parametern in der Quickbar und aktiviert gleichzeitig alle Parameter. Diese müssen dann nicht mehr explizit angegeben werden. Alle Daten werden aus Wikidata befüllt, sofern sie dort erfasst sind, können aber trotzdem noch mit lokalen Angaben überschrieben werden. Mögliche Werte sind: 1/ja/yes/j/y/true bzw. 0/nein/no/n/false.
  • Ein Parameter wird benutzt und enthält einen Wert wie 0/nein/no/n/false: Die Quickbar unterdückt diese Information (auch wenn die Option auto aktiviert ist.). Somit kann man zum Beispiel Einwohnerzahlen bei Seen unterdrücken, da sie keinen Sinn machen.

Typen

Die Quickbar kennt zwei Typen, die sich inhaltlich unterscheiden und die man über einen Parameter steuern kann:

  • |typ=ort Dies ist Standard. Mann kann den Parameter dann auch ganz weglassen. Dieser Typ wird in allen Orten von Dorf bis Großstadt eingesetzt und zeigt dich wichtigen Kenndaten für Orte an.
  • |typ=flughafen Diese Quickbarangabe wird in Artikeln über Flughäfen eingesetzt und gibt spezielle Informationen wie ein Logo, IATA-Code und Passagierzahlen aus.

Mögliche Parameter

Folgende Parameter sind in der Quickbar benutzt. Unbekannte Parameter erzeugen eine Fehlermeldung neben der Quickbar. Zusätzlich wird der Artikel in der Wartungskategorie Fehlerberichte des Moduls Quickbar Ort gelistet.

Standardparameter

  • |id= Dieser Parameter ist ein Spezialfall. Normalerweise möchtest du die Informationen zum aktuellen Artikel anzeigen. Ist dies nicht der Fall, kannst du hier die Wikidata-ID eines beliebigen Objektes angeben. Aus diesem bezieht die Quickbar dann ihre Daten. Angewendet wird dies nur, um beispielhafte Quickbars in anderen Artikeln wie Hilfe-Artikeln oder Vorlagendokumentationen anzuzeigen.
  • |Bild= Der Parameter nimmt das Bild auf, das ganz oben in der Quickbar dargestellt wird. Es ist in kompletter Wiki-Syntax mit eckigen Klammern anzugeben. Ist nichts angegeben, bedient sich die Quickbar auf Wikidata. Dort kann es vorkommen, das kein Bild eine bevorzugte Priorität zugewiesen hat und eine Liste von Bildern geliefert wird. In diesem Fall wird das erste angezeigt, das von der Datenbank geliefert wird.
  • |Namen= Die Verwendung ermöglicht die Angabe einer alternativen Überschrift. Normalerweise wird dort der Artikelname eingetragen. Möchtest du beispielsweise den Ortsnamen in verschiedenen Sprachen angeben, kannst du diesen Parameter benutzen. Schreibe nach Möglichkeit nicht zu viel Text, eine mehrzeilige Überschrift in der Quickbar kann schnell etwas zu wuchtig wirken.

Quickbar für Orte

  • |Einwohner= Dieser Wert gibt die Einwohnerzahl des Ortes an. Auch wenn eine Zahl angegeben wird, schaut die Quickbar auf Wikidata nach. Wer die Wikidata Tools aktiviert hat, bekommt einen Hinweis, sollte die Angabe auf Wikidata abweichen. Alle anderen Leser bekommen von diesem Prozess nichts mit.
  • |Höhe= Hier kann man die mittlere Höhe des Ortes angeben. Bezüglich Wikidata arbeitet dieses Feld genau so wie die Einwohnerzahl hier drüber. Die Maßeinheit und Tausenderpunkte werden automatisch ergänzt.
  • |Provinz= Diese Option liefert die Provinz, der ein Orte angehört. In der Regel geben wir hier die erste administrative Hierarchiestufe eines Landes an. In Deutschland ist dies das Bundesland. In anderen Staaten sind es Woiwodschaft, Bundesstaat, Gouvernement, Departement, Präfektur, Gespanschaft oder etwas ähnliches. Hier ist es der einfachste Weg, den Parameter zu benutzen, aber leer zu lassen. Dann wird auf Wikidata die passende Region herausgesucht, in dem die administrativen Einheiten nach oben durchlaufen werden, bis das passende Objekt gefunden wurde. Bleibt der Eintrag trotzdem leer, müssen noch Daten nacherfasst werden. Hier empfehlen wir dir, die fehlenden Daten auf Wikidata einzugeben. Eine detailliertere Erklärung dazu findest du unter den Hilfe:Wikidata Tools. Diese helfen dir auch bei der Analyse eventueller Defizite bei der Erfassung der Verwaltungseinheiten. In vielen Ländern haben wir aber einen brauchbaren Erfassungsstand. Funktioniert es trotz aller Bemühungen doch nicht, kannst du natürlich jederzeit einen manuellen Eintrag vornehmen.
  • |Provinzlabel= Hiermit gibt man die Bezeichnung der Verwaltungseinheit an. Sie steht links in der Quickbar (standardmäßig fett geschrieben). Wird die Provinz von Wikidata bezogen, brauchst du diese Option normalerweise gar nicht zu verwenden. Das System ermittelt selbstständig, wie eine Verwaltungseinheit heißt (Bundesland, Präfektur oder etwas ähnliches). Bei manuellen Angaben kannst du hier aber eine passende Beschreibung angeben.
  • |Karte= Der Parameter spezifiziert die für die Positionsangabe verwendete Karte. Wie oben beschrieben, ist dieser Parameter optional. Die Karte wird nach Möglichkeit immer dargestellt. Standardmäßig wird von der Quickbar eine Landeskarte verwendet. Für die Angabe ist die Top-Level-Domain des Landes zu benutzen. Da sich die Quickbar diese Information von Wikidata holt, kannst du den Parameter komplett weglassen, wenn du die standardmäßige Landeskarte angezeigt haben möchtest. Für einige Länder existieren aber auch Provinzkarten. Dann kannst du den Parameter verwenden. Im Regelfall hat aber die Community sich für eine generelle Regelung entschieden und für ein Land die prinzipielle Verwendung von Provinzkarten festgelegt. In Deutschland ist dies der Fall. Im Modul Quickbar Ort/Locmaps wird dies dann eingestellt. Daher ist die individuelle Verwendung dieses Parameters nur noch eine seltene Ausnahme.
  • Toristeninformation: Für die automatische Anzeige aus Wikidata muss für die Touristeninformation ein eigenes Objekt erzeugt werden. Dieses wird dann im Ort als Property 2872 (Touristeninformation) hinterlegt. Im Objekt selbst müssen dann die Eigenschaften Property 1329 (Telefonnummer) und Property 856 (Offizielle Webseite) befüllt werden. Beispielhaft kannst du es dir in Cottbus anschauen.
    • |TouriInfoWeb= Angabe der Webadresse der offiziellen Tourismusseite des Ortes. Diese kann gegebenenfalls von der offiziellen Webseite abweichen (siehe auch: Offizielle Webseite und Regeln über Weblinks)
    • |TouriInfoTel= Telefonnummer der Tourismusinformation (siehe auch: Telefonnummern)

Quickbar für Flughäfen

  • |Höhe= Hier kann man die mittlere Höhe des Ortes angeben. Bezüglich Wikidata arbeitet dieses Feld genau so wie die Einwohnerzahl hier drüber. Die Maßeinheit und Tausenderpunkte werden automatisch ergänzt.
  • |iata= IATA-Code des Flughafens, der aber im Regelfall auf Wikidata verfügbar ist.
  • |icao= ICAOA-Code des Flughafens, der aber im Regelfall ebenfalls auf Wikidata verfügbar ist.
  • |passagiere= Jährliches Passagieraufkommen, wenn vorhanden mit Jahreszahl in Klammern.
  • |termials= Anzahl der Terminals (nicht auf Wikidata verfügbar).

Veraltete Parameter

Die folgenden Parameter findest du möglicherweise noch in bestehenden Artikeln. Sie sind ohne Funktion und es ist wünschenswert, wenn sie bei passender Gelegenheit entfernt werden:

  • |Kartentyp= Dieser Kartentyp ist entweder leer oder hat den Eintrag relief. Der Kartentyp ist mittlerweile in den Lagekarten landesweise hinterlegt. Standardmäßig ist das die Reliefdarstellung.
  • |Länge= und |Breite= Die Koordinaten des Ortes werden nicht mehr im Artikel gepflegt, sondern grundsätzlich von Wikidata bezogen. Da sie mehrfach benötigt werden, sollen sie zukünftig nur noch in der Datenbank gepflegt werden.

Verkürzte Darstellung

Je nach Informationsgehalt zieht die Quickbar einige Teile optisch zusammen:

  • Sollten alle Parameter zwischen Überschrift und Positionskarte nicht verfügbar sein und leer bleiben, wird die Ausgabe der Zwischenüberschrift „Lagekarte“ unterdrückt. Dann gibt es nur das optionale Bild, den Ortsnamen und die Lagekarte.
  • Werden Telefonnummer und Webseite der Tourist-Info angegeben, steht links nur ein Bezeichner. Dieser heißt dann allgemein "Tourist-Info"

Vollautomatische Quickbar

Möchtest du wenig Aufwand haben und die Quickbar komplett automatisch erzeugen lassen, kannst du an den Artikelanfang einfach die Vorlage {{Autoquickbar Ort}} ohne jeden Parameter setzen. Für Flughäfen gibt es dafür die Vorlage {{Autoquickbar Flughafen}}.

Beispiel

Quickbar für Orte

Alexandria · الإسكندرية
keine Touristinfo auf Wikidata: Touristeninfo nachtragen

{{Quickbar Ort
| Bild         = [[Datei:AlexQaitBay.jpg|300px|mini|Qāitbāy-Zitadelle]]
| Namen        = Alexandria '''·''' الإسكندرية
| Einwohner    =
| Provinz      =
| Höhe         =
| TouriInfoWeb = {{URL|www.alexandriaegypt.com}}
}}

ausführliche Kopiervorlage:
{{Quickbar Ort
| Namen        =
| Höhe         =
| Bild         =
| Provinz      =
| ProvinzLabel =
| Einwohner    =
| TouriInfoWeb =
| TouriInfoTel =
}}

Kopiervorlage für die automatische Variante mit optionaler Angabe eines Bildes:
Diese Version ist die neben der autoquickbar am jäufigsten genutzte Version, da die hier nichtgenutzten Parameter im Regelfall auf Wikidata verfügbar sind.
{{Quickbar Ort
| auto         = yes
| Bild         =
| TouriInfoWeb =
| TouriInfoTel =
}}

Quickbar für Flughäfen

Flughafen Frankfurt am Main
anderer Wert für Passagierzahl auf Wikidata: 69514414 Passagierzahl in Wikidata aktualisieren Eintrag aus der Quickbar entfernen und Wikidata benutzen

Beispiel aus dem Artikel über den Flughafen Frankfurt am Main:
{{Quickbar Ort
|typ=flughafen
|auto=ja
|passagiere=59,57 Mio. pro Jahr <small> • (2014)</small>
}}

ausführliche Kopiervorlage:
{{Quickbar Ort
|typ=flughafen
|auto=
|höhe=
|iata=
|icao=
|passagiere=
|terminals=
}}
Kopiervorlage für die automatische Variante mit optionaler Angabe eines Bildes:
Diese Version ist die neben der Autoquickbar am jäufigsten genutzte Version, da die hier nichtgenutzten Parameter im Regelfall auf Wikidata verfügbar sind.
{{Quickbar Ort
|typ=flughafen
|auto=ja
|terminals=
}}

Hilfsmittel für Arbeit mit Wikidata

Die Quickbar unterstützt aktiv das Projekt Wikidata. Viele Daten können von Wikidata bezogen werden. Es werden auch lokal angegebene Daten mit den Eintragungen in der Datenbank abgeglichen. Autoren können sich durch die Wikidata-Tools unterstützen lassen. Sie stellen in der Quickbar zusätzliche Informationen und Hilfsmittel zur Erfassung und Manipulation der Daten bereit.

Individuelle Gestaltung

Jedes einzelne Informationsfeld der Quickbar lässt sich über CSS individuell gestalten, entweder zentral über die Systemdatei Mediawiki:common.css oder über benutzerspezifische Einstellungen Benutzer:<Dein Name>/common.css. Für Programmierer ist es damit auch möglich, an jedem Feld per Javascript Änderungen vorzunehmen und Werkzeuge zu programmieren.

Die gesamte Quickbar (<table>...</table>) besitzt drei Klassen.

  • qb – Immer vorhanden ist die Klasse qb. Über diese kann man jede Infobox beeinflussen.
  • qb-ort - Alle Orts-Quickbars, die direkt oder indirekt über diese Vorlage eingebunden sind, besitzen diese Klasse
  • qb-<top-level-domain> – Zusätzlich gibt es eine landesspezifische Klasse, die die Top-Level-Domain beinhaltet. Alle Artikel über Deutschland haben in ihrer Quickbar somit zusätzlich die Klasse qb-de hinterlegt. Lässt sich keine TLD ermitteln, heißt die Klasse qb-unknown-tld.

Jede Zeile der Quickbar (<tr>...</tr>) hat eine individuelle Klasse, über die die Formatierungen angewendet werden können. Zusätzlich haben alle Spalten jeder Zeile eine individuelle Klasse:

  • qbItem-key – Erste Spalte mit der Eigenschaftsbezeichnung (standardmäßig fett geschrieben)
  • qbItem-value1 – Erste (und in der jetzigen Quickbar Ort im Regelfall einzige) Spalte mit einem Wert.
  • qbItem-value2 – weitere Spalte
  • qbItem-value3 – weitere Spalte

Folgende Klassen werden in den einzelnen Zeilen vergeben. Möchtest du dir die Quickbar als Ganzes umgestalten, kannst du dies über die CSS-ID #qb umsetzen.

Quickbar-Zeile Klasse für CSS Hinweis
Bild qb-image
Provinz qb-province
Einwohnerzahl qb-population
Höhe qb-altitude
Touristinfo qb-tourist-info
Lagekarte qb-image, qb-pos-image
  • Die Klasse qb-image haben alle Bilder und Grafiken in der Quickbar.
  • Die Klasse qb-pos-image hat nur die Lagekarte.

Beispiel

Möchtest du die Einwohnerzahl blau und kursiv schreiben, musst du in deiner CSS-Datei folgende Zeile ergänzen:
.qb-population .qbItem-value1 { color:blue; font-style:italic; }

Siehe auch

Hilfe

Vorlagen

Die Grundelemente der Quickbars
Speziell vorbereitete Quickbars
  • {{Quickbar Land}} – Stndardisierte Länderquickbar mit Unterstützung von Wikidata
  • {{Quickbar}} – Alte Länderquickbar ohne Unterstützung Wikidata. Sie kann bei Gelegenheit durch die neuere ersetzt werden.
  • {{Quickbar Region}} – Regionenquickbar
  • {{Einfache Quickbar}} – Einfache Quickbar mit einem Bild und einer Lagekarte
Fertige Quickbar-Vorlagen für verschiedene Anwendungen

TemplateData

Infobox (Quickbar) für Städte. Werden Parameter leer gelassen, werden die Daten automatisch von Wikidata bezogen

Vorlagenparameter

Diese Vorlage bevorzugt Blockformatierung von Parametern.

ParameterBeschreibungTypStatus
Automatischer Modusauto

Erlaubt den automatischer Betrieb und erspart die Benutzung der anderen Parameter (die Daten kommen dann von Wikidata)

Standard
ja
Zeichenfolgevorgeschlagen
BildBild

repräsentatives Bild in kompletter Wiki-Syntax in der Form: [[File:xyz.jpg|292px|Bildvon xyz]]

Standard
Dateierforderlich
Name(n) des OrtesNamen

Name(n) des Ortes, gegebenenfalls in unterschiedlichen Sprachen

Standard
Zeichenfolgeoptional
EinwohnerEinwohner

Einwohnerzahl

Standard
Zeichenfolgevorgeschlagen
HöheHöhe

Höhe über derm Meeresspiegel in Metern (die Einheit bitte mit angeben)

Standard
Zeichenfolgevorgeschlagen
Provinz des OrtesProvinz

Name der obersten Verwaltungsregion, in der der Ort liegt

Standard
Zeichenfolgevorgeschlagen
ProvinzbezeichnungProvinzLabel

Bezeichnung der Verwaltungseinheit (Provinz/Bundesland/Präfektur....)

Standard
Zeichenfolgevorgeschlagen
Webseite der TouristinformationTouriInfoWeb

Webseite der Touristinformation in der Form ([http://www.xz.com www.xyz.com])

Standard
Zeichenfolgevorgeschlagen
TouriInfoTelTouriInfoTel

Telefonnummer der Touristinformation (Landesvorwahl wird bei Bedarf automatisch ermittelt)

Standard
Zeichenfolgevorgeschlagen