<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
"dtd/kdex.dtd" [
<!ENTITY lokalize "Lokalize">
<!ENTITY kaider "Lokalize">
<!ENTITY kappname "Lokalize">
<!ENTITY package "kdesdk">
<!ENTITY % addindex "IGNORE">
<!ENTITY % German "INCLUDE">
]>
<book id="lokalize" lang="&language;">
<bookinfo>
<title
>Das Handbuch zu &lokalize;</title>
<authorgroup>
<author
><firstname
>Nick</firstname
> <surname
>Shaforostoff</surname
> <affiliation
><address
><email
>shaforostoff@kde.ru</email
></address
></affiliation>
</author>
<othercredit role="translator"
><firstname
>Ingo</firstname
><surname
>Malchow</surname
><affiliation
><address
><email
>ingomalchow@googlemail.com</email
></address
></affiliation
><contrib
>Übersetzung</contrib
></othercredit
><othercredit role="translator"
><firstname
>Justus</firstname
><surname
>Seifert</surname
><affiliation
><address
><email
>justus.seifert@googlemail.com</email
></address
></affiliation
><contrib
>Übersetzung</contrib
></othercredit
><othercredit role="translator"
><firstname
>Johannes</firstname
><surname
>Obermayr</surname
><affiliation
><address
><email
>johannesobermayr@gmx.de</email
></address
></affiliation
><contrib
>Überarbeitung der Übersetzung</contrib
></othercredit
> 
</authorgroup>

<copyright>
<year
>2007-2009</year
><holder
>Nick Shaforostoff</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2009-05-09</date>
<releaseinfo
>1.0</releaseinfo>

<abstract>
<para
>&lokalize; ist ein rechnergestütztes Übersetzungssystem, das auf Produktivität und Qualitätssicherung ausgelegt ist. Es besteht aus Komponenten, die gewöhnlich für solche Systeme sind: Übersetzungsdatenbank, Glossar und auch eine einzigartige Möglichkeit zum Zusammenführen der Übersetzung mit dem Quelldokument (Synchronisation). Es ist für die Übersetzung von Software gedacht und bindet externe Umwandlungswerkzeuge für die freie Übersetzung von Bürodokumenten ein. </para>
</abstract>

<keywordset>
<keyword
>&lokalize;</keyword>
<keyword
>Lokalisierung</keyword>
<keyword
>l10n</keyword>
<keyword
>Internationalisierung</keyword>
<keyword
>i18n</keyword>
<keyword
>Übersetzung</keyword>
<keyword
>Globalisierung</keyword>
<keyword
>g11n</keyword>
<keyword
>XLIFF</keyword>
<keyword
>gettext</keyword>
<keyword
>OpenDocument</keyword>
<keyword
>KBabel</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Einführung</title>

<para
>Beim ersten Aufruf von &lokalize; wird eine leere <guilabel
>Projektübersicht</guilabel
> angezeigt. Der Ablauf in &lokalize; sieht dann das Erstellen bzw. Öffnen eines Projekts vor. </para>
<para
>Für die Übersetzung einer OpenDocument-Datei ist der Menüeintrag <menuchoice
><guimenu
>Projekt</guimenu
><guimenuitem
>Neues Projekt erstellen</guimenuitem
></menuchoice
> vorgesehen. Der Assistent fragt nach der Quelldatei, wandelt diese ins interne Format von &lokalize; (XLIFF) um und erstellt das Projekt dafür. Nach Abschluss der Übersetzung wird diese mittels <menuchoice
><guimenu
>Werkzeuge</guimenu
><guimenuitem
>Mit ODF zusammenführen</guimenuitem
></menuchoice
> in eine Kopie des Quelldokuments eingebunden. </para>

<para
>Beim Übersetzen von &kde; liegt entweder bereits eine Projektdatei (meist <filename
>index.lokalize</filename
>) im Projektordner vor oder es kann mittels <menuchoice
><guimenu
>Projekt</guimenu
><guimenuitem
>Neues Projekt erstellen</guimenuitem
></menuchoice
> ein neues Projekt erstellt werden. Beim Erstellen eines neuen Projekts lädt der Assistent die Dateien für die Übersetzung herunter. </para>

