German translation mod_imap

[Jobst Giesecke]

<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.de.xsl"?>
<modulesynopsis metafile="mod_imap.xml.meta">

<name>mod_imap</name>
<description>Server-seitige Image-Map-Verarbeitung</description>
<status>Base</status>
<sourcefile>mod_imap.c</sourcefile>
<identifier>imap_module</identifier>

<summary>
    <p>Dieses Modul verarbeitet <code>.map</code>-Dateien und ersetzt
    dabei die Funktionalit&auml;t des CGI-Programms <code>imagemap</code>.
    Jedes Verzeichnis oder jeder Dokumenttyp, der f&uuml;r den
    <code>imap-file</code>-Handler konfiguriert wurde (entweder mit
    <directive module="mod_mime">AddHandler</directive> oder mit
    <directive module="core">SetHandler</directive>)
    wird von diesem Modul verarbeitet.</p>

    <p>Die folgende Anweisung aktiviert die Verarbeitung als Image-Maps
    (anw&auml;hlbare Bilder) f&uuml;r Dateien mit der Namensendung
    <code>.map</code>:</p>

    <example>AddHandler imap-file map</example>

    <p>Die folgende Anweisung wird auch weiterhin unterst&uuml;tzt:</p>

    <example>AddType application/x-httpd-imap map</example>

    <p>Da "magicMIME-Typen" auslaufen, ist diese Variante veraltet.</p>
</summary>

<section id="features"><title>Neue Eigenschaften</title>

    <p>Das Image-Map-Modul bietet einige M&ouml;glichkeiten, die von
    bisherigen Image-Map-Programmen nicht angeboten wurden:</p>

    <ul>
      <li>URL-Verweise relativ zu Referer: information</li>

      <li>Standardm&auml;&szlig;ige <code>&lt;base&gt;</code>-Zuweisung mit 
einer neuen
      Map-Direktive.</li>

      <li>Eine <code>imagemap.conf</code>-Datei ist nicht mehr erforderlich</li>

      <li>Punktverweise</li>

      <li>Konfigurierbare Erzeugung von Image-Map-Men&uuml;s</li>
    </ul>
</section>

<section id="imapfile"><title>Image-Map-Datei</title>

    <p>Die Zeilen der Image-Map-Dateien k&ouml;nnen unterschiedliche
    Formate haben:</p>

    <example>
      Anweisung Wert [<var>x</var>,<var>y</var> ...]<br />
      Anweisung Wert "<var>Men&uuml;text</var>" [<var>x</var>,<var>y</var>
      ...]<br />
      Anweisung Wert <var>x</var>,<var>y</var> ... "<var>Men&uuml;text</var>"
    </example>

    <p>Folgende Anweisungen sind m&ouml;glich: <code>base</code>,
    <code>default</code>, <code>poly</code>, <code>circle</code>,
    <code>rect</code> oder <code>point</code>. Der Wert ist eine
    absolute oder relative URL oder einer der unten aufgef&uuml;hrten speziellen
    Werte. Die Koordinaten sind <code><var>x</var>/<var>y</var></code>-
    Paare, die durch Leerzeichen getrennt werden. Der Text innerhalb der
    Anf&uuml;hrungszeichen ist der Text f&uuml;r den Link, wenn ein 
