<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "
http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY app "<application>gPDFText</application>">
<!ENTITY appversion "0.1.0">
<!ENTITY date "Oct 2009">
<!ENTITY legal SYSTEM "legal.xml">
]>
<article id="index" lang="de">

<articleinfo>
	<title>Handbuch zu gPDFText</title>
	<date>2009-12-27</date>
	<copyright>
		<year>2009</year>
		<holder>Neil Williams</holder>
 	</copyright><copyright><year>2009</year><holder>Thomas Müller (thomas.mueller@tmit.eu)</holder></copyright><copyright><year>2009</year><holder>Hilmar Ackermann (debian-l10n-german@lists.debian.org)</holder></copyright>
	<publisher>
		<publishername>Neil Williams</publishername>
	</publisher>
	  <legalnotice id="legalnotice">
	<para>
	Permission is granted to copy, distribute and/or modify this document
	under the terms of the GNU Free Documentation License, Version 1.3
	or any later version published by the Free Software Foundation;
	with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
	A copy of the license is included in the section entitled "GNU
	Free Documentation License".
	You can find a copy of the GFDL at this <ulink type="help" url="ghelp:fdl">link</ulink> or in the file COPYING-DOCS
	distributed with this manual.
	</para>

	<para>
	  Many of the names used by companies to distinguish their
	  products and services are claimed as trademarks. Where those
	  names appear in any GNOME documentation, and the members of
	  the GNOME Documentation Project are made aware of those
	  trademarks, then the names are in capital letters or initial
	  capital letters.
	</para>

	<para>
	DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED
	UNDER  THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE
	WITH THE FURTHER UNDERSTANDING THAT:

	  <orderedlist>
		<listitem>
		  <para>DOCUMENT IS PROVIDED ON AN "AS IS" BASIS,
			WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR
			IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES
			THAT THE DOCUMENT OR MODIFIED VERSION OF THE
			DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR
			A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE
			RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE
			OF THE DOCUMENT OR MODIFIED VERSION OF THE
			DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR
			MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT,
			YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY
			CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY
			SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER
			OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS
			LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED
			VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER
			EXCEPT UNDER THIS DISCLAIMER; AND
		  </para>
		</listitem>
		<listitem>
		  <para>UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL
		   THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE),
		   CONTRACT, OR OTHERWISE, SHALL THE AUTHOR,
		   INITIAL WRITER, ANY CONTRIBUTOR, OR ANY
		   DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION
		   OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH
		   PARTIES, BE LIABLE TO ANY PERSON FOR ANY
		   DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR
		   CONSEQUENTIAL DAMAGES OF ANY CHARACTER
		   INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS
		   OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR
		   MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR
		   LOSSES ARISING OUT OF OR RELATING TO USE OF THE
		   DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT,
		   EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF
		   THE POSSIBILITY OF SUCH DAMAGES.
		  </para>
		</listitem>
	  </orderedlist>
	</para>
  </legalnotice>

	<abstract role="description">
		<para>Handbuch für den eBook-PDF-Editor gPDFText.</para>
	</abstract>
	<authorgroup>
		<author role="maintainer">
			<firstname>Neil</firstname>
			<surname>Williams</surname>
			<affiliation>
				<orgname>Entwickler von gPDFText</orgname>
				<address>
					<email>linux@codehelp.co.uk</email>
				</address>
			</affiliation>
		</author>
	</authorgroup>
<revhistory>
<revision>
  <revnumber>0.1.0</revnumber>
  <date>27 Dec 2009</date>
</revision>
</revhistory>
</articleinfo>

<indexterm zone="index">
	<primary>gPDFText</primary>
</indexterm>
<indexterm zone="index">
	<primary>gpdftext</primary>
</indexterm>

<!-- ============= Introduction ============================== -->
<!-- Use the Introduction section to give a brief overview of what
     the application is and what it does. -->