<para
>Die Übersetzungsdateien werden in zusätzlichen Unterfenstern mit zwei großen Fenstern zur Anzeige von Original und Übersetzung sowie einigen <emphasis
>Werkzeugansichten</emphasis
> geöffnet. Diese Ansichten können als Bestandteil des Hauptfensters nebeneinander oder gestapelt als Karteikarten und als unabhängige Fenster angezeigt oder auch ausgeblendet. Die Übersetzungsdateien bestehen aus vielen Paaren von Originaltext und Übersetzung, den sog. <emphasis
>Einheiten</emphasis
>. Eine <emphasis
>Einheit</emphasis
> entspricht üblicherweise einer einzelnen Zeichenkette in der Benutzeroberfläche oder einem Absatz in der Dokumentation. Im ersten Fenster (oben) wird der zu übersetzende Text angezeigt. Im zweiten Fenster (unten) kann die Übersetzung dieses Textes bearbeitet werden. Mit Hilfe der <guilabel
>Übersetzungsliste</guilabel
> oder durch die Verwendung der Tasten <keycap
>Bild ab</keycap
> und <keycap
>Bild auf</keycap
> kann durch die <emphasis
>Einheiten</emphasis
> geblättert werden. </para>

<tip>
<para
>Zum effektiveren Arbeiten sollten die Tastenkürzel anstelle der Menüeinträge oder der Knöpfe in den Werkzeugleisten verwendet werden. Zum Beispiel wird mit <keycombo
>&Ctrl;<keycap
>L</keycap
></keycombo
> zur Eingabezeile der <guilabel
>Schnellsuche</guilabel
> für das Filtern der Einheiten in der <guilabel
>Übersetzungsliste</guilabel
> gesprungen. Mit <keycap
>Bild ab</keycap
> ist dann das Bewegen in der gefilterten Liste möglich. </para>
</tip>

<para
>Eine Einheit kann <emphasis
>übersetzt</emphasis
> oder <emphasis
>nicht übersetzt</emphasis
> sein. Eine bereits übersetzte Einheit kann den Status <emphasis
>fertig</emphasis
> oder  <emphasis
>nicht fertig</emphasis
> (teilweise auch als <emphasis
>fraglich</emphasis
> bezeichnet) besitzen.  Die Übersetzung einer <emphasis
>nicht fertigen</emphasis
> Einheit wird kursiv dargestellt. In &lokalize; kann anhand des Status schnell durch eine Datei navigiert werden. Die Menüeinträge und Kurzbefehle dazu sind im Menü <guimenu
>Gehe zu</guimenu
> auffindbar. Bei der Navigation in der <guilabel
>Übersetzungsliste</guilabel
> werden nicht übersetzte Nachrichten als <emphasis
>nicht fertig</emphasis
> berücksichtigt. Mit <keycap
>Bild ab</keycap
> kann zum nächsten Element in der gefilterten bzw. sortierten Liste gesprungen werden. </para>

<para
>Falls mit Übersetzungsdateien im „XLIFF“-Format (definitiv bei OpenDocument) gearbeitet wird, sind weitere Status verfügbar (<emphasis
>Neu</emphasis
>, <emphasis
>Benötigt Prüfung</emphasis
>, <emphasis
>Freigegeben</emphasis
>, usw.). Diese können im Auswahlfeld <guilabel
>Freigegeben</guilabel
> in der Werkzeugleiste ausgewählt werden. Das Festlegen des Status <emphasis
>Fertig</emphasis
> oder <emphasis
>Nicht fertig</emphasis
> hängt vom aktuellen <emphasis
>Arbeitsschritt</emphasis
> ab (<emphasis
>Übersetzung</emphasis
>, <emphasis
>Prüfung</emphasis
> oder <emphasis
>Freigabe</emphasis
>). Der standardmäßige Arbeitsschritt hängt von der jeweiligen <emphasis
>Rolle</emphasis
> innerhalb des Projekts ab (siehe <menuchoice
><guimenu
>Projekt</guimenu
><guimenuitem
>Projekt einrichten ...</guimenuitem
></menuchoice
>). Jede Einheit enthält in der Regel Informationen über die letztmalige Änderung und den jeweils in der Datei festgelegten <emphasis
>Eigentümer</emphasis
> des Arbeitsschritts. </para>