Image-Map-Men&uuml;
    erzeugt wird. Zeilen mit einem Doppelkreuz (#) am Anfang sind
    Kommentarzeilen.</p>

    <section id="imapfile.Direktiven"><title>Anweisungen der 
Image-Map-Datei</title>
      <p>Sechs Anweisungen sind in Image-Map-Dateien zul&auml;ssig. Sie
      k&ouml;nnen in beliebiger Reihenfolge stehen, werden aber in der
      Reihenfolge verarbeitet, in der sie in der Image-Map-Datei
      aufgef&uuml;hrt wurden.</p>

      <dl>
      <dt><code>base</code>-Anweisung</dt>

      <dd><p>Hat den Effekt von <code>&lt;base href="<var>Wert</var>"&gt;
      </code>. Nicht absolute URLs der Map-Datei werden relativ zu diesem
      Wert interpretiert. Die <code>base</code>-Anweisung &uuml;berschreibt
      <directive module="mod_imap">ImapBase</directive> aus der
      <code>.htaccess</code>-Datei oder den Server-Konfigurationsdateien.
      Fehlt eine <directive>ImapBase</directive>-Konfigurationsanweisung,
      entspricht <code>base</code> der Voreinstellung
      <code>http://server_name/</code>.</p>
      <p><code>base_uri</code> ist identisch mit <code>base</code>.
      Beachten Sie, dass ein nachgestellter Schr&auml;gstrich
      signifikant ist.</p></dd>

      <dt><code>default</code>-Anweisung</dt>

      <dd>Die durchzuf&uuml;hrende Ma&szlig;nahme, falls die angegebenen
      Koordinaten f&uuml;r keine der <code>poly</code>-, <code>circle</code>-
       oder <code>rect</code>-Anweisungen brauchbar sind und keine
      <code>point</code>-Anweisungen vorliegen. Fehlt eine
      <directive module="mod_imap"
      >ImapDefault</directive>-Einstellung, gilt die Vorgabe
      <code>nocontent</code>, die den Statuscode
      <code>204 No Content</code>
      zur&uuml;ckgibt. Der Client sollte die gleiche Seite anzeigen.</dd>

      <dt><code>poly</code>-Anweisung</dt>

      <dd>&Uuml;bernimmt drei bis einhundert Punkte und wird wirksam, wenn die
      vom Benutzer gew&auml;hlten Koordinaten innerhalb des von diesen Punkten
      definierten Polygons liegen.</dd>

      <dt><code>circle</code>-Anweisung</dt>

      <dd>&Uuml;bernimmt die Koordinaten eines Kreismittelpunkts und
      einen Punkt auf dem Kreis. Wird wirksam, wenn der vom Benutzer
      gew&auml;hlte Punkt innerhalb des Kreises liegt.</dd>

      <dt><code>rect</code>-Anweisung</dt>

      <dd>&Uuml;bernimmt die Koordinaten zweier gegen&uuml;berliegender Ecken
      eines Rechtecks. Wird wirksam, wenn der gew&auml;hlte Punkt innerhalb
      dieses Rechtecks liegt.</dd>

      <dt><code>point</code>-Anweisung</dt>

      <dd>&Uuml;bernimmt einen einzelnen Punkt. Wirksam wird die
      <code>point</code>-Anweisung, wenn der vom Benutzer gew&auml;hlte
      Punkt nicht im Bereich einer anderen Anweisung liegt.
      Liegt eine <code>point</code>-Anweisung mit g&uuml;ltigen Koordinaten
      vor, wird die <code>default</code>-Vorgabe nicht ber&uuml;cksichtigt.</dd>
      </dl>
    </section>

    <section id="imapfile.values"><title>Werte</title>

      <p>Die folgenden Werte sind in den Anweisungen zul&auml;ssig:</p>

      <dl>
      <dt>URL</dt>

      <dd><p>Die URL kann relativ oder absolut angegeben werden.
      Bei relativen URLs ist die Angabe  '..' m&ouml;glich, die relativ zum
      <code>base</code>-Wert interpretiert wird.</p>
      <p>Der <code>base</code>-Wert selbst wird jedoch nicht
      ausgehend vom aktuellen Wert interpretiert. Die Anweisung
      <code>base mailto:</code> funktioniert aber trotzdem.</p></dd>

      <dt><code>map</code></dt>

      <dd>Entspricht der URL der Image-Map-Datei selbst.
      Koordinaten werden nicht mitgeliefert, so dass ein Men&uuml; erzeugt
      wird, wenn f&uuml;r <directive module="mod_imap">ImapMenu</directive>
      nicht <code>none</code> angegeben wird.</dd>

      <dt><code>menu</code></dt>
      <dd>Identisch mit <code>map</code>.</dd>

      <dt><code>referer</code></dt>

      <dd>Entspricht der URL des Dokuments, auf das Bezug
      genommen wird. Die Vorgabe ist <code>http://servername/</code>,
      falls kein <code>Referer:</code>-Header vorhanden war.</dd>

      <dt><code>nocontent</code></dt>

      <dd>Sendet den Statuscode <code>204 No Content</code> und
      fordert den Client auf, die gleiche Seite weiter anzuzeigen. Darf
      ausser f&uuml;r <code>base</code> immer angegeben werden.</dd>

      <dt><code>error</code></dt>

      <dd>Schl&auml;gt mit <code>500 Server Error</code> fehl. Darf
      ausser f&uuml;r <code>base</code> immer angegeben werden,
      ist aber nur in Verbindung mit <code>default</code> sinnvoll.</dd>
      </dl>
    </section>

    <section id="imapfile.coords"><title>Koordinaten</title>

      <dl>
      <dt><code>0,0 200,200</code></dt>

      <dd>Eine Koordinate besteht aus  durch Komma getrennte
      <var>x</var>/<var>y</var>-Werte. Die Koordinaten werden
      durch Leerzeichen voneinander getrennt. Um dem Umgang des
      Lynx-Browsers mit Image-Maps gerecht zu werden, wird bei Wahl der
      Koordinate <code>0,0</code> so reagiert, als w&auml;re keine 
      Koordinate augew&auml;hlt worden.</dd>
      </dl>

    </section>

    <section id="imapfile.quotedtext"><title>Text in 
Anf&uuml;hrungszeichen</title>

      <dl>
      <dt><code>"<var>Men&uuml;text</var>"</code></dt>

      <dd><p>Nach dem Wert oder den Koordinaten kann die Zeile
      optional Text in doppelten Anf&uuml;hrungszeichen enthalten. Dieser Text
      dient als Link, wenn ein Men&uuml; erzeugt wird:</p>

      <example>
        &lt;a href="http://foo.com/"&gt;<var>Men&uuml;text</var>&lt;/a&gt;
      </example>

      <p>Wird kein Text in Anf&uuml;hrungszeichen angegeben, wird der Name
      des Link als Text verwendet:</p>

      <example>
        &lt;a href="http://foo.com/"&gt;http://foo.com&lt;/a&gt;
      </example>

      <p>Doppelte Anf&uuml;hrungszeichen im Text m&uuml;ssen mit
      <code>&amp;quot;</code> gekennzeichnet werden.</p></dd>
      </dl>

    </section>
</section>

<section id="example"><title>Mapfile-Beispiel</title>

    <example>
      #Kommentare werden in einem 'formatierten' oder 'halbformatierten'<br />
      #Men&uuml; angezeigt und k&ouml;nnen HTML-Tags enthalten. &lt;hr&gt;<br />
      base referer<br />
      poly map "Ein Men&uuml; bitte!" 0,0 0,10 10,10 10,0<br />
      rect .. 0,0 77,27 "das Verzeichnis des Bezugnehmenden"<br />
      circle http://www.inetnebr.com/lincoln/feedback/ 195,0 305,27<br />
      rect another_file "im gleichen Verzeichnis" 306,0 419,27<br />
      point http://www.zyzzyva.com/ 100,100<br />
      point http://www.tripod.com/ 200,200<br />
      rect mailto:[EMAIL PROTECTED] 100,150 200,0 "Bugs?"<br />
    </example>

</section>

<section id="referencing"><title>Verweise</title>

    <example><title>HTML-Beispiel</title>
      &lt;a href="/maps/imagemap1.map"&gt;<br />
      <indent>
        &lt;img ismap src="/images/imagemap1.gif"&gt;<br />
      </indent>
      &lt;/a&gt;
    </example>

    <example><title>XHTML-Beispiel</title>
      &lt;a href="/maps/imagemap1.map"&gt;<br />
      <indent>
        &lt;img ismap="ismap" src="/images/imagemap1.gif" /&gt;<br />
      </indent>
      &lt;/a&gt;
    </example>

</section>

<directivesynopsis>
<name>ImapMenu</name>
<description>Durchzuf&uuml;hrende Aktion beim Aufruf einer Image-Map-Datei
ohne Angabe von Koordinaten</description>
<syntax>ImapMenu none|formatted|semiformatted|unformatted</syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<override>Indexes</override>

<usage>
    <p>Die <directive>ImapMenu</directive>-Direktive legt fest, was
    zu geschehen hat, wenn eine Image-Map-Datei ohne g&uuml;ltige
    Koordinaten aufgerufen wird.</p>

    <dl>
      <dt><code>none</code></dt>
      <dd>Bei Angabe von <code>none</code> wird kein Men&uuml; erzeugt
      und die <code>default</code>-Aktion durchgef&uuml;hrt.</dd>

      <dt><code>formatted</code></dt>
      <dd>Ein formatiertes Men&uuml; ist die einfachste Men&uuml;form.
      Kommentare in der Image-Map-Datei werden ignoriert. Eine &Uuml;berschrift
      der ersten Ebene wird angezeigt, anschlie&szlig;end eine Hrule, danach auf
      jeweils einer eigenen Zeile die Links. Das Men&uuml; hat ein konsistentes,
      einfaches Erscheinungsbild, &auml;hnlich einer Verzeichnisliste.</dd>

      <dt><code>semiformatted</code></dt>
      <dd>Im halbformatierten Men&uuml; werden die Kommentare an ihrer
      Position in der Image-Map-Datei angezeigt. Leerzeilen werden
      in HTML-Umbr&uuml;che umgewandelt. Es werden keine &Uuml;berschriften
      oder Hrules angezeigt, im &uuml;brigen
      gleicht das Men&uuml; einem formatierten Men&uuml;.</dd>

      <dt><code>unformatted</code></dt>
      <dd>Kommentare werden angezeigt und Leerzeilen ignoriert. Es wird
      nichts angezeigt, was nicht in der Image-Map-Datei enthalten ist. Alle
      Umbr&uuml;che und &Uuml;berschriften m&uuml;ssen in der Image-Map-Datei
      als Kommentare enthalten sein. Das bietet die gr&ouml;&szlig;te 
Flexibilit&auml;t
      hinsichtlich des Erscheinungsbildes des Men&uuml;s, erfordert aber, dass
      die Map-Dateien wie HTML- und nicht wie einfache Textdateien
      behandelt werden.</dd>
    </dl>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>ImapDefault</name>
<description>Vorgegebene Aktion bei einem Image-Map-Aufruf mit
Koordinaten, die nicht explizit zugewiesen sind.</description>
<syntax>ImapDefault error|nocontent|map|referer|<var>URL</var></syntax>
<default>ImapDefault nocontent</default>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<override>Indexes</override>

<usage>
    <p>Die <directive>ImapDefault</directive>-Anweisung legt die
    Voreinstellung f&uuml;r die Image-Map-Dateien fest. Der Wert wird
    von einer <code>default</code>-Direktive innerhalb der
    Image-Map-Datei &uuml;berschrieben. Fehlt eine solche, lautet
    die Vorgabe <code>nocontent</code>, was bedeutet, dass eine
    <code>204 No Content</code>-Nachricht an den Client gesendet
    wird. In diesem Fall sollte der Client weiterhin die urspr&uuml;ngliche 
Seite
    anzeigen.</p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>ImapBase</name>
<description>Vorgegebene <code>base</code>-Anweisung f&uuml;r
Image-Map-Dateien</description>
<syntax>ImapBase map|referer|<var>URL</var></syntax>
<default>ImapBase http://servername/</default>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<override>Indexes</override>

<usage>
    <p>Die <directive>ImapBase</directive>-Direktive legt die Voreinstellung
    f&uuml;r die <code>base</code>-Anweisung in den Image-Map-Dateien fest.
    Der Wert wird von einer <code>base</code>-Anweisung innerhalb der
    Image-Map-Datei &uuml;berschrieben. Ist eine solche nicht vorhanden,
    gilt die Vorgabe <code>http://<var>servername</var>/</code>.</p>
</usage>
<seealso><directive module="core">UseCanonicalName</directive></seealso>
</directivesynopsis>

</modulesynopsis>


---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]