<!-- Copyright (c) 1999 Nik Clayton, All rights reserved.

     Redistribution and use in source (SGML DocBook) and 'compiled' forms
     (SGML HTML, PDF, PostScript, RTF and so forth) with or without
     modification, are permitted provided that the following conditions
     are met:

      1. Redistributions of source code (SGML DocBook) must retain the above
         copyright notice, this list of conditions and the following
         disclaimer as the first lines of this file unmodified.

      2. Redistributions in compiled form (transformed to other DTDs,
         converted to PDF, PostScript, RTF and other formats) must reproduce
         the above copyright notice, this list of conditions and the
         following disclaimer in the documentation and/or other materials
         provided with the distribution.

     THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
     IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
     OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
     DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
     INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
     (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
     SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
     STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
     ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
     POSSIBILITY OF SUCH DAMAGE.

     $FreeBSD$
     $FreeBSDde: de-docproj/books/fdp-primer/translations/chapter.sgml,v 1.6 2004/10/31 11:40:16 jkois Exp $
     basiert auf: 1.26
-->

<chapter id="translations">
  <chapterinfo>
    <authorgroup>
      <author>
	<firstname>Johann</firstname>
	<surname>Kois</surname>
	<contrib>&Uuml;bersetzt von </contrib>
      </author>
    </authorgroup>
  </chapterinfo>

  <title>&Uuml;bersetzungen</title>

  <para>Dieses Kapitel enth&auml;lt die FAQ f&uuml;r die &Uuml;bersetzung
    der FreeBSD Dokumentation (FAQ, Handbuch, Artikel, Manualpages und
    sonstige Dokumente) in andere Sprachen.</para>

  <para>Es beruht <emphasis>sehr</emphasis> stark auf den
    &Uuml;bersetzungs-FAQ des FreeBSD German Documentation Projects, die
    urspr&uuml;nglich von Frank Gr&uuml;nder
    <email>elwood@mc5sys.in-berlin.de</email> geschrieben und danach von
    Bernd Warken <email>bwarken@mayn.de</email> ins Englische
    &uuml;bersetzt wurden.</para>

  <para>Diese FAQ wird vom &a.doceng; gepflegt.</para>

  <qandaset>
    <qandaentry>
      <question>
	<para>Warum eine FAQ?</para>
      </question>

      <answer>
	<para>Es melden sich immer mehr Leute auf der Mailingliste
	  freebsd-doc, die Teile der FreeBSD Dokumentation in andere
	  Sprachen &uuml;bersetzen wollen.  Diese FAQ soll die
	  am h&auml;ufigsten gestellten Fragen beantworten, damit
	  m&ouml;glichst rasch mit der &Uuml;bersetzung begonnen
	  werden kann.</para>
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
	<para>Was bedeuten die Abk&uuml;rzungen <phrase>i18n</phrase>
	  und <phrase>l10n</phrase>?</para>
      </question>

      <answer>
	<para><phrase>i18n</phrase> steht f&uuml;r
	  <foreignphrase>internationalization</foreignphrase>
	  (Internationalisierung), <phrase>l10n</phrase> f&uuml;r
	  <foreignphrase>localization</foreignphrase> (Lokalisierung).
	  Es handelt sich dabei um besser handhabbare Abk&uuml;rzungen
	  dieser Begriffe.</para>

	<para><phrase>i18n</phrase> kann als <quote>i</quote>, gefolgt
	  von 18 Buchstaben, gefolgt von einem <quote>n</quote>, gelesen
	  werden.  Analog steht <phrase>l10n</phrase> f&uuml;r
	  <quote>l</quote>, gefolgt von 10 Buchstaben, gefolgt von einem
	  <quote>n</quote>.</para>
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
	<para>Gibt es eigene Mailinglisten f&uuml;r &Uuml;bersetzer?</para>
      </question>

      <answer>
	<para>Ja.  Die verschiedenen &Uuml;bersetzergruppen haben jeweils
	  eigene Mailinglisten.  Genauere Informationen finden Sie in der
	  <ulink url="http://www.freebsd.org/docproj/translations.html">
	  Liste der &Uuml;bersetzungsprojekte</ulink>.  Diese Liste
	  enth&auml;lt die Mailinglisten und Internetseiten, die von den
	  einzelnen &Uuml;bersetzungsprojekten betrieben werden.</para>
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
	<para>Werden noch &Uuml;bersetzer ben&ouml;tigt?</para>
      </question>

      <answer>
	<para>Ja.  Je mehr Leute an der &Uuml;bersetzung arbeiten, desto
	  schneller wird diese fertig, und umso schneller sind
	  &Auml;nderungen im englischen Original auch in den
	  &uuml;bersetzten Dokumenten vorhanden.</para>

	<para>Sie m&uuml;sssen kein professioneller Dolmetscher sein, um
	  dabei zu helfen.</para>
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
	<para>Welche Sprachen muss ich daf&uuml;r kennen/k&ouml;nnen?</para>
      </question>

      <answer>
	<para>Idealerweise haben Sie gute Kenntnisse in geschriebenem
	  Englisch, au&szlig;erdem sollten Sie nat&uuml;rlich fit in
	  der Sprache sein, in die Sie &uuml;bersetzen wollen.</para>

	<para>Englisch ist allerdings nicht unbedingt n&ouml;tig.  Sie
	  k&ouml;nnten beispielsweise auch die FAQ vom Spanischen ins
	  Ungarische &uuml;bersetzen.</para>
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
	<para>Welche Software wird ben&ouml;tigt?</para>
      </question>

      <answer>
	<para>Es ist sehr empfehlenswert, eine lokale Kopie des FreeBSD
	  CVS-Repository (als Minimum den Dokumentationsteil) anzulegen,
	  entweder mit <application>CTM</application> oder mit
	  <application>CVSup</application>.  Das Kapitel <quote>Das
	  Neueste und Beste</quote> des Handbuchs beschreibt die
	  Nutzung dieser Programme.</para>

	<para>Sie sollten au&szlig;erdem mit
	  <application>CVS</application> vertraut sein.  Damit ist es
	  m&ouml;glich, festzustellen, was sich zwischen einzelnen
	  Versionen eines Dokuments ge&auml;ndert hat.</para>

	<para>[XXX Aufgabe -- Ein Tutorial schreiben, das die Verwendung
	  von CVSup beschreibt, um die Dokumentation herunterzuladen,
	  auszuchecken und festzustellen, was sich zwischen zwei
	  Versionen ge&auml;ndert hat.]</para>
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
	<para>Wie finde ich heraus, ob noch jemand Teile der
	  Dokumentation in die gleiche Sprache &uuml;bersetzt?</para>
      </question>

      <answer>
	<para>Die <ulink
	  url="http://www.FreeBSD.org/docproj/translations.html">
	  &Uuml;bersetzungsseite </ulink> des Documentation Projects
	  listet alle &Uuml;bersetzungs-Teams auf, die derzeit aktiv
	  sind.  Arbeitet bereits jemand an der &Uuml;bersetzung in
	  Ihre Sprache, so kontaktieren Sie dieses Team, damit
	  Dokumente nicht unn&ouml;tigerweise mehrfach &uuml;bersetzt
	  werden.</para>

	<para>Wenn Ihre Sprache nicht aufgef&uuml;hrt ist, senden Sie
	  bitte eine E-Mail an das &a.doc;.  Vielleicht denkt ja jemand
	  &uuml;ber eine &Uuml;bersetzung nach, hat sich aber noch nicht
	  daf&uuml;r entschieden.</para>
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
	<para>Niemand &uuml;bersetzt in meine Sprache.  Was soll ich
	  machen?</para>
      </question>

      <answer>
	<para>Gratulation, Sie haben gerade das <quote>FreeBSD
	  <replaceable>Ihre-Sprache</replaceable> Documentation
	  Translation Project</quote> gestartet.  Willkommen.</para>

	<para>Entscheiden Sie zuerst, ob Sie die daf&uuml;r n&ouml;tige
	  Zeit zur Verf&uuml;gung haben.  Da Sie als Einziger an der
	  &Uuml;bersetzung in Ihre Sprache arbeiten, sind Sie daf&uuml;r
	  verantwortlich, Ihre Arbeit zu ver&ouml;ffentlichen und die
	  Arbeit von Freiwilligen, die Ihnen dabei helfen wollen, zu
	  koordinieren.</para>

	<para>Senden Sie eine E-Mail an die Mailingliste des
	  Documentation Projects, in der Sie bekanntgeben, dass Sie an
	  der &Uuml;bersetzung der Dokumentation arbeiten, damit die
	  Internetseiten aktualisiert werden k&ouml;nnen.</para>

	<para>Gibt es in Ihrem Land einen FreeBSD-Spiegelserver, so
	  sollten Sie den daf&uuml;r Zust&auml;ndigen kontaktieren und
	  nachfragen, ob er Ihnen Speicherplatz oder E-Mailadressen
	  f&uuml;r Ihr Projekt zur Verf&uuml;gung stellen w&uuml;rde.</para>

	<para>Danach w&auml;hlen Sie ein Dokument aus und beginnen
	  mit der &Uuml;bersetzung.  Am besten beginnen Sie mit kleineren
	  Dateien, beispielsweise den FAQ oder einem der Artikel.</para>
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
	<para>Ich habe ein Dokument &uuml;bersetzt.  Wo soll ich es
	  hinschicken?</para>
      </question>

      <answer>
	<para>Das kommt darauf an.  Wenn Sie bereits in einem
	  &Uuml;bersetzer-Team arbeiten (etwa dem japanischen oder dem
	  deutschen Team), dann sollten Sie deren Richtlinien zum Umgang
	  mit neuer Dokumentation folgen, die auf deren Internetseiten
	  beschrieben werden.</para>

	<para>Wenn Sie die einzige Person sind, die an der
	  &Uuml;bersetzung in eine Sprache arbeitet, oder wenn Sie
	  f&uuml;r ein &Uuml;bersetzungsprojekt verantwortlich sind,
	  und Ihre Aktualisierungen an das FreeBSD Project
	  &uuml;bermitteln wollen, sollten Sie Ihre &Uuml;bersetzungen
	  dorthin senden (lesen Sie dazu auch die n&auml;chste
	  Frage).</para>
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
	<para>Ich arbeite als einziger an der &Uuml;bersetzung in diese
	  Sprache, wie versende ich meine &Uuml;bersetzungen?</para>

	<para>oder</para>

	<para>Wir sind ein &Uuml;bersetzer-Team, und wollen Dokumente
	  versenden, die unsere Mitglieder &uuml;bersetzt haben?</para>
      </question>

      <answer>
	<para>Stellen Sie zuerst sicher, dass Ihre &Uuml;bersetzungen
	  korrekt organisiert sind.  Sie sollte sich also im
	  existierenden Dokumentationsbaum befinden, und ohne Fehler
	  bauen lassen.</para>

	<para>Zurzeit wird die FreeBSD Dokumentation unterhalb des
	  Verzeichnisses <filename>doc/</filename> gespeichert.  Die
	  direkten Unterverzeichnisse werden entsprechend der
	  Sprachkodierung benannt, in der sie geschrieben sind.  Diese
	  Kodierung nach ISO639 finden Sie auf einem FreeBSD-System
	  unter <filename>/usr/share/misc/iso639</filename>,
	  vorausgesetzt, das System wurde nach dem 20. Januar 1999
	  gebaut.</para>

	<para>Wenn in Ihrer Sprache mehrere Kodierungen (wie dies etwa
	  f&uuml;r Chinesisch der Fall ist) vorhanden sind, existiert
	  f&uuml;r jede Kodierung ein eigenes Unterverzeichnis.</para>

	<para>Zuletzt existieren auch noch Verzeichnisse f&uuml;r die
	  einzelnen Dokumente.</para>

	<para>Die Verzeichnishierarchie f&uuml;r eine hypothetische
	  schwedische &Uuml;bersetzung k&ouml;nnte etwa so
	  aussehen:</para>

	<programlisting>doc/
    sv_SE.ISO8859-1/
                     Makefile
                     books/
                           faq/
                               Makefile
                               book.sgml</programlisting>

	<para>Bei <literal>sv_SE.ISO8859-1</literal> handelt es sich um
	  den Namen der &Uuml;bersetzung in der
	  <filename><replaceable>lang</replaceable>.<replaceable>encoding</replaceable></filename>
	  Form.  Beachten Sie auch, dass zum Bauen der Dokumentation
	  zwei Makefiles notwendig sind.</para>

	<para>Komprimieren Sie Ihre &Uuml;bersetzungen mit &man.tar.1;
	  und &man.gzip.1; und senden Sie sie an das FreeBSD
	  Project.</para>

	<screen>&prompt.user; <userinput>cd doc</userinput>
&prompt.user; <userinput>tar cf swedish-docs.tar sv</userinput>
&prompt.user; <userinput>gzip -9 swedish-docs.tar</userinput></screen>

	<para>Legen Sie das Archiv <filename>swedish-docs.tar.gz</filename>
	  irgendwo ab.  Wenn Sie keinen eigenen Webspace haben (etwa weil
	  Ihr Internetprovider Ihnen keinen zur Verf&uuml;gung stellt),
	  k&ouml;nnen Sie auch eine E-Mail an das &a.doceng; schicken, um
	  abzukl&auml;ren, ob Sie die Datei auch als E-Mail schicken
	  k&ouml;nnen.</para>

	<para>In beiden F&auml;llen sollten Sie mit &man.send-pr.1;
	  einen Bericht &uuml;ber den Versand der Dokumentation
	  erstellen.  Es ist sehr hilfreich, wenn Sie Ihre
	  &Uuml;bersetzung vorher korrekturlesen lassen und
	  &uuml;berpr&uuml;fen, da es unwahrscheinlich ist, dass
	  der Committer Ihre Sprache sehr gut beherrscht.</para>

	<para>Danach wird jemand (meistens der Documentation Project
	  Manager, derzeit ist dies das &a.doceng;) &uuml;berpr&uuml;fen,
	  ob sich Ihre &Uuml;bersetzungen problemlos bauen lassen.  Dabei
	  wird besonders auf folgende Punkte geachtet:</para>

	<orderedlist>
	  <listitem>
	    <para>Verwenden alle Dateien RCS-Strings (wie "ID")?</para>
	  </listitem>

	  <listitem>
	    <para>Arbeitet <command>make all</command> im Verzeichnis
	      <filename>sv_SE.ISO8859-1</filename> korrekt?</para>
	  </listitem>

	  <listitem>
	    <para>Funktioniert <command>make install</command> ohne
	      Probleme?</para>
	  </listitem>
        </orderedlist>

	<para>Gibt es dabei Probleme, so wird die Person, die Ihren
	  Beitrag durchsieht, sich wieder an Sie wenden, damit Sie
	  das Problem beheben.</para>

	<para>Treten keine Probleme auf, wird Ihre &Uuml;bersetzung
	  so rasch als m&ouml;glich committed.</para>
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
	<para>Kann ich landes- oder sprachspezifische Informationen
	  in meine &Uuml;bersetzung aufnehmen?</para>
      </question>

      <answer>
	<para>Wir bitten Sie, dies nicht zu tun.</para>

	<para>Nehmen wir an, dass Sie das Handbuch ins Koreanische
	  &uuml;bersetzen und einen Abschnitt mit
	  H&auml;ndlerinformationen in das Handbuch aufnehmen
	  wollen.</para>

	<para>Es gibt keinen Grund, warum diese Information nicht auch
	  in der englischen (oder der deutschen, oder der spanischen,
	  oder der japanischen oder der &hellip;) Version vorhanden sein
	  sollte.  Es ist etwa denkbar, dass sich jemand mit englischer
	  Muttersprache w&auml;hrend eines Aufenthalts in Korea eine
	  FreeBSD-Kopie kaufen m&ouml;chte.  Au&szlig;erdem wird dadurch
	  die weltweite Pr&auml;senz von FreeBSD verdeutlicht, was
	  nat&uuml;rlich ebenfalls von Vorteil ist.</para>

	<para>Wenn Sie also l&auml;nderspezifische Informationen
	  erg&auml;nzen wollen, sollten Sie dies zuerst in der englischen
	  Version (mittels &man.send-pr.1;) tun, und die &Auml;nderung
	  anschlie&szlig;end in Ihre Sprache &uuml;bersetzen.</para>

	<para>Vielen Dank.</para>
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
	<para>Wie lassen sich sprachspezifische Zeichen darstellen?</para>
      </question>

      <answer>
	<para>Nicht-ASCII-Zeichen innerhalb der Dokumentation werden
	  durch SGML-Entities dargestellt.</para>

	<para>Diese bestehen aus:  Kaufm&auml;nnischem Und (&amp;),
	  den Namen der Entity, und einem Strichpunkt (;).</para>

	<para>Die Namen der Entities sind in ISO8879 definiert, die als
	  Port <filename role="package">textproc/iso8879</filename>
	  installiert werden kann.</para>

	<para>Dazu einige Beispiele:</para>

	<segmentedlist>
	  <segtitle>Entity</segtitle>

	  <segtitle>Darstellung</segtitle>

	  <segtitle>Beschreibung</segtitle>

	  <seglistitem>
	    <seg>&amp;eacute;</seg>
	    <seg>&eacute;</seg>
	    <seg>Kleines <quote>e</quote> mit (akutem) Akzent</seg>
	  </seglistitem>

	  <seglistitem>
	    <seg>&amp;Eacute;</seg>
	    <seg>&Eacute;</seg>
	    <seg>Gro&szlig;es <quote>E</quote> mit (akutem) Akzent</seg>
	  </seglistitem>

	  <seglistitem>
	    <seg>&amp;uuml;</seg>
	    <seg>&uuml;</seg>
	    <seg>Kleines Umlaut-<quote>u</quote></seg>
	  </seglistitem>
	</segmentedlist>

	<para>Nachdem Sie den iso8879-Port installiert haben, ist die
	  vollst&auml;ndige Liste unter
	  <filename>/usr/local/share/sgml/iso8879</filename>
	  vorhanden.</para>
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
	<para>Wie spricht man den Leser an?</para>
      </question>

      <answer>
	<para>In englischen Dokumenten wird der Leser mit
	  <quote>you</quote> angesprochen, es wird nicht zwischen
	  formeller/informeller Anrede unterschieden, wie dies in
	  manchen anderen Sprachen der Fall ist.</para>

	<para>Wenn Sie in eine Sprache &uuml;bersetzen, die diese
	  Unterscheidung trifft, verwenden Sie die Form, die auch in
	  den anderen technischen Dokumentationen dieser Sprache
	  verwendet wird.  F&uuml;r deutsche Versionen ist dies die
	  dritte Person Plural (<quote>Sie</quote>).</para>
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
	<para>Muss ich zus&auml;tzliche Informationen in meine
	  &Uuml;bersetzungen einbauen?</para>
      </question>

      <answer>
	<para>Ja.</para>

	<para>Der Header der englischen Version jedes Textes sieht in
	  etwa so aus:</para>

	<programlisting>&lt;!--
     The FreeBSD Documentation Project

     &dollar;FreeBSD: doc/en_US.ISO8859-1/books/fdp-primer/translations/chapter.sgml,v 1.5 2000/07/07 18:38:38 dannyboy Exp &dollar;
--&gt;</programlisting>

	<para>Das exakte Aussehen kann unterschiedlich sein,  die Zeile
	  mit &dollar;FreeBSD&dollar; sowie der Ausdruck <literal>The
	  FreeBSD Documentation Project</literal> sind allerdings immer
	  enthalten.  Beachten Sie, dass die Zeile mit &dollar;FreeBSD
	  von CVS automatisch expandiert wird, daher sollte an dieser
	  Stelle in Ihren neuen Dokumenten nur
	  <literal>&dollar;FreeBSD&dollar;</literal> stehen.</para>

	<para>Ihre &uuml;bersetzten Dokumente sollten eine eigene
	  &dollar;FreeBSD&dollar;-Zeile enthalten.  Zus&auml;tzlich
	  sollten Sie die Zeile mit <literal>The FreeBSD Documentation
	  Project</literal> in <literal>The FreeBSD
	  <replaceable>Ihre-Sprache</replaceable> Documentation
	  Project</literal> &auml;ndern.</para>

	<para>Au&szlig;erdem sollten Sie eine weitere Zeile
	  einf&uuml;gen, die festlegt, auf welcher Version des englischen
	  Originals Ihre &Uuml;bersetzung basiert.</para>

	<para>Die spanische Version dieser Datei k&ouml;nnte etwa so
	  beginnen:</para>

	<programlisting>&lt;!--
     The FreeBSD Spanish Documentation Project

     &dollar;FreeBSD: doc/es_ES.ISO8859-1/books/fdp-primer/translations/chapter.sgml,v 1.3 1999/06/24 19:12:32 jesusr Exp &dollar;
     Original revision: 1.11
--&gt;</programlisting>
      </answer>
    </qandaentry>
  </qandaset>
</chapter>

<!--
     Local Variables:
     mode: sgml
     sgml-declaration: "../chapter.decl"
     sgml-indent-data: t
     sgml-omittag: nil
     sgml-always-quote-attributes: t
     sgml-parent-document: ("../book.sgml" "part" "chapter")
     End:
-->