</chapter>

<chapter id="projects">
<title
>Projekte</title>

<para
>Projekte sind eines der wichtigsten Konzepte von &lokalize;. Ein Projekt besteht aus einer Datei, die Pfade zu den Ordnern mit Übersetzungen und Vorlagen enthält. Zu einem Projekt gehören noch weitere Dateien wie zum Beispiel eine Glossar-Datei, Skripte und eine Übersetzungsdatenbank. Wenn Sie mit &lokalize; eine Datei öffnen, ohne dass ein Projekt geladen ist, sucht &lokalize; in bis zu 4 Ebenen oberhalb des Ordners mit der Übersetzungsdatei nach einer Projektdatei. Alternativ können Sie die Projektdatei über die Option <userinput
>--project</userinput
> angeben, wenn Sie &lokalize; über die Befehlszeile starten. </para>

<para
>Für jedes Projekt wird die eigene Rolle (<emphasis
>Übersetzer</emphasis
>, <emphasis
>Prüfer</emphasis
> oder <emphasis
>Schlusszeichner</emphasis
>) vergeben und bestimmt dadurch den automatischen Ablauf für die zu bearbeitenden Dateien. </para>

<note>
<para
>Anders als die Projektdateien, das Glossar und die Skripte kann die Übersetzungsdatenbank nicht gemeinsam von den Mitgliedern eines Übersetzungsteams genutzt werden, da sie lokal in einem Ordner eines Nutzers erstellt und gespeichert wird. Alle Übersetzungsdatenbanken der verschiedenen Projekte werden im gleichen Ordner gespeichert. Die Einträge in den verschiedenen Datenbanken können dann in allen Projekten verwendet werden. </para>
</note>

<sect1 id="project-view">
<title
>Projektübersicht</title>

<para
>Die <guilabel
>Projektübersicht</guilabel
> stellt eine Baumansicht der Dateien mit Statistiken wie den prozentualen Anteil übersetzter Einheiten und dem letzten Übersetzer dar. Sie ermöglicht das Öffnen einer ausgewählte Datei in einem neuen Unterfenster in &lokalize;. </para>

</sect1>

</chapter>

<chapter id="glossary">
<title
>Glossar</title>

<para
>Um die mehrfache Eingabe eines identischen Textes zu vermeiden, kann dieser Text in der <guilabel
>Glossaransicht</guilabel
> gesucht und mit einer Tastenkombination einfügt werden. </para>

<para
>Natürlich muss das Glossar zuerst mit Einträgen gefüllt werden. Dazu bietet &lokalize; einen praktischen Glossareditor, der auch eine detaillierte Suche im gesamten Glossar ermöglicht. </para>

<screenshot>
<screeninfo
>Das Glossar rechts unten zeigt alle passenden Einträge für die aktuelle Einheit</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="glossary.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Das Glossar rechts unten zeigt alle passenden Einträge für die aktuelle Einheit</phrase>
    </textobject>
  </mediaobject>
</screenshot>

</chapter>

<chapter id="tm">
<title
>Übersetzungsdatenbank</title>

<para
>In das Fenster mit der <guilabel
>Übersetzungsdatenbank</guilabel
> können beispielsweise Ordner mit Übersetzungsdateien aus Dolphin gezogen werden. Dann werden die Übersetzungen in diesen Dateien in die Datenbank übernommen. Um Übersetzungsvorschläge in das Übersetzungsfenster einzufügen, wird <keycombo
>&Ctrl;<keycap
>1</keycap
></keycombo
>, <keycombo
>&Ctrl;<keycap
>2</keycap
></keycombo
>, usw. verwendet (je nach Anzahl der Vorschläge). </para>

