Zum Inhalt springen

Vorlage:Quickbar Land/Doku

Aus Wikivoyage

Funktion

[Bearbeiten]
Malaysia
Lagekarte
Flagge
Kurzdaten
HauptstadtKuala Lumpur
Regierungsformkonstitutionelle Monarchie,
föderale Monarchie,
Wahlmonarchie,
parlamentarische Monarchie
Währung
Kurs (21.10.2024)[1]
Ringgit
1 EUR = 4,674 MYR
10 MYR = 2,139 EUR
Fläche330.803 km²
Einwohnerzahl32.447.385 (2020)
AmtsspracheMalaiisch
ReligionMuslime 53 %, Buddhisten 17 %, Taoisten, Hindus, Christen, Sikhs
Strom/Stecker230–240 V, 50 Hz;
G
Telefonvorwahl+60
Domain.my
ZeitzoneMEZ+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

[Bearbeiten]

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

[Bearbeiten]

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

[Bearbeiten]

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

[Bearbeiten]

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[2]:
  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.[3]

Beispiel und Kopiervorlage

[Bearbeiten]

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

[Bearbeiten]

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

[Bearbeiten]

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

[Bearbeiten]

Siehe auch

[Bearbeiten]
Hilfeseiten
[Bearbeiten]
  • Quickbars – Hilfe zum Einstieg in die Quickbars
Projektseiten
[Bearbeiten]

Vorlagen

[Bearbeiten]
Die Grundelemente der Quickbars
[Bearbeiten]
Speziell vorbereitete Quickbars
[Bearbeiten]
Fertige Quickbar-Vorlagen für verschiedene Anwendungen
[Bearbeiten]

Einzelnachweise