Modul:Imagemap/Doku

Dieses Modul enthält Funktionen zur Erzeugung von Imagmaps.

Allgemein gültige Parameter

Die allgemein gültigen Parameter kann man sowohl innerhalb der Vorlage in der Parserfunktion invoke benutzen, als auch innerhalb des Artikels der Vorlage selbst übergeben. Der Paramter, der bei der Einbindung der Vorlage benutzt wird, hat dabei Vorrang. So kann man bestimmte Funktionalitäten für den generellen Gebrauch der Vorlage aktivieren (über invoke) und im Einzelfall im Artikel abschalten (bei der Verwendung der Vorlage).

• |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 Imagemap 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 Imagemap.

Submodule

• Modul:Imagemap/Params – enthält ein mehrdimensionales Array mit allen erlaubten Parametern für jede Funktion/Vorlage und ihre Standardbelegung.

Länderkarten

Länderkarten sind für Wikivoyage flächendeckend verfügbar. Die Imagemap befindet sich unter Modul:Imagemap/<Landeskennung>. Die Landeskennung entspricht dabei der Top-Level-Domain bzw. ISO 3166.

Karten für Provinzen, Bundesländer usw.

Für die untergeordneten Regionen der ersten Hierarchie der Staaten gibt es auf Wikivoyage derzeit nur in Einzelfällen Karten. Im Regelfall sind diese aber auf Wikimedia Commons verfügbar. Es bietet sich an diese nach dem Scheme Modul:Imagemap/<Provinzkennung> abzulegen, wobei die Provinzkennung dem offiziellen Standard ISO 3166-2. Ergänzt man nun die Länderkürzellisten (Modul:Landesbezeichnung/de und Modul:Landesbezeichnung/en) um die Provinzkennung, kann die Dokumentation wie bei den Ländern mit der Vorlage {{Dokumentation Modul Imagemap/Location maps}} erfolgen, die alles automatisch generiert. Ein Beispiel wäre die Imagemap von Abchasien mit dem Kürzel ge-ab.

sonstige Karten

Für alle weiteren Karten legt man einfach ein Untermodul nach dem Schema Modul:Imagemap/<Name der Karte> an. Benutze bitte möglichst Namen, die den Inhalt der bereits erkennen lassen, z.B. eine Kombination aus geografischer und thematischer Bezeichnung.

Funktionen

Intern

Die internen Funktionen werden nicht von Vorlagen benutzt und werden im Modul bzw. von anderen Modulen genutzt.

• createImagemap erzeugt über die Extension Imagemap eine Imagemap und erwartet dabei folgende Parameter:
  • |imagemapFrame= Framevariable des aufrufenden Objekts
  • |imagemapFile= Name der Bilddatei
  • |imagemapMap= Name der Imagemap
  • |imagemapSize= Größe der Imagemap
  • |imagemapDesc= Lage des Infobuttons
  • |imagemapAlign= Ausrichtung der Imagemap

Extern

• imagemap Erzeugt eine Imagemap. Parametrierung siehe {{Imagemap}}

Vorlagen

Folgende Vorlagen benutzen dieses Modul

• {{Imagemap}} – Vorlage zum Erzeugen anklickbarer Karten
• {{Quickbar Region}} – Infobox für Artikel über Regionen

Benötigte weitere Module

Dieses Modul benötigt folgende weitere Module: Check2

Verwendung in anderen Modulen

Dieses Modul ist notwendig für die Ausführung folgender Module. Bei Anpassungen sollte die Funktionstüchtigkeit der folgenden Module geprüft werden. Benutze dazu auch diese Tracking-Kategorie um Fehler zu finden, die sich dann auf Artikel auswirken:

• Quickbar Region
• Modul benötigt das Modul Imagemap – Wartungskategorie, in der nochmals alle Module gelistet sind, die von diesem Modul abhängig sind.