<para
>Durch Drücken der Taste <keycap
>F7</keycap
> wird ein neues Unterfenster mit der  <guilabel
>Übersetzungsdatenbank</guilabel
> geöffnet. In diesem Unterfenster können Einheiten in der Übersetzungsdatenbank gesucht werden. Das Klicken auf das Ergebnis einer Suche öffnet die zugehörige Datei mit dieser Einheit. Um eine Datei schnell zu öffnen, die bereits in die Übersetzungsdatenbank eingelesen wurde, muss nur der Dateiname gefolgt von '*' in das Feld <guilabel
>Dateimaske</guilabel
> eingegeben werden, es ist nicht nötig, die Datei in der <guilabel
>Projektübersicht</guilabel
> zu suchen. </para>

<para
>In der Übersetzungsdatenbank werden alle Einheiten einschließlich der fraglichen und nicht übersetzten indiziert. Damit müssen bei einer Suche nicht mehr alle Dateien im Projekt eingelesen und auf einen passenden Eintrag überprüft werden. </para>

<screenshot>
<screeninfo
>&lokalize; mit dem Ergebnis der Suche für die aktuelle Einheit aus der Übersetzungsdatenbank</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="tmview.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>&lokalize; mit dem Ergebnis der Suche für die aktuelle Einheit aus der Übersetzungsdatenbank</phrase>
    </textobject>
  </mediaobject>
</screenshot>

</chapter>


<chapter id="sync">
<title
>Abgleich von Übersetzungen</title>

<para
>Der <guilabel
>Abgleichmodus</guilabel
> erspart viel Arbeit, wenn zwei oder mehr Übersetzer gleichzeitig an derselben Datei arbeiten, oder wenn ein Übersetzer verschiedene Zweige einer Software betreut. </para>

<para
>&lokalize; ermöglicht eine schnelle Navigation durch die Einheiten mit unterschiedlichen Übersetzungen und zeigt die Unterschiede Wort für Wort an. Des Weiteren besitzt &lokalize; zwei Abgleichansichten - den <guilabel
>Primären Abgleich</guilabel
> und den <guilabel
>Sekundären Abgleich</guilabel
>. Beide Ansichten verhalten sich gleich, aber die erste wird normalerweise für das Zusammenführen und die zweite zum Abgleich von Übersetzungen in zwei verschiedenen Softwarezweigen verwendet. </para>

<para
>Nachdem eine Übersetzung aus einer zusätzlichen Datei kopiert wurde (bzw. mit dieser <emphasis
>abgeglichen</emphasis
> wurde), werden alle nachfolgenden Änderungen an der entsprechenden Einheit auf die zusätzliche Datei zurückkopiert. </para>

<sect1 id="file-merge">
<title
>Zusammenführen</title>
<para
>Eine Verwendung findet der <guilabel
>Abgleichmodus</guilabel
> im Prüfen der (geänderten) Übersetzungen von (neuen) Übersetzern (sofern für die Qualität der Übersetzungen keine Sicherheit gegeben ist). </para>
<para
>Hierzu wird die Ausgangsdatei geöffnet, die überarbeitete Datei in das Fenster <guilabel
>Primärer Abgleich</guilabel
> gezogen und schließlich mittels <keycombo
>&Alt;<keycap
>Pfeil runter</keycap
></keycombo
> oder <keycombo
>&Alt; <keycap
>Pfeil hoch</keycap
></keycombo
> durch die Einträge mit abweichenden Übersetzungen geblättert.     </para>
<screenshot>
<screeninfo
>&lokalize; beim Zusammenführen von Änderungen in Übersetzungen</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="sync.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>&lokalize; beim Zusammenführen von Änderungen in Übersetzungen</phrase>
    </textobject>
  </mediaobject>
</screenshot>

</sect1>