<sect1 id="gpdftext-introduction">
	<title>Einleitung</title>
	<para><command><application>gPDFText</application></command> ist ein GTK+-Texteditor für eBook-PDF-Dateien.</para>
	<para>Mit <application>gPDFText</application> können Sie den Text aus einer eBook-PDF-Datei laden und einen besseren Textfluss erzielen.</para>
	<para>Viele heruntergeladenen PDF-Dateien für eBook-Reader nutzen noch das Papierformat A4 (oder ähnliche Formate) und wenn der eBook-Reader das PDF anzeigt, wird der Text häufig zu klein, da er zu weit herausgezoomt werden muss, damit die ganze Seite angezeigt werden kann. Einfach nur das PDF als Text zu exportieren führt zu Problemen mit dem Zeilenumbruch und macht Schwierigkeiten mit den unterschiedlichen Arten der Kopf- und Fußzeilen. Dies macht es schwer, die Umwandlung zu automatisieren.</para>
	<para><command><application>gPDFText</application></command> lädt das PDF, extrahiert den Text und wandelt die Absätze in einzelne, lange Zeilen um. Anschließend wird der so entstandene Text in einem normalen GTK+-Editor geladen, in dem weitere Anpassungen erfolgen können.</para>
	<para>Im eBook-Reader hat der reine Text keine unerwünschten Zeilenumbrüche und kann auf jede beliebige Textgröße vergrößert werden.</para>
	<para>Jeder einzelne Umformatierungsschritt kann in den Einstellungen von <application>gPDFText</application> deaktiviert werden. Siehe <link linkend="regexps">Reguläre Ausdrücke ändern</link>.</para>
	<para>Die Rechtschreibprüfung hilft Abschnitte zu erkennen, an denen weiteres Bearbeiten nötig sein kann oder wo Seitentitel noch im extrahierten Text enthalten sind.</para>
	<para>Der extrahierte und bearbeitete Text kann in eine neue PDF-Datei mit nützlicheren Seitengrößen (A5 oder B5) gespeichert werden, damit der eBook-Reader die gesamte Seite auf einmal in einer komfortablen Vergrößerung anzeigen kann. Sobald das PDF gespeichert ist, kann es aus dem Editor heraus aktualisiert werden.</para>
	<para>Jedwede Textdatei kann ebenso geöffnet und als PDF gespeichert werden, wobei Dateien, die an <application>gPDFText</application> über die Befehlszeile übergeben werden, PDF-Dateien sein müssen.</para>
</sect1>

<!-- =========== Getting Started ============================== -->
<!-- Use the Getting Started section to describe the steps required
     to start the application and to describe the user interface components
     of the application. If there is other information that it is important
     for readers to know before they start using the application, you should
     also include this information here.
     If the information about how to get started is very short, you can
     include it in the Introduction and omit this section. -->
<sect1 id="gpdftext-getting-started">
	<title>Erste Schritte</title>
	<para>Sie können <application>gPDFText</application> folgendermaßen starten: <variablelist>
			<varlistentry>
				<term>Das Hauptmenü des <guimenu>Programms</guimenu></term>
				<listitem>
				<para>Wählen Sie <menuchoice><guisubmenu>Zubehör</guisubmenu><guimenuitem>gPDFText eBook-Editor</guimenuitem></menuchoice>.</para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term>Befehlszeile</term>
				<listitem>
				<para>Geben Sie <command>gpdftext</command> in die Befehlszeile ein und drücken Sie dann <keycap>Enter</keycap>.</para>
				<para>Zurzeit werden keine Befehlszeilenparameter unterstützt.</para>
				<para>Wenn der Name einer PDF-Datei folgt, so wird diese von <command><application>gPDFText</application></command> geöffnet.</para>
				</listitem>
			</varlistentry>
		</variablelist></para>
</sect1>

<!-- ================ Usage ================================ -->
<!-- Use this section to describe how to use the application to perform the tasks for
  which the application is designed. -->

<sect1 id="gpdftext-usage">
	<title>Benutzung</title>
	<para>
	</para>
	<sect2 id="editor-window">
		<title>Arbeiten mit dem gPDFText-Editorfenster</title>
		<para>Der in <application>gPDFText</application> eingebaute Editor unterstützt eine eingebettete Rechtschreibprüfung.</para>
		<sect3 id="editor-window-spelling">
			<title>Rechtschreibprüfung</title>
			<para>Um die eingebettete Rechtschreibprüfung zu aktivieren, klicken Sie in der Menüleiste auf <menuchoice><guisubmenu>Ansicht</guisubmenu><guimenuitem>Rechtschreibprüfung</guimenuitem></menuchoice>. Eine wellenförmige rote Linie erscheint unter falsch geschriebenen Wörtern. Wenn Sie auf eines dieser Worte recht-klicken, erscheint ein Kontextmenü mit dem Eintrag <guimenuitem>Rechtschreib-Vorschläge</guimenuitem>. Wenn Sie auf eine der dargestellten Vorschläge klicken, wird dieser anstelle des falsch geschriebenen Worts eingesetzt.</para>
			<para>Drücken Sie die <emphasis>F7</emphasis>-Taste, um die Rechtschreibprüfung schnell ein- oder auszuschalten.</para>
		</sect3>
	</sect2>
	<sect2 id="undo-redo">
		<title>Rückgängig und Wiederherstellen</title>
		<para>Benutzen Sie <emphasis>Strg-Z</emphasis>, um Änderungen rückgängig zu machen und <emphasis>Umschalt-Strg-Z</emphasis>, um das Original wiederherzustellen.</para>
	</sect2>
	<sect2 id="savingfiles">
	<title>Speichern von Dateien</title>
	<para><application>gPDFText</application> kann den Text als ASCII-Text-Dateien oder als benutzerdefiniertes PDF speichern.</para>
	</sect2>
