Revised german translation mod_expires

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

<name>mod_expires</name>
<description>Erzeugen von <code>Expires</code>-HTTP-Headern nach 
Benutzerkriterien</description>
<status>Erweiterung</status>
<sourcefile>mod_expires.c</sourcefile>
<identifier>expires_module</identifier>

<summary>
    <p>Dieses Modul kontrolliert die <code>Expires</code>-
    HTTP-Header der Serverantworten. Die G&uuml;ltigkeitsdauer kann entweder
    relativ zur Zeit der letzten Ver&auml;nderung der Ursprungsdatei
    oder relativ zur Zeit des Zugriffs durch den Client gesetzt werden.</p>

    <p>Der <code>Expires</code>-HTTP-Header informiert den
    Client &uuml;ber G&uuml;ltigkeitsdauer und Speicherbarkeit. Das
    zwischengespeicherte Dokument kann bis zum Ablauf dieser Frist
    aus dem Cache anstatt von der urspr&uuml;nglichen Position aus 
&uuml;bertragen
    werden. Nach Ablauf dieser Frist gilt die Kopie im Cache als
    "veraltet" und ung&uuml;ltig, so dass eine neue Kopie vom Ursprungsort 
geholt
    werden muss.</p>
</summary>

<section id="AltSyn"><title>Alternative Intervallsyntax</title>
<p>Die Direktiven <directive module="mod_expires">ExpiresDefault</directive>
und <directive module="mod_expires">ExpiresByType</directive>
k&ouml;nnen auch mit einer besser lesbaren Syntax angegeben werden:</p>

    <example>
      ExpiresDefault "&lt;base&gt; [plus] {&lt;num&gt;
      &lt;type&gt;}*"<br />
      ExpiresByType type/encoding "&lt;base&gt; [plus]
      {&lt;num&gt; &lt;type&gt;}*"
    </example>

    <p>F&uuml;r &lt;base&gt; kann gesetzt werden:</p>

    <ul>
      <li><code>access</code></li>

      <li><code>now</code> (entspricht 
      '<code>access</code>')</li>

      <li><code>modification</code></li>
    </ul>

    <p>Das Schl&uuml;sselwort <code>plus</code> ist optional. &lt;num&gt;
    sollte eine ganze Zahl sein [die von der C-Standardfunktion "atoi"
    akzeptiert werden w&uuml;rde].
    F&uuml;r &lt;type&gt; kann eine der folgenden Angaben erfolgen:</p>

    <ul>
      <li><code>years</code></li>
      <li><code>months</code></li>
      <li><code>weeks</code></li>
      <li><code>days</code></li>
      <li><code>hours</code></li>
      <li><code>minutes</code></li>
      <li><code>seconds</code></li>
    </ul>

    <p>Mit jeder der folgenden Direktiven kann die G&uuml;ltigkeitsdauer eines
    Dokuments standardm&auml;&szlig;ig auf einen Monat nach dem Zugriff
    gesetzt werden:</p>

    <example>
      ExpiresDefault "access plus 1 month"<br />
      ExpiresDefault "access plus 4 weeks"<br />
      ExpiresDefault "access plus 30 days"
    </example>

    <p>Eine Feinabstimmung kann mit mehreren
    '&lt;num&gt; &lt;type&gt;'-Klauseln erfolgen:</p>

    <example>
      ExpiresByType text/html "access plus 1 month 15
      days 2 hours"<br />
      ExpiresByType image/gif "modification plus 5 hours 3
      minutes"
    </example>

    <p>Bei einer Einstellung, die auf dem Datum der letzten Ver&auml;nderung
    basiert, wird der <code>Expires</code>-Header dem Dokument
    <strong>nicht</strong> hinzugef&uuml;gt, wenn es nicht aus einer Datei von
    der Festplatte stammt, da sonst kein Datum f&uuml;r die letzte 
Ver&auml;nderung
    vorliegt.</p>
</section>

<directivesynopsis>
<name>ExpiresActive</name>
<description>Aktiviert das Erzeugen von <code>Expires</code>
Headern.</description>
<syntax>ExpiresActive On|Off</syntax>
<contextlist><context>server config</context>
<context>virtual host</context><context>directory</context>
<context>.htaccess</context></contextlist>
<override>Indexes</override>

<usage>
    <p>Diese Direktive aktiviert oder deaktiviert die Erzeugung des
    <code>Expires</code>-Headers f&uuml;r ein Dokument eines Bereichs.
    (Stammt es aus einer <code>.htaccess</code>-Datei, dann gilt das
    beispielsweise nur f&uuml;r aus diesem Verzeichnis erzeugte Dokumente.) Wird
    <code>Off</code> angegeben, dann werden keine
    <code>Expires</code>-Header
    f&uuml;r Dokumente diese Bereichs erzeugt (es sei denn, sie wurden
    auf einer unteren Ebene &uuml;berschrieben, wie beispielsweise eine
    <code>.htaccess</code>-Datei, die eine Serverkonfigurationsdatei
    &uuml;berschreibt). Wird <code>On</code> angegeben, dann wird der Header
    angeforderten Dokumenten entsprechend der mit den Direktiven
    <directive module="mod_expires">ExpiresByType</directive> und 
    <directive module="mod_expires">ExpiresDefault</directive>
    angegebenen Kriterien hinzugef&uuml;gt (<em>siehe dort</em>).</p>

    <p>Die Direktive garantiert nicht, dass ein
    <code>Expires</code>-Header erzeugt wird. Sind die
    Kriterien nicht erf&uuml;llt, wird kein Header gesendet und das Ergebnis 
