<?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="ru">

<articleinfo>
	<title>Руководство к gPDFText</title>
	<date>2009-12-27</date>
	<copyright>
		<year>2009</year>
		<holder>Нил Вильямс (Neil Williams)</holder>
 	</copyright><copyright><year>2009</year><holder>Юрий Козлов (yuray@komyakino.ru)</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>Руководство пользователя к ebook PDF редактору gPDFText.</para>
	</abstract>
	<authorgroup>
		<author role="maintainer">
			<firstname>Нил</firstname>
			<surname>Вильямс</surname>
			<affiliation>
				<orgname>Команда разработчиков 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>Введение</title>
	<para><command><application>gPDFText</application></command> -- это текстовый редактор для файлов ebook PDF, написанный с использованием библиотеки GTK+.</para>
	<para><application>gPDFText</application> позволяет загружать текст из файла ebook PDF и восстанавливать его в более удобном виде.</para>
	<para>Во множестве скачиваемых файлов PDF для устройств чтения электронных книг (ebook readers) всё ещё используется формат бумаги A4 (или letter, подобного размера), и когда PDF отображается устройством, выполняется масштабирование к размеру экрана, что делает текст слишком маленьким для чтения. Простой экспорт PDF в текст вызывает проблемы с переносом строк, а различные способы задания колонтитулов в ebook PDF усложняют автоматическое преобразование.</para>
	<para><command><application>gPDFText</application></command> загружает PDF, извлекает текст, переформатирует абзацы в отдельные длинные строки и помещает текст в стандартный редактор GTK+, где вы можете сделать другие преобразования.</para>
	<para>На устройстве чтения книг полученный текстовый файл не содержит нежелательных переносов строк, а размер текста можно масштабировать до нужного размера.</para>
	<para>Каждый параметр переформатирования может быть выключен в диалоге настроек <application>gPDFText</application>. Смотрите раздел об <link linkend="regexps">изменении регулярных выражений</link>.</para>
	<para>Поддержка орфографии позволяет найти области, где может понадобиться дальнейшее редактировании или где в извлечённом тексте остались заголовки страниц.</para>
	<para>Извлечённый и отредактированный текст может быть сохранён в новый файл PDF на основе текста с более подходящем размером бумаги (A5 или B5) для того, чтобы устройство чтения книг смогло отобразить страницу целиком и удобно масштабировало. После сохранения PDF можно обновлять из редактора.</para>
	<para>Любой текстовый файл также можно открыть и сохранить в PDF; тем не менее файлы, передаваемые <application>gPDFText</application> параметром командной строки, должны быть PDF.</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>Начало</title>
	<para>Вы можете запустить <application>gPDFText</application> следующими способами: <variablelist>
			<varlistentry>
				<term>Меню <guimenu>Приложения</guimenu></term>
				<listitem>
				<para>Выберите <menuchoice><guisubmenu>Стандартные</guisubmenu><guimenuitem>Редактор ebook gPDFText</guimenuitem></menuchoice>.</para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term>Командная строка</term>
				<listitem>
				<para>Введите <command>gpdftext</command>, а затем нажмите <keycap>Return</keycap>.</para>
				<para>В данный момент параметры командной строки не поддерживаются.</para>
				<para>Файлы PDF, указанные в командной строке, будут открыты с помощью <command><application>gPDFText</application></command>.</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>Использование</title>
	<para>
	</para>
	<sect2 id="editor-window">
		<title>Работа в окне редактора gPDFText</title>
		<para>В <application>gPDFText</application> встроен редактор с проверкой орфографии.</para>
		<sect3 id="editor-window-spelling">
			<title>Проверка орфографии</title>
			<para>Чтобы включить встроенную проверку орфографии выберите в меню <menuchoice><guisubmenu>Вид</guisubmenu><guimenuitem>Проверка орфографии</guimenuitem></menuchoice>. Неправильно написанные слова подчёркиваются красной волнистой линией. Если нажать по такому слову правой клавишей мыши, то появится меню с подменю <guimenuitem>Spelling Suggestions</guimenuitem>. Нажатие на предлагаемое слово заменит неправильно написанное слово.</para>
			<para>Для быстрого включения и выключения проверки орфографии нажмите клавишу <emphasis>F7</emphasis>.</para>
		</sect3>
	</sect2>
	<sect2 id="undo-redo">
		<title>Отмена и Повтор</title>
		<para>Для отмены редактирования нажмите <emphasis>Ctrl-Z</emphasis>,а для возврата изменений нажмите <emphasis>Shift-Ctrl-Z</emphasis>.</para>
	</sect2>
	<sect2 id="savingfiles">
	<title>Сохранение файлов</title>
	<para><application>gPDFText</application> позволяет сохранять текст в виде текста ASCII или изменённого PDF.</para>
	</sect2>
</sect1>