</sect1>

<!-- ============= Customization ============================= -->
<!-- Use this section to describe how to customize the application. -->
<sect1 id="regexps">
	<title>Reguläre Ausdrücke auswählen</title>
		<para>Die Einstellungen ermöglichen eine individuelle Anpassung von <application>gPDFText</application>. Sie können bestimmen, wie eine PDF-Datei geladen und verändert werden soll. Wählen Sie dazu <menuchoice><guisubmenu>Bearbeiten</guisubmenu><guimenuitem>Einstellungen</guimenuitem></menuchoice> oder klicken Sie den Einstellungen-Knopf auf der Werkzeugleiste, um die Einstellungen anzuzeigen.</para>
	<para><application>gPDFText</application> führt drei Arten von Veränderungen auf dem aus dem eBook-PDF extrahierten Text aus, welche durch den Benutzer abgeschaltet werden können, abhängig davon, wie die geöffnete PDF-Datei vorbereitet war.</para>
	<sect2 id="longlines">
		<title>Einzelne Zeilen zusammenfügen.</title>
		<para>Die meisten Benutzer werden diese Einstellung aktivieren, da sie die einzelnen Zeilen zu Absätzen konvertiert, so dass das Lesegerät sie einwandfrei formatieren kann.</para>
		<programlisting>
		Ansonsten wird der Text eines Romans
		ungefähr
		folgendermaßen aussehen.
		Dies sollte ja eigentlich ein Absatz sein.
		</programlisting>
	</sect2>
	<sect2 id="hyphens">
		<title>Mit Bindestrich getrennte Wörter zusammenfügen</title>
		<para>Auch diese Funktion werden die meisten Benutzer aktivieren, da sie die mit Bindestrichen getrennten Wörter wieder zusammenfügt, welche ansonsten in der Mitte einer Zeile weiterhin mit einem Bindestrich stehen könnten.</para>
		<programlisting>
		Ansonsten wird der Text eines Romans vielleicht so aus- sehen,
		was nicht unbedingt gewollt ist.
		</programlisting>
	</sect2>
	<sect2 id="pagenum">
		<title>Fußnoten mit Seitennummerierung entfernen.</title>
		<para>Nur Fußnoten mit einfachster Seitennummerierung können hierdurch entfernt werden. Wenn das PDF den Namen des Buches, des Kapitels oder irgendetwas anderes (z.B. einen Verweis auf die Downloadseite) in der Fußnote enthält, müssen Sie derartige Fußnoten manuell entfernen.</para>
		<para>In manchen Fällen können speziell formatierte Seitennummern (Leerzeichen, Nummern und ein Zeilenende) Probleme verursachen. <application>gPDFText</application> streicht dann z.B. manche Seiten vom PDF heraus. In diesem Fall sollte man diese Einstellung deaktivieren und die PDF-Datei neu öffnen.</para>
	</sect2>
</sect1>