ist das
    Gleiche, als w&uuml;rde die Anweisung nicht gegeben.</p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>ExpiresByType</name>
<description>Konfiguration des <code>Expires</code>-Headers auf
Basis des MIME-Typs</description>
<syntax>ExpiresByType <var>MIME-Typ</var>
<var>&lt;Kode&gt; Sekunden</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<override>Indexes</override>

<usage>
    <p>Diese Direktive definiert den Wert des f&uuml;r Dokumente des
    angegebenen Typs (<em>z.B.</em> <code>text/html</code>) erzeugten
    <code>Expires</code>-Headers. Das zweite Argument gibt die
    Anzahl der Sekunden an, die einer Ausgangszeit hinzugef&uuml;gt werden,
    um die G&uuml;ltigkeitsdauer zu bilden.</p>

    <p>Die Ausgangszeit ist entweder das Datum der letzten &Auml;nderung
    oder der Zeitpunkt des Client-Zugriffs auf das Dokument. Welche
    Zeit gew&auml;hlt wird, wird mit dem Feld
    <code><var>&lt;Kode&gt;</var></code> angegeben. Die Angabe
    <code>M</code> steht f&uuml;r das Datum der letzten &Auml;nderung
    ("M" f&uuml;r englisch "modification")
    und <code>A</code> f&uuml;r den Zeitpunkt des Client-Zugriffs
    ("A" f&uuml;r englisch "access").</p>

    <p>Der Unterschied in den Auswirkungen ist subtiler Art. Wird
    <code>M</code> angegeben, dann l&auml;uft die G&uuml;ltigkeit aller
    Kopien des Dokuments in allen Zwischenspeichern gleichzeitig
    ab, was n&uuml;tzlich f&uuml;r eine w&ouml;chentliche Nachricht sein kann,
    die immer unter der gleichen URL zu finden ist. Wird <code>A</code>
    angegeben, dann ist die G&uuml;ltigkeitsdauer f&uuml;r jeden Client 
unterschiedlich.
    Das eignet sich f&uuml;r Bilder, die sich nicht sehr h&auml;ufig 
&auml;ndern,
    insbesondere f&uuml;r dazugeh&ouml;rige Dokumente, die sich alle auf die 
gleichen
    Bilder beziehen (auf die Bilder wird in einer relativ kurzen Zeitspanne
    wiederholt zugegriffen).</p>

    <example><title>Beispiel:</title>
      # Erzeugung von HTTP Headern mit G&uuml;ltigkeitszeitr&auml;umen 
aktivieren<br />
      ExpiresActive On<br />
      # GIF-Bilder verlieren die G&uuml;tigkeitsdauer nach einem Monat im 
Client-Cache<br />
      ExpiresByType image/gif A2592000<br />
      # HTML-Dokumente sind eine Woche nach dem Datum der<br />
      # letzten &Auml;nderung g&uuml;ltig<br />
      ExpiresByType text/html M604800
    </example>

    <p>Die Direktive ist nur wirksam, wenn <code>ExpiresActive On</code>
    angegeben wurde. Sie &uuml;berschreibt jede mit der Anweisung
     <directive module="mod_expires">ExpiresDefault</directive>
     angegebene G&uuml;ltigkeitsdauer, aber <em>nur</em> f&uuml;r den
     angegebenen MIME-Typ.</p>

    <p>Die Berechnung der G&uuml;ltigkeitsdauer kann auch mit der
    bereits beschriebenen <a href="#AltSyn">alternativen Syntax</a>
    angegeben werden.</p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>ExpiresDefault</name>
<description>Standardalgorithmus f&uuml;r die Berechnung der 
G&uuml;ltigkeitsdauer</description>
<syntax>ExpiresDefault <var>&lt;Kode&gt; Sekunden</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<override>Indexes</override>

<usage>
    <p>Diese Direktive definiert die Voreinstellung f&uuml;r den Algorithmus
    zur Berechnung der G&uuml;ltigkeitsdauer aller Dokumente eines Kontextes.
    Sie kann mit einer
    <directive module="mod_expires">ExpiresByType</directive>-Direktive
    &uuml;berschrieben werden. Einzelheiten zur Syntax des Arguments dieser 
Direktive
    finden Sie unter
    <directive module="mod_expires">ExpiresByType</directive>
    und in der Beschreibung der <a href="#AltSyn">alternativen Syntax</a>.</p>
</usage>
</directivesynopsis>
</modulesynopsis>



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