Vorlage:Quickbar Region

Aus Wikivoyage
Zur Navigation springen Zur Suche springen
Template-info.png Dokumentation für die Vorlage {{Quickbar Region}}[Ansicht] [Bearbeiten] [Versionsgeschichte] [Aktualisieren]

Funktion

Die Vorlage erzeugt eine Quickbar für Regionen, Bundesstaaten, Nationalparks usw. usw. 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 benutzen -> Information wird in die Quickbar als neue Zeile eingefügt.
  • Parameter benutzen und leer lassen -> Information wird aus Wikidata geholt (Normalfall bei Flaggen, Siegeln, Lagekarten, evtl. Hauptstadt).
  • Parameter benutzen und befüllen -> Übergebene Information wird ausgegeben.

Ableitung von Länderversionen

Kota Kinabalu City Mosque 0019.jpg
Flagge
Kota Kinabalu City Mosque 0019.jpg
Sabah
HauptstadtKota Kinabalu
Einwohner
3.117.405 ()
Fläche
76.115 km²
Postleitzahl88000–91999
Vorwahl087-089
Webseitewww.sabah.gov.my
Lage
SarawakLabuanSabahJohorMalakkaNegeri SembilanPutrajayaKuala LumpurSelangorPahangTerengganuKelantanPerakPerlisKedahThailandSingapurBruneiIndonesienIndonesienIndonesienIndonesienIndonesienIndonesienIndonesienPhilippinenPhilippinenSabah in Malaysia.svg

Möchtest du eine Infobox für die Provinzen (Bundesländer, Präfekturen...) eines Landes verwenden empfehlen wir dir, eine abgeleitete landesspezifische Vorlage zu erstellen. Ein Beispiel wäre die Quickbar für die Präfekturen Japans. Dies hat folgende Vorteile.

  • In allen Provinzen des Landes sind die Infoboxen gleich aufgebaut.
    • Es werden immer die selben Informationstypen angezeigt.
    • Im Kopf wird einheitlich ein Bild, oder die Provinzflagge oder das Wappen dargestellt, je nachdem worauf sich die Autoren geeinigt haben.
  • In allen Provinzartikeln kann einheitlich eine Lagekarte dargestellt werden. Bei Bedarf kann auch gleich eine passende anklickbare Karte erzeugt werden. Da auf Wikimedia Commons die Karten in der Regel einheitlich benannt sind, kann die landesspezifische Quickbar diese Dateinamen automatisch generieren.

Am Ende dieser Dokumentation findest du ein Übersicht über alle derzeit verfügbaren Länderspezifischen Infoboxen. Eine aktuelle Liste findest du auch in der Kategorie Vorlagen:Quickbars Provinzen.

Ist eine länderspezifische Quickbar richtig parametriert und sind alle gewünschten Daten auf Wikidata erfasst, funktioniert sie im Regelfall komplett ohne Parameter. Als Beispiel siehst du im Artikel über den malaysischen Bundesstaat Sabah die rechts abgebildete Quickbar. Im Artikel selbst steht lediglich {{Quickbar Provinz Malaysia}}. Auch das Bild wird aus der Datenbank übernommen. Ob du dich einer möglichen Bildfluktuation auf Wikidata aussetzen willst, ist dir überlassen. Du kannst jederzeit in der Vorlage ein Bild hinterlegen, welches dann immer benutzt wird.

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 Region 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 Region.

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 Region

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 der Einleitung. Dies ist wichtig für eine ansprechende Darstellung in der mobilen Version, speziell auf dem Smartphone.

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 Region gelistet.

  • |id= Diese Parameter ist ein Spezialfall. Normalerweise möchtest du die Informationen zum aktuelle Artikel anzeigen. Ist dies nicht der Fall, kannst 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 welches 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, welches von der Datenbank geliefert wird. Als Alternative zum Bild können auch folgende Hoheitszeichen eingebunden werden. Theoretisch sogar beides. Alle Elemente sollten leer gelassen und von Wikidata bezogen werden.
    • |Flagge= Flagge der Region
    • |Wappen= Wappen der Region
    • |Siegel= Siegel der Region
  • |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 zuviel Text, eine mehrzeilige Überschrift in der Quickbar kann schnell etwas zu wuchtig wirken.
  • |Einwohner= Dieser Wert gibt die Einwohnerzahl der Region an.
  • |Fläche= Dieser Wert weist die Fläche der Region aus.
  • |Postleitzahl= Dies sind die offiziellen Postleitzahlen der Region.
  • |Vorwahl= Amtlicher Telefonvorwahlbereich.
  • |Webseite= Im Gegensatz zur {{Quickbar Ort}} steht hier die offizielle Webseite der Region. Eine offizielle Tourismusseite kann ebenfalls existieren, wird hier aber nicht erwähnt.
  • |Lagekarte= Zeigt eine Lagekarte der Region an. Darüber wird eine Zwischenüberschrift platziert. Die Zwischenüberschrift wird nicht dargestellt, wenn seit der vorigen Überschrift keine Ausgabe von Informationen erfolgte. Ist nichts angegeben wird die Lagekarte von Wikidata geholt (Property:P242). Möchte man eine Lagekarte manuell angeben, ist der ganz normale Dateiname ohne Wiki-Syntax zu verwenden. Wird eine Lagekarte benutzt, kann man weitere Parameter benutzen.
    • |BreiteLagekarte= Gibt die Breite der Lagekarte in der Quickbar an. Standardmäßig wird die volle Breite benutzt.
    • |Imagemap= Macht die Karte anklickbar. Die angegebene Imagemap muss im Modulnamensraum als Unterseite des Moduls Imagemap abgelegt sein. Weitere Informationen findest du in der dortigen Modulbeschreibung.
      • Beispiele.
      • |Lagekarte= Holt die Karte automatisch.
      • |Lagekarte=Datei:Flagge von... bindet die Lagekarte manuell ein. Hinweis: Hier ist nur der Dateiname ohne Wikisyntax anzugeben.
      • |Imagemap=th hinterlegt der Karte die Imagemap von Thailand.
  • 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)

