Apache 2 - Direktiven - ImapBase

    buchinfo

    aktuelles

    newsletter

    inhalt

    leseprobe

    rezensionen

    direktiven

    module

    errata

    forum

    buchtipps

    links

    bestellen bei:

    Galileo Press
    amazon.de

Direktiven

Konfigurationsdirektive: ImapBase

Die Direktive des Tages: ImapBase Übersicht: In Modul(en): mod_imap Kontext: Server <VirtualHost> <Directory> <Location> <Files> .htaccess Syntax: ImapBase map|menu|referer|URL Standardwert: http://hostname Automatisch gesetzt: ja Ausführliche Beschreibung: Eine Image-Map ist ein Bild, das verschiedene anklickbare Bereiche (so genannte "Hotspots") enthält. Ein Klick auf einen dieser Bereiche dient als HTML-Hyperlink. Es gibt zwei Grundtypen: Serverseitige und clientseitige Image-Maps. Bei einer serverseitigen Image-Map werden die Koordinaten des Mausklicks an den Server übermittelt, der sie daraufhin auswertet. Eine clientseitige Image-Map wird dagegen vom Browser selbst bereitgestellt. Da heute so gut wie jeder Browser diese Technologie unterstützt, sind serverseitige Image-Maps in den letzten Jahren etwas aus der Mode gekommen. Dennoch stellt Apache sie nach wie vor bereit, und zwar durch das Modul mod_imap. Damit ein Browser bei einem Klick auf ein Bild überhaupt die Koordinaten an den Server übermittelt, benötigt das entsprechende <img>-Tag das Attribut is-map (ohne speziellen Wert – in klassischem HTML also einfach ismap; in XHTML dagegen ismap="ismap"). Beispiel: <img src="mymap.gif" ismap="ismap" /> Die serverseitige Image-Map selbst ist eine Definitionsdatei in einem speziellen Format, auf die das Bild als Hyperlink verweisen sollte. Hier ein Beispiel für einen solchen Verweis: <a href="menu.map"><img src="map.gif" ismap="ismap" /></a> Die Map-Datei selbst benötigt den Handler imap-file, damit Apache sie entsprechend auswertet. Dieser Handler wird normalerweise mittels AddHandler [1] für die Dateiendung .map festgelegt: AddHandler imap-file .map Aus Kompatibilitätsgründen kann stattdessen auch noch immer der MIME-Type application/x-httpd-imap angegeben werden; in Zukunft wird dies aber wahrscheinlich aufgegeben: AddType application/x-httpd-imap .map Eine Image-Map-Datei ist eine einfache Textdatei, die einige spezielle Direktiven (wohlgemerkt: dies sind KEINE normalen Apache-Direktiven für die httpd.conf) enthalten kann. Apache 2 erkennt in einer Image-Map-Datei die folgenden Anweisungen: - base oder base_uri. Diese Anweisung entspricht dem HTML-Tag <base href="..." />: Sie legt die Basis für relative URLs fest. Beispiel: base http://www.mynet.de/mapfiles/ - default. Diese Direktive gibt die URL an, auf die die Image-Map verweisen soll, wenn sie außerhalb eines speziell definierten Bereiches angeklickt wurde. Beispiel: default standard.html - circle. Dies definiert einen kreisförmigen anklickbaren Bereich. Das erste Argument ist die URL; als Koordinaten werden die X- und Y-Position des Mittelpunktes sowie die X- und Y-Position eines Punktes auf der Außenlinie angegeben. Beispiel: circle kreis.html 200,200 400,200 # Mittelpunkt 200,200; Radius 200 - rect. Mit dieser Direktive wird ein rechteckiger Bereich festgelegt. Die Koordinaten sind zwei diagonale Eckpunkte. Beispiel: rect rechteck.html 100,100 400,200 - poly. Mit dieser Anweisung wird ein polygonaler Bereich mit drei bis 100 Punkten definiert. Beispiel: poly polygon.html 100,100 100,200 200,100 - point. Dies gibt einen einzelnen Punkt an. Wenn der Cursor in keinem anderweitig definierten Bereich liegt, wird der Link für die nächstgelegene point-Definition befolgt. Das bedeutet auch, dass die Einstellung unter default bei Verwendung von point deaktiviert ist. Beispiel: point punkt.html 200,200 default und die vier Koordinaten-Definitionen können zusätzlich Text in Anführungszeichen enthalten. Dieser Text wird als Link-Text für den entsprechenden Hyperlink ausgegeben, wenn Apache ein Menü erstellt. Beispiel: rect rechteck.html "Alles über Rechtecke" 100,100 400,200 Im Menü würde daraufhin der folgende Hyperlink erstellt: <a href="rechteck.html">Alles über Rechtecke</a> Wenn Sie diesen Text weglassen, wird die URL selbst als Linktext eingefügt. Statt einer URL können Sie für viele der obigen Anweisungen übrigens auch folgende Spezialwerte angeben: - map oder menu. Die URL der Map-Datei selbst. Da keine Koordinaten mitgeschickt werden, erzeugen diese speziellen Angaben ein Menü – es sei denn, ImapMenu besitzt den Wert none. Einige alte Browser können keine Koordinaten übermitteln; deshalb wird bei Anfragen ohne Koordinaten und im Normalfall auch bei Klicks auf undefinierte Korrdinaten das Menü angezeigt. - referer. URL des Dokuments, das auf die Map-Datei verwiesen hat. Falls die Anfrage keinen Referer-Header enthielt, wird http://servername/ verwendet. - nocontent. Dieser Wert kann bei allen Image-Map-Direktiven außer base angegeben werden. Er sorgt dafür, dass statt eines Dokuments 204 No Content zurückgeliefert wird. Normalerweise zeigt ein Browser in diesem Fall weiter die ursprüngliche Seite an; dies ist also eine praktischer Wert für default. - error. Dies sorgt dafür, dass Apache 2 für alle Anfragen eine Fehlermeldung mit der Statusangabe 500 Internal Server Error liefert. Sinnvoll ist dieses Verhalten als Einstellung für default – außerhalb der definierten Bereiche soll mit anderen Worten nicht geklickt werden dürfen. Die heutige Tagesdirektive ImapBase gibt die Basis-URL an, die Sie mit der Anweisung base auch in der Map-Datei selbst angeben können. Relativen URLs in der Map-Definition wird diese URL vorangestellt. Die Verwendung dieser Konfigurationsdirektive empfiehlt sich, wenn Sie in einem Kontext mehrere Image-Maps verwenden, deren Basis-URL identisch ist. Die base-Direktive in der Map-Datei über-schreibt diese Voreinstellung dann im jeweiligen Einzelfall. Sie können entweder eine beliebige URL oder aber einen der beiden weiter oben erläuterten Werte map, menu oder referer angeben. ------------- Umfrage zum Apache-Newsletter verlängert bis zum 15.09.2005 Teilnahme unter: http://buecher.lingoworld.de/umfrage.html Es gibt Galileo-Press-Bücher zu gewinnen. ============= Vorige Direktive (Archiv): CharsetDefault http://buecher.lingoworld.de/apache2/showdir.php?id=509 Links auf archivierte Direktiven sind erlaubt und ausdrücklich erwünscht; die direkte Weiterverbreitung auf fremden Sites - auch mit Quellenangabe - ist dagegen nicht gestattet. Die heutige Direktive wird ab 0:00 Uhr im Archiv zur Verfügung stehen. =============

Zur Übersicht