<!-- ============= Customization ============================= -->
<!-- Use this section to describe how to customize the application. -->
<sect1 id="regexps">
	<title>Выбор регулярных выражений</title>
		<para>Настройки помогают подогнать работу <application>gPDFText</application> под определённый PDF-файл. Для вывода диалога настроек выберите <menuchoice><guisubmenu>Правка</guisubmenu><guimenuitem>Параметры</guimenuitem></menuchoice> или нажмите кнопку параметров на панели инструментов.</para>
	<para><application>gPDFText</application> выполняет три типа изменений над извлечённым текстом из файла ebook PDF, которые пользователь может отключить, в зависимости от того, как был создан файл PDF.</para>
	<sect2 id="longlines">
		<title>Поддержка длинных строк.</title>
		<para>Большинство пользователей оставят эту настройку; она позволяет объединить отдельные строки в первоначальный абзац для того, чтобы устройство чтения смогло правильно отформатировать длинные строки.</para>
		<programlisting>
		Иначе текст вашего рассказа
		будет выглядеть как здесь
		, хотя на самом деле это должен быть один абзац.
		</programlisting>
	</sect2>
	<sect2 id="hyphens">
		<title>Слияние слов с переносом.</title>
		<para>Большинство пользователей оставят эту настройку; она позволяет объединить слова, в которых есть символ переноса, иначе такие слова могут оказаться в неизменном виде в середине строки.</para>
		<programlisting>
		Иначе текст вашего рассказа будет выгля- деть как
		здесь, хотя должно быть слитное слово.
		</programlisting>
	</sect2>
	<sect2 id="pagenum">
		<title>Удаление колонтитулов с номерами страниц.</title>
		<para>С помощью используемого метода могут быть удалены только простейшие колонтитулы с номерами страниц. Если в колонтитуле страниц PDF содержится название книги, главы или что-то ещё (например, реклама, откуда скачан файл), то вам придётся удалить такие колонтитулы вручную.</para>
		<para>В некоторых случаях, шаблон номера страницы (пробел, числа и конец строки) может вызвать проблемы с некоторыми книгами. <application>gPDFText</application> может пропускать целые страницы из PDF, поэтому выключите эту настройку и откройте PDF заново.</para>
	</sect2>
</sect1>

<!-- ============= Customization ============================= -->
<!-- Use this section to describe how to customize the application. -->
<sect1 id="pdfgenerate">
	<title>Параметры для работы с файлами PDF</title>
	<sect2 id="paper-sizes">
		<title>Выбор размера бумаги для PDF</title>
		<para>Файлы ebook обычно легко читать, если сократить размер бумаги в PDF с оригинального A4. A4 останется в качестве параметра для других файлов PDF.</para>
		<para>Размеры бумаги используют соотношение 0.7:1 и вот поэтому <application>gPDFText</application> имеет слегка необычный размер основного окна по умолчанию.</para>
		<para>A4 210 x 297мм 8.3 x 11.7 дюймов</para>
		<para>A5 148 × 210мм 5.8 x 8.3 дюймов</para>
		<para>B5 176 × 250мм 6.9 x 9.8 дюймов</para>
		<para>См. также: <ulink url="http://www.cl.cam.ac.uk/~mgk25/iso-paper.html"> http://www.cl.cam.ac.uk/~mgk25/iso-paper.html</ulink> и <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>Выбор шрифта</title>
		<para>Шрифт, выбранный для редактора, также используется (того же размера) в создаваемом PDF. Это приближает нас к WYSIWYG редактированию PDF. (WYSIWYG - Что видишь, то и получишь.)</para>
	</sect2>
</sect1>

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

<sect1 id="gpdftext-faq">
	<title>Часто задаваемые вопросы</title>
	<sect2 id="opening-pdf">
		<title>Создание файлов PDF на основе текста для других целей</title>
		<para>Создание файлов PDF на основе текста в <application>gPDFText</application> не всегда гарантирует, что в выходном PDF получится текстовое содержимое, когда PDF открывается <application>gPDFText</application> -- это зависит от типа текстового содержимого.</para>
		<para>Если текстовое содержимое -- рассказ или роман, то об этом нужно сообщить как об ошибке. Если текстовое содержимое представляет собой другой типа текстового файла (например, исходный код или другой файл подобного строгого формата),то оригинальный файл нужно открыть повторно, вместо извлечения его из PDF.</para>
		<para>В частности, <application>gPDFText</application> не позволяет извлекать текст из файлов PDF, где текст размещён в таблицах или не в виде параграфов.</para>
	</sect2>
	<sect2 id="future">
		<title>Будущие улучшения</title>
		<para>Может быть добавлена поддержка других форматов ebook, в зависимости от того, есть ли для них свободное ПО для чтения.</para>
		<para>Также, в редакторе нужны поиск и замена, обладающие большими возможностями чем обычные Найти и Найти далее. Проверка орфографии также могла бы помочь в нахождении областей, где текст не был полностью восстановлен.</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>О <application>gPDFText</application></title>
	<para>Программа <application>gPDFText</application> написана Нилом Вильямсом (Neil Williams) (<email>linux@codehelp.co.uk</email>). Дополнительную информацию о <application>gPDFText</application> можно найти в <ulink url="http://sourceforge.net/apps/mediawiki/gpdftext/" type="http">вики gPDFText</ulink>.</para>
	<para>Для отправки сообщений об ошибках используйте систему отслеживания ошибок Debian или Trac автора программы.</para>
	<para><ulink url="http://bugs.debian.org/gpdftext" type="http">Debian BTS</ulink> (на основе эл.почты, не требует регистрации) или <ulink url="http://sourceforge.net/apps/trac/gpdftext/newticket" type="http"> SourceForge Trac tickets</ulink> (требуется регистрация в SF).</para>
	<para>Эта программа распространяется на условиях Стандартной Общественной Лицензии GNU, опубликованной Фондом Свободного Программного Обеспечения, версии 3 или (по вашему выбору) любой более поздней. Копию данной лицензии можно найти <ulink url="ghelp:gpl" type="help">по ссылке</ulink>, или в файле COPYING, включённом в исходный код данной программы.</para>
</sect1>
</article>