<sect1 id="file-sync">
<title
>Abgleichen</title>
<para
>Im <guilabel
>Abgleichmodus</guilabel
> können Änderungen an Übersetzungen von zwei Zweigen gleichzeitig vorgenommen werden. Der Pfad zum Basisordner des Zweiges wird hierzu als <guilabel
>Zweig-Ordner</guilabel
> in den Projekteinstellungen gesetzt. Dann werden die Dateien in diesem Zweig automatisch als <guilabel
>Sekundärer Abgleich</guilabel
> geöffnet. Wenn nun Übersetzungen in Dateien im Hauptzweig geändert werden, werden diese Änderungen automatisch auch in den Dateien des Nebenzweiges vorgenommen (sofern der Originaltext in beiden Dateien übereinstimmt). </para>
<para
>Wenn beispielsweise an der Übersetzung von KDE gearbeitet wird, kann „trunk“ nach <filename class="directory"
>/home/xx/hacking/kde/trunk/l10n-kde4/de</filename
> und „branch“ nach <filename class="directory"
>/home/xx/hacking/kde/branches/stable/l10n-kde4/de</filename
> ausgecheckt werden. Das &lokalize;-Projekt <filename
>/home/xx/hacking/kde/trunk/l10n-kde4/de/projekt.lokalize</filename
> wird erstellt und <filename class="directory"
>BranchDir=../../../branches/stable/l10n-kde4/de</filename
> gesetzt. Beim Bearbeiten des Projekts werden dann die Änderungen gleichzeitig im „trunk“- und „branch“-Verzeichnis ausgeführt. </para>
</sect1>


<sect1 id="alt-trans">
<title
>Alternative Übersetzungen</title>

<para
>Jede Einheit hat verschiedene <emphasis
>Alternative Übersetzungen</emphasis
>, die mit ihr im Zusammenhang stehen. Solche Übersetzungen können während der Aktualisierung der Datei bei kleineren Änderungen der Quelle entstehen. In diesem Fall wird die alte Übersetzung zusammen mit der alten Quelle zu den <emphasis
>Alternativen Übersetzungen</emphasis
> verschoben und beide sind somit nicht verloren. </para>
<para
>Beim Übersetzen von Software werden meist die „gettext“-Werkzeuge für die Aufbereitung der Übersetzungdateien verwendet. Wenn sich der Originaltext für die Übersetzung ändert, aktualisieren die „gettext“-Werkzeuge die Übersetzungsdateien und markieren Einträge mit verändertem Originaltext als <emphasis
>nicht fertig</emphasis
>. Sie speichern den früheren Originaltext, so dass die Übersetzer genau sehen können, was sich verändert hat. &lokalize; erleichtert die Übersetzung, indem es die veränderten Teile des Originaltextes im Fenster <guilabel
>Alternative Übersetzungen</guilabel
> hervorhebt. </para>

<screenshot>
<screeninfo
>&lokalize; hebt die Teile des Ausgangstextes hervor die seit der letzten Überprüfung der Übersetzung verändert wurden</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="original-diff.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>&lokalize; hebt die Teile des Ausgangstextes hervor die seit der letzten Überprüfung der Übersetzung verändert wurden</phrase>
    </textobject>
  </mediaobject>
</screenshot>


</sect1>

</chapter>

<chapter id="scripting">
<title
>Skripte in &lokalize;</title>