<!-- ============= Customization ============================= -->
<!-- Use this section to describe how to customize the application. -->
<sect1 id="pdfgenerate">
	<title>Einstellungen für die Verwaltung von PDF-Dateien</title>
	<sect2 id="paper-sizes">
		<title>Auswahl eines Papierformats für das PDF</title>
		<para>Normalerweise können eBook-Dateien am einfachsten gelesen werden, wenn das Papierformat des PDFs kleiner als der Standard A4 wird. A4 bleibt als Option für andere PDF-Dateien.</para>
		<para>Papierformate verwenden ein Verhältnis von 0,7:1 und das ist auch der Grund, warum das Hauptfenster von <application>gPDFText</application> standardmäßig eine leicht ungewöhnliche Form besitzt.</para>
		<para>A4 210mm x 297mm 8,3 x 11,7 Zoll</para>
		<para>A5 148mm × 210mm 5,8 x 8,3 Zoll</para>
		<para>B5 176mm × 250mm 6,9 x 9,8 Zoll</para>
		<para>Siehe auch: <ulink url="http://www.cl.cam.ac.uk/~mgk25/iso-paper.html"> http://www.cl.cam.ac.uk/~mgk25/iso-paper.html</ulink> und <ulink url="http://www.hintsandthings.co.uk/office/paper.htm">http://www.hintsandthings.co.uk/office/paper.htm</ulink></para>
	</sect2>
	<sect2 id="selectfont">
		<title>Auswahl der Schriftart</title>
		<para>Die ausgewählte Schriftart für den Editor ist die selbe Schriftart (mit gleicher Größe), die zum Erzeugen des PDFs benutzt wird.</para>
	</sect2>
</sect1>

<!-- ============= FAQ ============================= -->
<!-- Use this section to list frequently-asked questions. -->

<sect1 id="gpdftext-faq">
	<title>Häufig gestellte Fragen</title>
	<sect2 id="opening-pdf">
		<title>Erstellung von Text-basierten PDF-Dateien für andere Zwecke</title>
		<para>Wenn Text-basierte PDF-Dateien mit <application>gPDFText</application> erzeugt werden, kann es passieren, dass das erzeugte PDF &ndash; abhängig von der Art des Textinhalts &ndash; keinen Textinhalt bereitstellt, wenn das PDF mit <application>gPDFText</application> geöffnet wird.</para>
		<para>Falls der Textinhalt eine Geschichte oder ein Roman ist, sollte das als Fehler gemeldet werden. Falls der Textinhalt eine andere Art von Text-Datei ist (wie etwa eine Quellcode-Datei oder eine andere Datei mit ähnlich striktem Format), sollte die Original-Datei erneut geöffnet werden anstelle Text aus dem PDF zu extrahieren.</para>
		<para>Im Besonderen ist <application>gPDFText</application> nicht in der Lage, Text aus PDF-Dateien zu extrahieren, der in Tabellen oder in Nicht-Absatzformat dargestellt wird.</para>
	</sect2>
	<sect2 id="future">
		<title>Geplante Erweiterungen in der Zukunft</title>
		<para>Andere eBook-Formate werden vielleicht irgendwann auch einmal unterstützt. Das ist in erster Linie davon abhängig, ob es freie Software gibt, die diese Formate unterstützt.</para>
		<para>So etwas wie Suchen/Ersetzen wäre für den Editor auch sinnvoll, mehr als nur das standardmäßige Suchen und Weitersuchen. Eine Rechtschreibprüfung könnte auch dabei helfen, Regionen zu finden, die nicht richtig importiert wurden.</para>
	</sect2>
</sect1>

<!-- ============= About ================================== -->
<!-- This section contains info about the program (not docs), such as
      author's name(s), web page, license, feedback address. This
      section is optional: primary place for this info is "About.." box of
      the program. However, if you do wish to include this info in the
      manual, this is the place to put it. Alternatively, you can put this
      information in the title page.-->

<sect1 id="gpdftext-about">
	<title>Über <application>gPDFText</application></title>
	<para><application>gPDFText</application> wurde von Neil Williams (<email>linux@codehelp.co.uk</email>) geschrieben. Für weitere Informationen über <application>gPDFText</application>, besuchen Sie bitte das <ulink url="http://sourceforge.net/apps/mediawiki/gpdftext/" type="http">gPDFText-Wiki</ulink>.</para>
	<para>Bitte benutzen Sie die Debian-Fehlerdatenbank oder das Ticket-System Trac, um Fehler zu melden. </para>
	<para><ulink url="http://bugs.debian.org/gpdftext" type="http">Debian BTS</ulink> (E-Mail-basiert, kein Login nötig) oder <ulink url="http://sourceforge.net/apps/trac/gpdftext/newticket" type="http">SourceForge Trac Tickets</ulink> (hierfür müssen Sie sich bei SourceForge einloggen).</para>
	<para>This program is distributed under the terms of the GNU General Public license as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version. A copy of this license can be found at this <ulink url="ghelp:gpl" type="help">link</ulink>, or in the file COPYING included with the source code of this program.</para>
</sect1>
</article>