Die Vorlage bietet die Möglichkeit, die Ausgabe von Hoheitszeichen zu unterbinden. Das kann dann benutzt werden, wenn eine landesspezifische Vorlage die Ausgabe von Hoheitszeichen standardmäßig aktiviert hat, in einer Provinz aber die entsprechende Datei nicht vorliegt. Dadurch kann eine Fehlerausgabe verursachen, die aber nach Prüfung des Sachverhaltes nicht mehr gewünscht ist. Daher kann man mit folgenden Parametern die Ausgabe von Flagge, Siegel oder Wappen im Einzelfall unterdrücken:

  • |noFlag=yes – keine Flagge
  • |noSeal=yes – kein Siegel
  • |noCoa=yes – kein Wappen

Parameter für Entwickler

Folgender Parameter spricht eher Vorlagenprogrammierer an.

  • |dumpParameter= Die Parameter der Infobox. werden an die entsprechende Module weitergereicht und kommen unter Umständen aus aus der spezifischen Länderquickbar. Das sind schon mal drei oder vier Stationen. Sollte sich mal eine Quickbar nicht so verhalten, wie sie soll, kann man sich zur Kontrolle alle Parameter anzeigen lassen, die beim Quickbarmodul letztendlich ankommen. Mit diesem zusätzlichen Parameter in der Quickbar werden an die normale Quickbar eine Zwischenüberschrift und eine Liste aller Parameter inklusive ihrer Werte angehängt.

Vergleich mit Wikidata

Auch wenn Werte für die Parameter angegeben werden schaut die Quickbar auf Wikidata nach. Wer die Wikidata Tools aktiviert hat, bekommt einen Hinweis, sollte die Angabe auf Wikidata abweichen oder gar fehlen. Alle anderen Leser bekommen von diesem Prozess nichts mit.

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 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-region - Alle Regionen-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
Bild qb-image
Flagge qb-image, qb-flag
Siegel qb-image, qb-seal
Wappen qb-image, qb-coat-of-arms
Einwohnerzahl qb-population
Fläche qb-area
Postleitzahl qb-postal-code
Vorwahl qb-area-code
Webseite qb-website
Touristinfo qb-tourist-info
Lagekarte qb-image, qb-posmap
Lagekarte mit Imagemap qb-image, qb-posmap, qb-imagemap

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; }
  • Den Webseitenlink komplett deaktivieren könntest du mit: .qb-website { display:none; }

Vorhandene Quickbars für Provinzen

Verfügbare Länderkarten

Individuelle Gestaltung der Quickbars

Es besteht die Möglichkeit, sichie Quickbar und einzelne Informationen individuell anzupassen. Näheres dazu findest du in der Dokumentation der {{Quickbar Region}}

Vorlagen zur Erstellung von Quickbars

Bausteine für Quickbars
Komplette Quickbars

Vorhandene Quickbars für Provinzen

Siehe auch

TemplateData

Formatierung von Quickbars (Infoboxen) für Regionen, Provinzen, Bundesländer usw.

Vorlagenparameter

ParameterBeschreibungTypStatus
FlaggeFlagge

Zeigt die Flagge der Region an.

Zeichenfolgeoptional
WappenWappen

Zeigt das Wappen der Region an.

Zeichenfolgeoptional
SiegelSiegel

Zeigt das Siegel der Region an.

Zeichenfolgeoptional
BildBild

Bindet ein Bild in die Quickbar ein. Angabe in Wikisyntax

Zeichenfolgeoptional
NamenNamen

Dieser Text wird in der Quickbarüberschrift anbgezeigt.

Zeichenfolgeoptional
HauptstadtHauptstadt

Gibt die Hauptstadt der Region an.

Zeichenfolgevorgeschlagen
FlächeFläche

Gibt die Fläche der Region an.

Zeichenfolgevorgeschlagen
EinwohnerEinwohner

Gibt die Einwohner der Region an.

Zeichenfolgevorgeschlagen
PostleitzahlPostleitzahl

Gibt die Postleitzahl der Region an.

Zeichenfolgeoptional
VorwahlVorwahl

Gibt die Vorwahl der Region an.

Zeichenfolgeoptional
WebseiteWebseite

Gibt die offizielle Webseite der Region an.

Zeichenfolgevorgeschlagen
LagekarteLagekarte

Gibt die Lagekarte der Region an. Nur Dateiname angeben.

Zeichenfolgevorgeschlagen
BreiteLagekarteBreiteLagekarte

Gibt die Breite der Lagekarte an. Standard: volle Breite

Standard
200px
Zeichenfolgevorgeschlagen
ImagemapImagemap

Gibt eine passende Imagemap zur Lagekarte an und macht sie anklickbar.

Zeichenfolgevorgeschlagen
Die vorstehenden Angaben wurden aus TemplateData-Informationen generiert.
Hinweise