<para
>&lokalize; ist durch die Verwendung von Skripten in verschiedenen Programmiersprachen (einschl. Python und JavaScript) erweiterbar. Die Skripte werden üblicherweise als Menüeinträge (ggf. mit Tastenkürzel) in die grafische Benutzeroberfläche von &lokalize; eingebunden. Der Ort und Name des Menüeintrags für das Skript wird in seiner <filename
>.rc</filename
>-Datei festgelegt. Beim Öffnen jedes Projekts durchsucht &lokalize; den Ordner <filename
>Projektordner/lokalize-scripts</filename
> nach <filename
>.rc</filename
>-Dateien und fügt diese zur <emphasis
>Zwischenspeicher</emphasis
>-Datei namens <filename
>Projektordner/lokalize-scripts/scripts.rc</filename
> hinzu (daher sollte vom Hinzufügen seines Projektverwaltungssystems abgesehen werden). Die <filename
>.rc</filename
>-Dateien enthalten auch die Skript-Pfade, welche möglicherweise relativ zum Ordner der <filename
>.rc</filename
>-Datei oder eines System-Skripts sind - sie unterstützen beides (die <filename
>.rc</filename
>-Dateien <emphasis
>sollten</emphasis
> für die gemeinsame Nutzung im Projekt <filename
>relativ</filename
> sein). Damit kann beispielsweise in <filename
>../../scripts/lokalize/opensrc.py</filename
> festgelegt werden, dass Skripte vom <ulink url="http://websvn.kde.org/trunk/l10n-kde4/scripts/lokalize/"
>allgemeinen Skript-Ordner</ulink
> geladen werden (und nicht vom sprachenspezifischen Ordner). </para>
<para
>Beispiele für <filename
>.rc</filename
>-Dateien sind möglicherweise im Installationsordner von &lokalize; (<filename
>/usr/share/kde4/apps/lokalize/scripts/</filename
> und <ulink url="http://websvn.kde.org/trunk/l10n-kde4/scripts/lokalize/"
>KDE-SVN</ulink
> auffindbar. <ulink url="http://websvn.kde.org/trunk/l10n-kde4/ru/lokalize-scripts/"
>Hier</ulink
> sind weitere Skript-Beispiele wie beispielsweise das JavaScript-basierte <filename
>check-gui.js</filename
>, das bei jedem Speichern einer Datei läuft (dies wird durch eine spezielle Einstellung in der <filename
>.rc</filename
>-Datei bewerkstelligt). Bei Kenntnissen in Python oder JavaScript sollte der Quelltext selbsterklärend sein. </para>
<para
>Nachstehend werden Verknüpfungen zu den Programmierschnittstellen (API-Referenzen) aufgeführt. Alles mit <emphasis
>Q_SCRIPTABLE</emphasis
> kann in Skripten Verwendung finden. </para>

<itemizedlist>
<listitem>
<para
><ulink url="http://api.kde.org/4.x-api/kdesdk-apidocs/lokalize/html/classEditorTab.html"
>Editor</ulink
>-Programmierschnittstelle </para>
</listitem>
<listitem>
<para
><ulink url="http://api.kde.org/4.x-api/kdesdk-apidocs/lokalize/html/classLokalizeMainWindow.html"
>Lokalize</ulink
>-Programmierschnittstelle </para>
</listitem>
<listitem>
<para
><ulink url="http://api.kde.org/4.x-api/kdesdk-apidocs/lokalize/html/classProjectTab.html"
>Projekt</ulink
>-Programmierschnittstelle </para>
</listitem>
</itemizedlist>


</chapter>

<chapter id="credits">
<title
>Danksagungen und Lizenz</title>

<para
>&lokalize; </para>

<para
>Programm Copyright &copy; 2007-2009, Nick Shaforostoff <email
>shaforostoff@kde.ru</email
> </para>

<para
>Einiger Quelltext wurde vom &lokalize;-Vorläufer &kbabel; übernommen. </para>

<para
>Dokumentation Copyright &copy; 2007-2009 Nick Shaforostoff <email
>shaforostoff@kde.ru</email
> </para>

<para
>Autor: <itemizedlist
> <listitem
> <para
>Nick Shaforostoff <email
>shaforostoff AT kde.ru</email
> </para>
</listitem>
</itemizedlist>
</para>

<para
>Weitere Informationen finden sind auf der <ulink url="http://userbase.kde.org/lokalize"
>&lokalize;-Webseite</ulink
> verfügbar.</para>

<para
>Übersetzung: Ingo Malchow <email
>ingomalchow@googlemail.com</email
>, Justus Seifert <email
>justus.seifert@googlemail.com</email
></para
><para
>Überarbeitung der Übersetzung: Johannes Obermayr <email
>johannesobermayr@gmx.de</email
></para
> 
&underFDL; &underGPL; </chapter>

&documentation.index;
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

// vim:ts=2:sw=2:tw=78:noet
-->