Vorlage:Quickbar Ort

Aus Wikivoyage
Dokumentation für die Vorlage {{Quickbar Ort}}[Ansicht] [Bearbeiten] [Versionsgeschichte] [Aktualisieren]

Funktion

Die Vorlage dient zur Ausgabe von Kurzdaten für Städte, Großstädte oder Kleinstädte. Die Anzeige erfolgt als umflossene Box am rechten Rand, die Box ist 300px breit. Alle angezeigten Infos beziehen ihre Werte von Wikidata, können aber mit lokal angegebnen Werten überschrieben, oder auch deaktiviert werden.

Verwendung

Ist alles auf Wikidata verfügbar reicht folgendes: {{Quickbar Ort}}

Ansonsten folgt die typische Vorlagensyntax: {{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=

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 Werte werden immer von Wikidata bezogen. Trotzdem gibt es für jede Information einen Parameter, der auch in der Vorlage benutzt werden kann. Dabei gibt es zwei Möglichkeiten:

  • Ein Parameter wird benutzt und enthält einen Wert wie nein/no/n/false: Die Quickbar unterdrückt diese Information. Somit kann man zum Beispiel Einwohnerzahlen bei Seen unterdrücken, da sie keinen Sinn machen.
  • Ein Parameter wird benutzt und enthält einen Wert. Die Quickbar stellt diesen Wert anstelle von Wikidata dar. Der Wikidata-Wert ist aber intern verfügbar und im HTML enthalten.

Wird ein Parameter lokal benutzt, wird ein Vergleich mit der entsprechenden Eigenschaft auf Wikidata durchgeführt und das Ergebnis dokumentiert. Das Ergebnis des Vergleichs wird folgendermaßen dokumentiert:

Angezeigte Informationen / Parameter

Folgende Informationen bzw. Parameter sind in der Quickbar verfügbar. Die gelistete Reihenfolge entspricht auch der Anzeige in der Infobox.

  • |id= Dieser Parameter ist ein Spezialfall. Normalerweise möchtest du die Informationen zum aktuellen Artikel anzeigen. Dabei kann der Parameter weggelassen werden. 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= Das ist das Bild, das ganz oben in der Quickbar dargestellt wird. Es wird dabei auf die Eigenschaft Bild zurückgegriffen, nicht auf möglicherweise vorhandene Collagenbilder. Sind auf Wikidata mehrere Bilder angegeben, wird das erste angezeigt, das von der Datenbank geliefert wird.
    • Wird das Bild von Wikidata bezogen wird es aktuell mit einer Breite von 300px ohne Rahmen und Unterschrift angezeigt. Global eingestellt ist dies im Modul Modul:GetImage/Properties unter QuickbarSettings > widthP18. Das gilt auch für Bilder im Hochkant-Format.
    • Möchtest du ein eigenes Bild einbinden, ist es in kompletter Wiki-Syntax mit eckigen Klammern anzugeben. Dabei kannst du auch eigene Größenangaben und/oder die üblichen Optionen wie thumb oder border verwenden. Wegen der damit verbundenen übermäßig großen Darstellung sollte auf Bilder im Hochkant-Format verzichtet werden, oder aber deren Breite auf 200px begrenzt werden.
    • Die Quickbar ist auf mindestens 300px Breite voreingestellt, mit Bild ergibt sich dann eine Mindestbreite von Bildbreite plus zusätzlicher 10 Pixel für Zwischenraum und Rahmen.
  • |Namen= Der Name wird aus den Seiteninformationen geholt und angezeigt. Möchtest du beispielsweise den Ortsnamen in verschiedenen Sprachen angeben, kannst du auch diese Info selbst angeben. Schreibe nach Möglichkeit nicht zu viel Text, eine mehrzeilige Überschrift in der Quickbar kann schnell etwas zu wuchtig wirken.
  • |Provinz= Diese Option liefert die Provinz, der ein Ort 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. Die Ermittlung der Provinz erfolgt automatisch über eine rekursive Suche auf Wikidata. Schlägt diese fehl, wird nichts angezeigt und der Artikel landet in einer dieser Fehlerkategorien. Anstatt die PRovinz hier einzutragen, wäre es schön, du pflegst die passenden Daten auf Wikidata ein.
  • |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.
  • |Einwohner= Dieser Wert gibt die Einwohnerzahl des Ortes an.
  • |Höhe= Höhe (Altitude) des Ortes.
  • Touristeninformation: Für die automatische Anzeige aus Wikidata muss für die Touristeninformation auf Wikidata 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)
  • |Karte= Der Parameter spezifiziert die für die Positionsangabe verwendete Karte. Standardmäßig wird von der Quickbar eine Landeskarte verwendet. Für einige Länder existieren aber auch Provinzkarten, die dann benutzt werden. Im Modul Quickbar Ort/Locmaps gibt es Einstellungen für einige Spezialfälle. Die individuelle Verwendung dieses Parameters ist daher nur noch eine seltene Ausnahme. Lediglich zum Deaktivieren der Karte mit einem der Werte nein/no/n/false kommt er noch zum Einsatz. Folgende Spezialfälle müssen in dem angegebenen Modul konfiguriert werden. Das Modul enthält auch noch eine detailliertere Beschreibung.
    • Provinzkarten: Normalerweise wird in der Quickbar ein Ort durch einen roten Punkt auf der Länderkarte gekennzeichnet. Soll stattdessen eine detailliertere Provinzkarte benutzt werden (wie in Deutschland), ist das dort anzugeben. Es sollte dann auch für jede Provinz eine Karte vorhanden sein. Weitere Details dazu auf der Modulseite.
    • Provinzübergreifende Lagekarten: Mit dem etwas sperrigen Begriff sind Regionenkarten gemeint, die Teile eines Landes umfassen, aber für mehrere Provinzen genutzt werden. Das ist auf Wikivoyage beispielsweise in Norditalien der Fall. Dann ist für jede Provinz das Kürzel der Regionenkarte anzugeben.
    • Abgelegene Provinzen: haben eine eigene Lagekarte, während für alle restlichen Orte die Landeskarte genutzt wird. Solche Anwendungen sind die Kanaren in Spanien und die Überseegebiete einiger europäischer Staaten.
    • Tipp: Sollte die Quickbar eine Fehlermeldung ausgeben, dass die Koordinaten ungültig sind, ist der dritte Fall die Ursache, wenn die Koordinaten stimmen.

Veraltete Parameter

Die folgenden Parameter findest du möglicherweise noch in bestehenden Artikeln. Sie werden mittlerweile ignoriert und es ist wünschenswert, wenn sie bei passender Gelegenheit entfernt werden: |auto=, |Kartentyp=, |Länge= und |Breite=. Ebenso kannst du eine möglicherweise verwendete Vorlage {{Autoquickbar Ort}} in {{Quickbar Ort}} umbenennen.

Beispiel

Quickbar für Orte

Qāitbāy-Zitadelle
Alexandria · الإسكندرية
GouvernementAlexandria
Einwohnerzahl4.870.000 (2016)
Höhe−1 m
Tourist-Infowww.alexandriaegypt.com
Lagekarte des Nildeltas in Ägypten
Lagekarte des Nildeltas in Ägypten
Alexandria

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

Kopiervorlage:
{{Quickbar Ort}}

Kopiervorlage für die automatische Variante mit optionaler Angabe eines Bildes:
Diese Version ist die am häufigsten genutzte Version, da die Touristinfo nur sehr selten auf Wikidata erfasst ist und Wikidata-Bilder gelegentlich nicht genutzt werden wollen.
{{Quickbar Ort
| Bild         =
| TouriInfoWeb =
| TouriInfoTel =
}}

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.

  • voy-qb – Immer vorhanden ist die Klasse voy-qb. Über diese kann man jede Infobox beeinflussen.
  • voy-qb-or - Alle Orts-Quickbars, die direkt oder indirekt über diese Vorlage eingebunden sind, besitzen diese Klasse
  • voy-qb-or-<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 voy-qb-de hinterlegt.

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:

  • voy-qb-item-key – Erste Spalte mit der Eigenschaftsbezeichnung (standardmäßig fett geschrieben)
  • voy-qb-item-value1 – Erste (und in der jetzigen Quickbar Ort im Regelfall einzige) Spalte mit einem Wert.
  • voy-qb-item-value2 – weitere Spalte
  • voy-qb-item-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 voy-qb-item-image
Provinz voy-qb-item-province
Einwohnerzahl voy-qb-item-population
Höhe voy-qb-item-altitude
Touristinfo voy-qb-item-tourist-information
Lagekarte voy-qb-locmap

Beispiel

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

CSS-Stilvorlagen

Siehe auch

Hilfeseiten
  • Quickbars – Hilfe zum Einstieg in die Quickbars
Projektseiten

Vorlagen

Die Grundelemente der Quickbars
Speziell vorbereitete Quickbars
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[Vorlagendaten bearbeiten]

Diese Vorlage bevorzugt Blockformatierung von Parametern.

ParameterBeschreibungTypStatus
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 dem 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
Hinweise