Vorlage:Quickbar Land/Doku

Funktion

Malaysia
Flagge
Kurzdaten
Hauptstadt	Kuala Lumpur
Regierungsform	konstitutionelle Monarchie, föderale Monarchie, Wahlmonarchie, parlamentarische Monarchie
Währung Kurs (21.10.2024)	Ringgit 1 EUR = 4,674 MYR 10 MYR = 2,139 EUR
Fläche	330.803 km²
Einwohnerzahl	32.447.385 (2020)
Amtssprache	Malaiisch
Religion	Muslime 53 %, Buddhisten 17 %, Taoisten, Hindus, Christen, Sikhs
Strom/Stecker	230–240 V, 50 Hz; G
Telefonvorwahl	+60
Domain	.my
Zeitzone	MEZ+7h

Die Vorlage stellt eine Quickbar (Infobox) für Länder zur Verfügung. Die Anzeige erfolgt als umflossene Box am rechten Rand, die Box ist 300px breit. Viele angezeigten Infos beziehen ihre Werte von Wikidata, können aber mit lokal angegebnen Werten überschrieben, oder auch deaktiviert werden.

Verwendung

Die Vorlage folgt der typischen Vorlagensyntax. Welche Parameter es gibt, und wie sie funktionieren ist weiter unten beschrieben. {{Quickbar Land |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

Einige Werte werden immer von Wikidata bezogen, einige optional. 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 unterdrücken.
• 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.

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.
• |Namen= Der Name wird aus den Seiteninformationen geholt und angezeigt. Im Ausnahmefall 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.
• |Lage= Die Lagekarte wird aus Wikidata bezogen. Dabei wird die Lagekarte entsprechend ihrer Sammlung anhand einer Prioritätenliste ermittelt. Karten werden folgendermaßen gesucht und verwendet:

1. Grau-grüne orthografische Projektionskarten
2. Karten im Globus-Format - Optisch gleichformatige Alternative zur vorgenannten Sammlung
3. grau-grüne Positionskarten
4. Rote und pinke Positionskarten
5. irgendeine Karte

Es wird empfohlen, keine Karte manuell anzugeben. Fehlt ein Karteneintrag einer Sammlung bei einem Land, sollte es auf Wikidata nachgetragen werden. Nur so wird sichergestellt, dass bei der Verfügbarkeit neuer Karten oder einem Community-Entscheid für ein anderes Design, alle Länderartikel die neue Karte benutzen. Die Einstellung der Priorität erfolgt im Basismodul GetImage/Properties. Unter der Eigenschaft P242 gibt es den Parameter collections, der die Reihenfolge angibt.

• Die Flagge wird von Wikidata geholt und besitzt keinen eigenen Parameter in der Infobox. Die Flagge ist 200px breit. Diese Einstellung kann für das ganze Wiki im Modul GetImage/Properties geändert werden. In der Variable quickbarSettings findet man unter widthP41 die Breitenangaben für Flaggen. Der Parameter single ist dabei zuständig für die Breite, wenn die Flagge allein in einer Zelle dargestellt wird.
• |Hauptstadt= Die Hauptstadt wird aus Wikidata ausgelesen. Dabei werden auch mehrere Hauptstädte und ihre Funktion ausgelesen und angezeigt (wie z. B. im Falle von Südafrika. Eine manuelle Angabe in der Infobox ist möglich, aber bisher nicht notwendig.
• |Staatsform= Bei der Angabe der Regierungsform wird Wikidata ebenfalls unterstützt. Dabei wird gleich der passende Wikipedia-Artikel verlinkt. Bei einigen Ländern kann es sich aufgrund von mehrfachen Einträgen zu einem ziemlich großen Block ausweiten. Als Autor*in kannst du entscheiden, ob du lieber ein passende lokale Angabe machen willst, die dann angezeigt wird.
• Die Währung eines Landes wird aus einem hier im Wiki abgelegten Modul entnommen: Währung/Länder. Spezialfälle wie zusätzliche Kryptowährungen als offizielles Zahlungsmittel werden von der Quickbar derzeit nicht berücksichtigt und können im Artikel im Abschnitt Einkaufen näher beschrieben werden. Zusätzlich wird der Umtauschkurs zum Euro angezeigt, wenn verfügbar. Momentan werden dafür Tabellen aus Commons genutzt, die dafür nacheinander durchsucht werden, bis ein Kurs gefunden wird. Folgende sind das derzeit (in Reihenfolge ihrer Abarbeitung bei der Suche):

1. ECB euro foreign exchange reference rates.tab
2. Xe.com exchange rates.tab

• Die |Fläche= des Landes wird aus Wikidata entnommen und in km² angezeigt, kann aber manuell angegeben werden.
• |Bevölkerung= Mit der Einwohnerzahl verhält es sich ähnlich. Hier wird das Jahr mit angezeigt, auf das sich die Einwohnerzahl bezieht.
• |Amtssprache= Sie wird aus Wikidata entnommen. Existiert ein Sprachführer zu der Sprache auf Wikivoyage, wird dieser verlinkt. Alternativ verweist der Eintrag auf den Wikipedia-Artikel. Auch hier kann es in einigen Ländern eine lange Liste geben. Eine manuelle Angabe ist möglich.
• |Religion= Damit kannst du die vorhandenen Religionen angeben. Lass den Eintrag nicht zu lang werden und beschränkte dich auf eine einfache Auflistung. Nutze im Falle von Prozentangaben geschützte Leerzeichen
• |Stromnetz= und |Stecksysteme= werden kombiniert angezeigt. Der erste Parameter enthält die Netzdaten des Landes, wie z. B. „230 V, 50 Hz“, der zweite die Steckertypen.
• Die Telefonvorwahl wird automatisiert angezeigt und aus der dem Modul CountryData/Geography entnommen.
• Die Top-Level-Domain des Landes wird automatisch von Wikidata geholt und angezeigt.
• Die |Zeitzone= ist manuell als freier Text anzugeben. Es gibt unterschiedliche Schreibweisen und Bezüge, wie UTC und MEZ. Je nach Kontinent finden man hier unterschiedliche Schreibweisen. Es gibt auch Länder mit vielen Zeitzonen. Daher wird momentan noch nicht auf einen Wikidata-Bezug zurückgegriffen.

Beispiel und Kopiervorlage

Das Beispiel aus Malaysia wird im Länderartikel mit volgendem Markup eingebunden: {{Quickbar Land
| Religion=Muslime 53 %, Buddhisten 17 %, Taoisten, Hindus, Christen, Sikhs
| Stromnetz= 230–240 V, 50 Hz
| Stecksysteme = G
| Zeitzone= MEZ+7h
}}

Die vorliegende Kopiervorlage entält die Parameter, die nicht von Wikidata bezigen werden und somit immer manuell angegeben werden müssen.

{{Quickbar Land
| Religion=
| Stromnetz=
| Stecksysteme=
| Zeitzone=
}}

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
Lagekarte	voy-qb-item-position-map
Flagge	voy-qb-item-flag	Die Überschrift über der Flage besitzt zusätzlich die Klasse voy-qb-header-flag, die darunter die Klassevoy-qb-header-info
Hauptstadt	voy-qb-item-capital
Staatsform	voy-qb-item-government
Währung	voy-qb-item-currency
Fläche	voy-qb-item-area
Einwohnerzahl	voy-qb-item-population
Amtssprache	voy-qb-item-language
Religion	voy-qb-item-religion
Stromnetz und -stecker	voy-qb-item-electricity
Ländervorwahl	voy-qb-item-calling-code
Top-Level-Domain	voy-qb-item-tld
Zeitzone	voy-qb-item-time-zone

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

• Vorlage:Quickbar/styles.css

Siehe auch

Hilfeseiten

• Quickbars – Hilfe zum Einstieg in die Quickbars

Projektseiten

• Vorlagen/Quickbars – Vorstellung der Quickbars und ihrer Anwendung
• CSS-Klassen – Dokumentation der auf Wikivoyage benutzten CSS-Klassen

Vorlagen

Die Grundelemente der Quickbars

• {{Quickbar table begin|CSS-Parameter|pos=Lage|topBorder=yes}} und {{Quickbar table end}} – Anfang und Ende der Tabelle. Tritt immer als Paar auf.
• {{Quickbar header|Titel|colspan=Anzahl}} – Überschrift
• {{Quickbar item|heading=Bezeichnung|value=Inhalt}} – Einfache Tabellenzeile mit Inhalt
• {{Quickbar image|image=Abbildung|heading=Titel|colspan=Anzahl}} – Bild für die Quickbar
• {{Quickbar line|colspan=Anzahl}} – Linie zur optischen Trennung von Inhalten
• {{Quickbar image by season}} – Saisonal ausgetauschte Abbildung
• {{Quickbar position}} – Regionenspezifische Lagekarte

Speziell vorbereitete Quickbars

• {{Quickbar Ort}} – Ortsquickbar
• {{Quickbar Region}} – Regionenquickbar
• {{Quickbar Flughafen}} – Flughafenquickbar
• {{Quickbar Fluggesellschaft}} – Quickbar für Fluggesellschaften
• {{Quickbar}} – Alte Länderquickbar ohne Unterstützung Wikidata. Sie kann bei Gelegenheit durch die neuere ersetzt werden.
• {{Einfache Quickbar}} – Einfache Quickbar mit einem Bild und einer Lagekarte

Fertige Quickbar-Vorlagen für verschiedene Anwendungen

• Vorlagen:Quickbars Provinzen – Fertige Quickbars für die Provinzen verschiedener Länder.