Extension:ImageMap/de

Die "ImageMap"-Erweiterung ermöglicht anklickbare verweissensitive Grafiken (englisch image maps). Eine verweissensitive Grafik besitzt eine Liste von Koordinaten, die verschiedene Bereiche des Bildes mit verschiedenen Zielen verlinkt (im Gegensatz zu einer normalen Bildverknüpfung, bei der der gesamte Bereich des Bildes auf einzigen Ziel verknüpft ist). Beispielsweise kann auf einer Weltkarte jedes Land mit weiteren Informationen über dieses Land verlinkt sein. Die Absicht einer Bildkarte ist es, eine einfache Möglichkeit zu bieten, verschiedene Teile eines Bildes zu verlinken, ohne das Bild in separate Bilddateien zu unterteilen.

Einfaches Beispiel ohne Bildunterschrift
Das obige Beispiel verlinkt immer auf die Main Page, unabhängig davon, wo du es anklickst. Um mehr über das Bild herauszufinden, klicke auf das "i"-Symbol. Alternativ kann man so ein verlinktes Bild auch ohne die Erweiterung wie folgt erzeugen:

Komplexes Beispiel mit Bildunterschrift
Dieses Beispiel wird ein Vorschaubild mit der Größe (Breite × Höhe) 500 × 250 Pixel erzeugen; hat eine Größe von 9.600 × 4.800 Pixeln. Die Koordinaten jeder Ecke sind in Pixeln angegeben und stellen einen Punkt im Originalbild dar. Die Eckpunkte des Polygons um "Judas" (im Bild der zweite von rechts) haben zum Beispiel horizontale Koordinaten (gemessen in Pixeln von der linken Seite) zwischen  –   und vertikale Koordinaten (gemessen in Pixeln von oben) zwischen   – , womit sie weit außerhalb des Bereichs des Vorschaubildes in der Größe 500 × 250, aber innerhalb des Bereichs des Originalbildes von 9.600 × 4.800 liegen. Beachte, dass eine Ecke des Polygons um "Simon" (ganz rechts im Bild), und zwar die Ecke mit den Koordinaten, außerhalb der Grenzen des Originalbildes 9,600 × 4,800 liegt.

Das obige Beispiel verlinkt auf viele unterschiedliche Seiten, abhängig davon, wohin man klickt. Um mehr über das Bild herauszufinden, klicke auf das Symbol mit dem doppelten Rechteck.

Syntax-Beschreibung
Die Inhalte einer -Markierung bestehen aus leeren Zeilen, Kommentaren (die mit # beginnen) und logischen Zeilen.

Die erste logische Zeile gibt an, welches Bild angezeigt werden soll. Es muss im gleichen Format angegeben werden, wie in einem normalen MediaWiki-Bildlink (siehe Bilderhilfe), jedoch ohne die umschließenden Markierungen  und.

De erste Zeile spezifiziert ein " "- oder " "-Bild, dann werden die Beschreibung der ersten Zeile und alle alt-Parameter wie gewöhnlich als Beschreibung des Bildes und alternativer Text behandelt. Andernfalls gibt der Parameter alt (oder wenn dieser fehlt irgendeine Beschreibung) den alternativen Text des Bildes vor.

In keinem Fall hat das Bild selbst einen Titel-Text (häufig für Tooltips verwendet); der Titel-Text wird aus den Regionen entnommen, die in den folgenden Zeilen beschrieben werden.

Weitere Zeilen werden in Zeichen aufgeteilt und durch Leerzeichen voneinander getrennt. Die Funktion jeder Zeile wird durch das erste Zeichen der Zeile bestimmt.

Eine Koordinate besteht aus zwei Zeichen. Das erste Zeichen ist die horizontale (X) Position und das zweite Zeichen ist die vertikale (Y) Position. Alle Koordinaten beziehen sich auf das Bild in voller Größe, nicht auf das sichtbare Bild. Die X- und Y-Zeichen sollten als Entfernung von der linken Seite (Anzahl horizontaler Pixel) und von oben (Anzahl vertikaler Pixel) für das Bild in voller Größe angegeben werden.


 * desc
 * Bestimmt den Ort des blauen "i"-Zeichens Desc-i.svg, welcher auf die Bildbeschreibung verlinkt. Mögliche Werte:,   (Standard),  ,  ,  . Dieser Parameter wird bei " "- oder " "-Bildern ignoriert, da bei diesen stattdessen das übliche Symbol des doppelten Rechtecks Magnify-clip.png genutzt wird.


 * poly
 * Ein Polygon. Die Koordinaten der Ecken sind gegeben, gefolgt von einem Link in eckigen Klammern.


 * rect
 * Ein Rechteck. Die Parameter sind die Koordinaten der oberen linken und unteren rechten Ecken, gefolgt von einem Linkziel in eckigen Klammern.
 * Beispiel


 * circle
 * Ein Kreis. Die ersten beiden Parameter sind die Koordinaten des Mittelpunktes, der dritte ist der Radius. Auf die Koordinaten folgt ein Link in eckigen Klammern.


 * default
 * Es wird der Standardlink ausgegeben, wo keine anderen Regionen spezifiziert sind.

Alle Koordinaten werden im Verhältnis zum originalen Bild angegeben. Das Bild kann mithilfe der Syntax für Vorschaubilder skaliert werden, wobei die Koordinaten für die verweissensitive Grafik automatisch entsprechend skaliert werden.

Alle Links haben entweder das Format Seitentitel oder Beschreibung. Im letzteren Fall wird der Teil nach dem Trennstrich "|" das Titel-Attribut des Links — bei den meisten Browsern wird es als Tooltip erscheinen, wenn der Benutzer über dieses fährt; der Teil nach dem Trennstrich wird auch der alternative Text für den Link. Wenn keine explizite Linkbeschreibung angegeben ist, wird der Seitentitel genutzt.

In Bereichen, in denen es Überschneidungen gibt, wird der als erstes aufgeführte Link bevorzugt.

Installation
Stelle sicher, dass das Hochladen aktiviert und ImageMagick installiert ist:


 * Fehlerbehebung
 * 1) Überprüfe, ob dein php-DOM aktiviert ist. Wenn es das nicht ist, musst du es möglicherweise installieren.
 * 2) Überprüfe, ob  installiert ist, da sich die Erweiterung zur Größenveränderung auf /usr/bin/convert verlässt. Wenn sie nicht vorhanden ist, erhältst du möglicherweise eine Seite nur mit XML-Fehlern (Tipp: Nutze die Zurück-Schaltfläche im Browser, da du weiterhin die Seite bearbeiten kannst).
 * 3) Bei gemeinsamem OHV-Hosting von   sollte dies wie folgt aussehen:

Composer
Du kannst diese Erweiterung auch mit integrierter -Unterstütung installieren.

composer require mediawiki/image-map @dev

Nutzung mit Vorlagen, magischen Wörtern oder Parser-Funktionen
Wenn du möchtest, dass diese Erweiterung (wie die meisten Tag-Erweiterungen) Vorlagenparameter, magische Wörter oder Parserfunktionen parst, musst du die -Syntax nutzen, wie w:Template:Click es tut. In diesem Fall muss das vertikale Zeichen  durch eine Vorlage   ersetzt werden, wobei der Quelltext der Vorlage   ist (außer wenn sie innerhalb von Links oder Parametern erscheint).


 * Beispiel - Standardvariante:


 * Beispiel - mit Variable :


 * Beispiel – Modifiziert, um einen Eingabe-Parameter zur Kontrolle der Bildgröße zu akzeptieren:

Diese Veränderungen erlaubt es, die Vorlagengröße auf der bearbeiteten (Ziel-)Seite anzupassen und die Erstellung doppelter Vorlagen für unterschiedliche Bildgrößen entfällt.

Wobei  der Eingabeparameter “1” ist und die Standard-Bildgröße bei 640px liegt.

Hinweis: Der Eingabeparameter erfordert eine Zeichenkette, die mit “px” endet, damit er korrekt funktioniert.

Durch Abruf einer Vorlage  wird die Vorlage mit 400 Pixeln angezeigt.

Um die (existierenden) standardmäßigen verweissensitiven Grafiken in dieses optionale Format umzuwandeln:
 * Ersetze das führende durch
 * Füge  nach dem Namen des Bildes ein (ändere die Standard-Bildgröße, damit sie mit der bisherigen Größe übereinstimmt).
 * Hinweis: Aufgrund der Änderung der Standardgröße (in diesem Beispiel 640px) auf die aktuelle Bildgröße müssen keine existierenden Vorlagenaufrufe verändert werden und sie werden weiterhin korrekt angezeigt. Existierende Vorlagenaufrufe können noch später durch Nutzung des Eingabeparameters verändert werden.


 * Ersetze das schließende durch   (die schließenden Klammern).

Siehe auch

 * Anleitungen
 * A simple guide on how to use the Image Map editor with the ImageMap extension can be found at ImageMapEdit Howto on Meta-Wiki.
 * A detailed guide for using the maschek image map editor can be found at this site.
 * Wikimedia Commons also has a resource page on image maps: c:Commons:Image map resources
 * Existing image maps examples: de:Kategorie:Vorlage:Verweissensitive Grafik


 * Wiki tools
 * meta:User:Dapete/ImageMapEdit - ImageMapEdit script, a graphical tool to determine the coordinates that can be installed on any wiki.


 * Online-Werkzeuge
 * http://www.maschek.hu/imagemap/imgmap Online-Editor für verweissensitive Grafiken, unterstützt alle Formen, kompatibel mit der Erweiterung ImageMap.
 * http://www.image-maps.com/index.php? Basic on-line image mapper.
 * http://summerstyle.github.io/summer/ - Open-source interactive online image mapper


 * Similar functionalities
 * - working with diagrams and drawings