> <description>Vom Server vor der Auslieferung untersuchte Dokumente
> (Server Side Includes)</description>
"untersuchte" is a little weak.
mod_include does not only "inspect" the document but it replaces certain
variables, insert file content and even handles conditional code.
I would like to name mod_include "interpreting" these documents, as the
module can do a lot more than just execute "include" statements now.
Apache's XSSI is really a little programming language of its own...
> Auslieferung an den Client bearbeitet.
What about "verarbeitet"? I may be to picky here... but mod_include does
not have an effect on the file itself but only on the file's content being
sent
to some client...
> Diese Elemente können zusätzlichen Text, weitere Dateien
> und Programme
More precise: "Die Einbindung weiterer Dateien und Programme".
[NOTE]
The English version should rather be "the inclusion of other files or of
the
_output_ from invoked programs" - it is not the program itself that is
"included"...
> aktiviert der <code>server-parsed</code>
> -<a href="../handler.html">Handler</a> auch die
> <code>INCLUDES</code>-Filter.
No plural here - "INCLUDES" is just one filter (and not feminine either ;-)
A parsed file may contain more than one 'include' directive, this is where
the plural of the module name seems to beb derived from.
> <p>Weitere Informationen finden Sie im <a
> href="../howto/ssi.html">SSI-Tutorial</a>.</p>
No translation of "our"?
> <tr><td><code><a href="#element.echo">echo</a></code></td>
> <td>Ausgabevariablen</td></tr>
Nope, but "Ausgabe von Variablen(inhalten)" - all variables are equal.
(Actually, "print the content of a variable" might have been better in
English.)
> <tr><td><code><a href="#element.fsize">fsize</a></code></td>
> <td>Ausgabegröße einer Datei</td></tr>
Like above: "Ausgabe der Gr��e einer Datei".
> <tr><td><code><a href="#element.include">include</a></code></td>
> <td>Dateien einbinden</td></tr>
"Einbinden von Dateien" would look better in this "neighborhood".
> und steht nur zur Verfügung, wenn dieses Modul geladen wird.</p>
"wird" => "ist" (der Zeitraum des Ladens selbst ist ja nur ganz kurz...)
> Untersuchung eines Dokuments.
Like above: "Auswertung" would be better.
> <directive module="mod_include">SSIUndefinedEcho</directive>-
> Anweisungen werden dadurch überschrieben.</dd>
Like in some other module translation: "override" != "overwrite". Thus:
"Diese Einstellung hat Vorrang vor...". (Occurs several times in this
file.)
> <code>abbrev</code> für die Anzeige in kByte oder MByte.
Please append something like "nach Gutd�nken des Moduls" for the
"as appropriate" clause (meaning you can't be too sure about how the
result will look like, or at least the manual won't tell you in detail... ;
-)
> <dd>Eine Zeichenfolge für die <code>strftime(3)</code>-
> Bibliotheksroutine für die Datumsausgabe.</dd>
I would prefer "Eine Zeichenfolge, die von der Bibliotheksroutine
<code>strftime</code> f�r die Ausgabe von Datumsangaben verwendet wird."
> <dd>Angegeben wird der Name der auszugebenden Variablen.</dd>
Von wem? Vom Admin, nicht vom Modul. Also besser "Anzugeben ist...".
> (die %-Kodierung, die für URLs in Links usw. gedacht ist).
Literally: "Auch bekannt als %-Kodierung, die...".
Mit diesem Namen wird sie im Apache-Handbuch n�mlich an anderen
Stellen bezeichnet (beispielsweise ein paar Abs�tze weiter unten)
> <p>Dem <code>encoding</code>-Attribut muss das entsprechende
> <code>var</code>-Attribut <em>vorangehen</em>.
Just the other way round: You first set the encoding, then you output
the var on which you want to apply the encoding that must already be
in effect (SSI parsing is sequential in context).
> <note type="warning">
> Um Probleme zwischen unterschiedlichen Sites zu vermeiden
> sollten Benutzerdaten <em>immer</em> kodiert werden.
> </note>
First, a comma after "vermeiden" should be a good idea.
Then, "Benutzerdaten" ("user data") is not the same as "user supplied
data" ("von einem Benutzer �bermittelte Daten").
This user might not be aware of encoding issues, so you rather handle
the encoding yourself than expect the user to do it right...
[NOTE]
Actually, I am not quite sure about what these "user supplied data"
would be in reality, except for the URL of the requested page... some
hint about that could be helpful here.
> nicht als solches erkennen würde. Das Verzeichnis, in welchem sich
> das Skript befindet, muss jedoch für CGI-Skripte aktviert sein
Typo: "aktviert" => "aktiviert".
(or better: "freigeschaltet" - the directory isn't "more active" just
because the configuration allows to store CGI scripts there.)
> <p>Dem CGI-Skript wird <code>PATH_INFO</code>
Um, the English version tried to use the "INFO" part as a part of the
sentence as well, which doesn't work in German this way.
You might have to add some equivalent to "INFO" (like "information").
> und die Abfragezeichenfolge (<code>QUERY_STRING</code>) der
> ursprünglichen Client-Anfrage übergeben.
"query string" is a technical term that I would be _very_ hesitant to
translate.
(It is typically used by search engines to specify a string that would then
be subject to a query - but CGI scripts are totally free in making use of
this
"dynamic URL part", which is still known as "query string".)
> Neben der standardmäßigen
I would prefer "zus�tzlich zur". (Because this may come unexpected;
a CGI-Skript to make use of this has to know that it was invoked this way.)
> kann dies nicht mit <code>exec cgi</code> geschehen, sondern muss
> wie folgt mit <code>include virtual</code> geschehen:</p>
The English version didn't say it _must_ be done using "virtual", only
it _can_ be done. (Maybe some day there will be a third method, which
would then cause the "must" to be wrong.)
> <p>Fast immer wird <code><a href="#includevirtual"
> >#include virtual</a></code> den Anweisungen
> <code>#exec cgi</code> oder <code>#exec cmd</code> gegenüber
> vorgezogen.
Leider nicht (das w�rde ja bedeuten, da� alle das Handbuch gelesen
haben...;-), sondern: "In fast allen F�llen ist... vorzuziehen".
(Weil es mehr kann und "exec cgi" eigentlich veraltet ist.)
> <code>#include virtual</code> verwendet den
Literally: "Ersteres (include virtual)..."
> Die Anweisung ist erprobter und auf aktuellerem Stand.</p>
You don't want to translate the "much" to "viel" (or "deutlich")?
> <p>Außerdem können bei Betriebssystemen wie Win32
> und Unix bei Verwendung von <a href="../suexec.html">suexec</a>
> keine Argumente an einen Befehl in einer <code>exec</code>-Anweisung
> übergeben oder Leerstellen in den Befehl eingefügt werden.
Auf deutsch wird man das klammern m�ssen, weil "suexec" das Problem
auch bei UNIX ausl�st, das bei Win32 schon alleine existiert (dort auch
ohne suexec - wie im n�chsten Absatz richtig beschrieben). Also:
"Außerdem können bei Betriebssystemen wie Win32
(und Unix bei Verwendung von <a href="../suexec.html">suexec</a>) ..."
> <section id="element.fsize"><title>Das fsize-Element</title>
> <p>Dieser Befehl gibt die Größe der angegebenen Datei
> aus, die Gegenstand der <code>sizefmt</code>-Formatangabe ist.
sizefmt doesnt specify files, it specifies formats. This should be
"Dieser Befehl gibt die Gr��e der angegebenen Datei aus, unter
Verwendung der durch <code>sizefmt</code> festgelegten Formatangabe."
> Ausgegeben wird <em>nicht</em> der Umfang einer CGI-Ausgabe,
> sondern die Größe des CGI-Skripts selbst.</dd>
Literally: "Beachten Sie, da�...". And this is necessary because this
usage of "virtual" may differ from the user's expectation because it
is the same word that has been used to invoke CGI scripts earlier.
> <p>Dieser Befehl gibt das Datum der letzten Änderung der
> angegebenen Datei aus, das Gegenstand der <code>timefmt</code>-
> Formatanweisung ist.
Same problem as above - use "unter Verwendung ..." like before.
> Wurde für das Verzeichnis der bearbeiteten Datei
> <a href="core.html#options">Options</a> <code>IncludesNOEXEC</code>
> gesetzt, werden nur Dokumente mit den MIME-Typen <code>text/plain</code>,
> <code>text/html</code> usw. eingebunden.
While the English version was exact the translation only tells examples
but omits the "rule" which would be "MIME-Typen der Klasse 'text/' ".
> <p>Ein Attribut gibt die Position des Dokuments an.
"Ein" => "Das".
> Die Einbindung erfolgt für jedes der <code>include</code>-Anweisung
> übergebene Attribut.
Typo: "Attribut" => "Attribute".
> Er kann weder die Schreibweise <code>../</code>
"kann" => "darf" (nat�rlich "kann" er, ist dann aber ung�ltig... ;-),
"Schreibweise" => "Zeichenkette".
> Das Attribut <code>virtual</code> sollte diesem
> Attribut gegenüber immer vorgezogen werden.</dd>
"vorgezogen" => "bevorzugt"?
[NOTE]
The English version was:
" The virtual attribute should always be used in preference to this
one."
Does that mean that "file" isn't even _faster_ than "virtual",
although "virtual" has to go through the URL translation mechanism?
> Eine CGI-URL kann eine Abfragezeichenfolge enthalten:</p>
"kann" => "darf".
> Attribute werden nicht übergeben.</p>
Von wem an wen?
"Diese Anweisung �bernimmt (interpetiert? hat?) keine Attribut(wert)e."
> <dd>Die Bezeichnung der zu setzenden Variablen.</dd>
What would be the problem with translating "name" to "Name"?
> <dd>Der zuzuweisende Wert.</dd>
Literally: "Der dieser Variable zuzuweisende Wert."
> stehen die Include-Variablen für den <code>echo</code>-Befehl,
"die" => "diese" (oder "die folgenden").
> <dt><code>QUERY_STRING_UNESCAPED</code></dt>
> <dd>Ist eine Abfragezeichenfolge vorhanden, enthält diese
> Variable die %-kodierte Abfragezeichenfolge,
Quite the opposite: "%-_de_kodierte".
(Das ist ja der Sinn der Sache - der _codierte_ Query-String ist bereits
eine
Standard-Variable der CGI-Umgebung, den mu� SSI nicht extra anbieten.)
> in der Sonderzeichen wie <code>&</code> usw. ein Backslash
> vorangestellt wird.</dd>
The most important part (what is this escaping good for?) has gotten
lost in the translation: "which is escaped for shell usage" => "die f�r
eine
Verwendung innerhalb einer (UNIX-)Shell geeignet 'escaped' wurde".
(In einer UNIX-Shell haben genau diese Zeichen n�mlich wieder eine
besondere Bedeutung und w�rden so nicht zum Inhalt des Query-Strings
z�hlen, sondern interpretiert werden... Apache ist nun mal ein Programm,
das in der UNIX-Welt 'geboren' wurde, das merkt man an vielen Stellen.)
> <p>Variablensubstitution bei Zeichenfolgen in Anführungszeichen
> erfolgt meist dann, wenn sie
What does the "sie" refer to? ("diese" Zeichenfolgen? Die Substitution?
Die Anf�hrungszeichen?)
> als Argument für eine SSI-Anweisung dienen können.
Nein, sondern viel komplizierter: "wenn diese _sinnvollerweise_ als
Argument
einer SSI-Direktive auftreten k�nnen." Das wird also nicht systematisch
in allen Direktiven so gemacht, sondern nur genau in der Liste, die als
n�chstes folgt... (was immer "sinnvollerweise" dabei bedeuten mag)
> sowie die Argumente für Bedingungsoperatoren.
Interessantes Wort... hm, mir f�llt auch nichts Sch�nes ein.
("Operatoren bedingter Anweisungen" ist ziemlich lang.)
> Durch Voranstellung eines Backslash kann ein Dollarzeichens in
Typo: "Dollarzeichens" => "Dollarzeichen".
> <p>Muss ein Variablenverweis in der Mitte einer Zeichenfolge
> ersetzt werden, die selbst als gültiger Bezeichner gelten
> kann, wird die Zweideutigkeit durch geschweifte Klammern aufgehoben:</p>
"Zweideutigkeit" => "Mehrdeutigkeit". (Also wirklich... ;-)
The part "a la shell substitution" is missing in the translation:
"Genau wie das bei der Ersetzung innerhalb einer (UNIX-)Shell der Fall
w�re".
(Wieder ein Beispiel daf�r, wo Apache die Vorbilder f�r seine Syntax her
hat
und wieso sich ein UNIX-Kenner bei Apache sofort "zuhause f�hlt".)
> "<code>X_Y</code>" gesetzt, wenn <code>REMOTE_HOST</code>
> "<code>X</code>" und <code>REQUEST_METHOD</code>
> "<code>Y</code>" ist.</p>
More fluently: "ist" => "den Wert ... enth�lt". ("is" => "contains the
value...")
> <p>Im folgenden Beispiel wird "in foo" ausgegeben, wenn
> <code>DOCUMENT_URI</code> gleich <code>/foo/file.html</code> ist
> und "in bar", wenn es gleich <code>/bar/file.html</code> ist, andernfalls
> wird "in neither" ausgegeben:</p>
I guess it would be 'legal' to translate the output message "in neither" to
"in keinem von beiden" to make the example more understandable for the
German reader.
... to be continued (this one is too big for just one mail...)
Regards, Michael
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
