German translation mod_example mit Umlauten

[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_example.xml.meta">

<name>mod_example</name>
<description>Veranschaulicht das API-Modul</description>
<status>Experimentell</status>
<sourcefile>mod_example.c</sourcefile>
<identifier>example_module</identifier>

<summary>
<note type="warning">
      Dieses Dokument wurde nicht aktualisiert,
      um den &Auml;nderungen der Version 2.0 des Apache-Servers
      Rechnung zu tragen. Einige der Informationen k&ouml;nnen noch
      relevant sein, es ist jedoch Vorsicht geboten.
</note>

    <p>Die Dateien im Verzeichnis <code>src/modules/example directory</code>
    des Apache-Distributionsverzeichnisses k&ouml;nnen als Beispiel f&uuml;r
    Module dienen, die die Apache-API benutzen.</p>

    <p>Die Hauptdatei <code>mod_example.c</code> zeigt
    die unterschiedlichen Callback-Mechanismen und die
    Aufrufsyntax. Ein Erweiterungsmodul ben&ouml;tigt auf keinen Fall
    Routinen f&uuml;r alle Callbacks!</p>

    <p>Das Beispielmodul ist ein tats&auml;chlich funktionierendes Modul.
    Wird es in den Server eingebunden, muss der
    "Example-Handler"  f&uuml;r einen Bereich aktiviert werden. Wenn Sie in 
diesen
    Bereich wechseln, finden Sie dort eine Anzeige des Tracing, das
    das Modul bei den unterschiedlichen Callbacks angelegt hat.</p>
</summary>

<section id="compiling"><title>Das Beispielmodul kompilieren</title>

    <p>Um das Beispielmodul in den Server einzubinden, f&uuml;hren
    Sie folgende Schritte durch:</p>

    <ol>
      <li>
        Entfernen Sie das Kommentarzeichen aus der Zeile
        "AddModule modules/example/mod_example", die Sie am Ende der
        Datei <code>src/Configuration</code> finden.
        F&uuml;r den Fall, dass sie nicht vorhanden ist, folgt hier ein 
Beispiel: 
<example>
     AddModule modules/example/mod_example.o
</example>
      </li>

      <li>F&uuml;hren Sie das Skript <code>src/Configure</code> aus
      ("<code>cd&nbsp;src;&nbsp;./Configure</code>"). Damit wird
      ein Makefile f&uuml;r den Server selbst erzeugt und die Datei
      <code>src/modules/Makefile</code> f&uuml;r zus&auml;tzliche Module 
aktualisiert,
      die von unterhalb dieses Unterverzeichnisses angefordert wurden.</li>

      <li>Erzeugen Sie den Server (f&uuml;hren Sie "<code>make</code>" im
      <code>src</code>-Verzeichnis aus).</li>
    </ol>

    <p>So f&uuml;gen Sie weitere Module hinzu:</p>

    <ol type="A">
      <li><code>mkdir src/modules/<em>mymodule</em></code></li>

      <li><code>cp src/modules/example/*
      src/modules/<em>mymodule</em></code></li>

      <li>&Auml;ndern Sie die Dateien im neuen Verzeichnis.</li>

      <li>Folgen Sie den oben aufgef&uuml;hrten Schritten [1] bis [3]
      und nehmen Sie die entsprechenden &Auml;nderungen vor.</li>
    </ol>
</section>

<section id="using"><title>Das <code>mod_example</code>-Modul benutzen</title>

    <p>Um das Beispielmodul zu aktivieren, f&uuml;gen Sie einen dem folgenden
    gleichenden Block in Ihre
   <code>srm.conf</code>-Datei ein:</p>
<example>
   &lt;Location /example-info&gt;<br />
       SetHandler example-handler<br />
   &lt;/Location&gt;
</example>

    <p>Aternativ k&ouml;nnen Sie folgendes in eine
    <a href="core.html#accessfilename"><code>.htaccess</code></a>-Datei
    einf&uuml;gen und anschlie&szlig;end die Datei <code>test.example</code> von
    diesem Standort anfordern:</p>
<example>
   AddHandler example-handler .example
</example>

    <p>Nachdem der Server erneut geladen/gestartet wurde,
    sollten Sie sich zu diesem Standort bewegen und
    die bereits erw&auml;hnte kurze Anzeige sehen k&ouml;nnen.</p>
</section>

<directivesynopsis>
<name>example</name>
<description>Demonstrationsdirektive zur Veranschaulichung der
der Modul-API</description>
<syntax>example</syntax>
<contextlist><context>server config</context>
<context>virtual host</context><context>directory</context>
<context>.htaccess</context></contextlist>

<usage>
    <p>Die <directive>example</directive>-Direktive setzt lediglich ein
    Demonstrations-Flag, welches der Content-Handler des Moduls anzeigt.
    Sie &uuml;bernimmt keine Argumente. Wenn Sie sich zu einer URL bewegen,
    f&uuml;r die der Content-Handler zust&auml;ndig ist, dann werden die
    Routinen aus dem Modul angezeigt. Au&szlig;erdem wird angegeben, wie und in
    welcher Reihenfolge sie aufgerufen wurden, um die Dokumentanfrage
    zu bedienen. Die Auswirkung dieser Direktive k&ouml;nnen Sie unter dem
    Punkt "<code>example directive declared here: YES/NO</code>"
    beobachten.</p>
</usage>
</directivesynopsis>

</modulesynopsis>


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