<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kapp "&klatin;"
><!-- replace klatin here -->
  <!ENTITY kappname "&klatin;">
  <!ENTITY package "kdeedu">
  <!ENTITY kwordquiz "<application
>KWordQuiz</application
>">
  <!ENTITY kvtml "<acronym
>KVTML</acronym
>">
  <!--<!ENTITY klatin-index SYSTEM "klatin-index.docbook"
>-->
  <!ENTITY numbers SYSTEM "numbers.docbook">
  <!ENTITY verbs SYSTEM "verbs.docbook">
  <!ENTITY adjectives SYSTEM "adjectives.docbook">
  <!ENTITY nouns SYSTEM "nouns.docbook">
  <!ENTITY pronouns SYSTEM "pronouns.docbook">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Russian "INCLUDE"
><!-- change language only here -->
]>

<book lang="&language;">

<bookinfo>
<title
>Справочник по &klatin;</title>

<authorgroup>
<author
><firstname
>George</firstname
> <surname
>Wright</surname
> <affiliation
> <address
><email
>gwright@users.sourceforge.net</email
></address>
</affiliation>
</author>
<othercredit role="developer"
><firstname
>Anne-Marie</firstname
> <surname
>Mahfouf</surname
> <affiliation
> <address
><email
>annma@kde.org</email
></address>
</affiliation>
<contrib
>Помощь при написании документации</contrib>
</othercredit>
</authorgroup>

<othercredit role="translator"
> <firstname
>Константин</firstname
><surname
>Карпов</surname
><affiliation
><address
><email
>constantine_2001@mail.ru</email
></address
></affiliation
><contrib
>Перевод на русский</contrib
></othercredit
><othercredit role="translator"
> <firstname
>Максим</firstname
><surname
>Кузьмин</surname
><affiliation
><address
><email
>kuzya@isnet.ru</email
></address
></affiliation
><contrib
>Перевод на русский</contrib
></othercredit
> 

<copyright>
<year
>2001-2004</year>
<holder
>George Wright</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2004-08-23</date>
<releaseinfo
>0.9</releaseinfo>

<abstract>
<para
>&klatin; - это приложение, которое поможет вам в повторении или изучении латинского языка. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeedu</keyword>
<keyword
>KLatin</keyword>
<keyword
>Латинский</keyword>
<keyword
>обучение</keyword>
<keyword
>язык</keyword>
<keyword
>латинский</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Введение</title>

<para
>&klatin; - это программа, которая поможет вам проверить свои знания латинского языка. В программе имеется 3 раздела для проверки ваших знаний с разных сторон. Эти разделы следующие: лексика, грамматика и формы глаголов. Также в проограмме представлены дополнительные сведения для самопроверки. </para>
<para
>В разделе Лексики загружается файл в формате &XML; , содержащий различные слова и их перевод. Требуется определить как переводится каждое из слов. Для ответов предлагается несколько вариантов. </para>
<para
>В разделах Грамматика и Глаголы &klatin; спрашивает о конкретной части существительного или о форме глагола, как ,например, <quote
>творительный падеж, единственное число</quote
>, или <quote
>1е лицо, изъяв.наклонение, множ.число</quote
>, не предлагая множественного выбора. </para>
</chapter>

<chapter id="using-klatin">
<title
>Использование &klatin;</title>

<para
>После запуска &klatin; вам предоставляется четыре опции на выбор. </para>

<screenshot>
<screeninfo
>Главное окно &klatin; при первом запуске</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="klatin1.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Главное окно &klatin;</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Первый, <guilabel
>Лексика</guilabel
> это тест на знание лексики, где вам необходимо выбрать из нескольких возможных вариантов ответов правильный. </para>

<screenshot>
<screeninfo
>словарь &klatin;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="klatin2.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Словарь &klatin;</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>После окончания теста, результаты будут выведены на экран. </para>

<screenshot>
<screeninfo
>Таблица результатов &klatin;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="results.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Таблица результатов &klatin;</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Второй, <guilabel
>Грамматика</guilabel
> тестирует вас на знание грамматических форм существительных. </para>
 
<screenshot>
<screeninfo
>Грамматика</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="klatin3.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Грамматика</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
><guilabel
>Глаголы</guilabel
> практически такой же раздел как и <guilabel
>Грамматика</guilabel
>, но проверяет ваше знание форм глаголов. </para>

<screenshot>
<screeninfo
>Глаголы</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="klatin4.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Глаголы</phrase>
</textobject>
</mediaobject>
</screenshot
> 
 
<para
>Четвертый раздел, <guilabel
>Обучение</guilabel
>, загружает &konqueror; раздел обучения в &klatin; </para>

<para
>Также, перейти к нужному разделу вы можете используя меню <quote
>Раздел</quote
>. </para>

<para
>С помощью пункта меню <quote
>Настройки</quote
> и подпункта меню <quote
>Настроить &klatin; ...</quote
> вы можете открыть Диалог конфигурации &klatin;. На странице <quote
>Словарь</quote
>, вы можете указать, хотите ли вы переводить с вашего языка на Латынь или наоборот. Также вы можете выбрать файл, который вы хотите использовать по умолчанию для проверки лексики, и еще вы можете установить на сколько вопросов вы хотите ответить. </para>

</chapter>

<chapter id="klatin-mainwindow">
<title
>Главное окно &klatin;</title>
<para
>Главное окно  &klatin; состоит из четырёх кнопок, предназначеных для выбора раздела, и строки меню.</para>
<para
>Выберите из списка <guilabel
>Обучение</guilabel
> раздел и нажмите <guibutton
>Начать!</guibutton
> чтобы запустить его.</para>
 
<para
>Когда вы закончите работать с этим разделом, нажмите <guibutton
>Назад</guibutton
>, чтобы вернуться в главное меню &klatin;</para>

</chapter>

<chapter id="commands">
<title
>Справочник по меню и командам</title>
<sect1 id="menu-file">
<title
>Меню <guimenu
>Файл</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Файл</guimenu
> <guimenuitem
>Выход</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Выход из</action
> &klatin;</para
></listitem>
</varlistentry>
</variablelist>
</sect1>

<sect1 id="menu-section">
<title
>Меню <guimenu
>Раздел</guimenu
></title>
<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Раздел</guimenu
> <guimenuitem
>Загрузить словарь</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Загружает</action
> новый словарь. Это меню доступно только в разделе Лексика</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Раздел</guimenu
> <guimenuitem
>Загрузить словарь</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Загружает</action
> раздел лексики</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Раздел</guimenu
> <guimenuitem
>Загрузить раздел грамматики</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Загружает</action
> раздел грамматики</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Раздел</guimenu
> <guimenuitem
>Загрузить раздел глаголов</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Загружает</action
> раздел глаголов</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Раздел</guimenu
> <guimenuitem
>Загрузить обучение</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Загружает</action
> раздел обучения</para
></listitem>
</varlistentry>


</variablelist>

</sect1>
<sect1 id="menu-settings">
<title
>Меню <guimenu
>Настройки</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Настройки</guimenu
> <guimenuitem
>Настроить комбинации клавиш...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Настройка</action
> клавиш для доступа к различным действиям.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Настройки</guimenu
> <guimenuitem
>Настроить &klatin;...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Открывает</action
> диалог настроек </para
></listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="menu-help">
<title
>Меню <guimenu
>Помощь</guimenu
></title>
&help.menu.documentation; </sect1>
</chapter>

<chapter id="translation">
<title
>Руководство переводчика &klatin;</title>

<para
>Для вашего языка необходимо перевести лишь файлы словарей. В них используется формат &kvtml;, который также используется в других программах, например, в &kwordquiz;. Программа &kwordquiz; очень полезна, поскольку вы можете создавать файлы словаря в ней и сразу загружать их в &klatin;. </para>
<para
>Ниже объясняется как можно перевести словари &klatin;. В настоящее время они доступны только на английском языке. </para>
<sect1 id="translate_vocab">
<title
>Как перевести словари &klatin;</title>
<procedure>
<step>
<para
>Возмите последнюю версию кода &klatin; из CVS или последний релиз. Слова хранятся в <filename class="directory"
> корневая_директория_kdeedu/klatin/klatin/data/vocab/en/</filename
> в таких файлах как <filename
>A.kvtml</filename
> для латинских слов, начинающихся с A, <filename
>BC.kvtml</filename
> для латинских слов, начинающихся с B и C и так далее. </para>
</step>

<step>
<para
>Cсоздайте новую поддиректорию <filename class="directory"
>data/vocab/</filename
>, назовите ее кодом вашего языка (например, <filename class="directory"
>fr</filename
> для французского, <filename class="directory"
>ru</filename
> для русского). Скопируйте туда все файлы словарей и файл  <filename
>Makefile.am</filename
>. Отредактируйте <filename
>Makefile.am</filename
> и замените <quote
>en</quote
> кодом вашего языка. </para>
</step>

<step>
<para
>В <filename class="directory"
>data/vocab/<replaceable
>код_вашего_языка</replaceable
></filename
>, отредактируйте все файлы и переведите английские слова, &ie; которые находятся между тегами <sgmltag class="starttag"
>t</sgmltag
> и <sgmltag class="endtag"
>t</sgmltag
>. </para>
</step>
<step>
<para
>Поместите свои файлы в CVS или запакуйте их в tar-архив и перешлите George'у <email
>gwright@users.sourceforge.net</email
> или Anne-Marie <email
>annma@kde.org</email
>. </para>
</step>
</procedure>
</sect1>
</chapter>

<chapter id="developers">
<title
>Руководство разработчика &klatin;</title>
<sect1 id="add_files">
<title
>Создать новые словари</title>
<para
>Вы легко можете расширить словарь &klatin; . Просто взгляните на файлы и всё станет понятно! В них используется формат &kvtml;, который также используется в других программах, например, в &kwordquiz;. Программа &kwordquiz; очень полезна, поскольку вы можете создавать файлы словаря в ней и сразу загружать их в &klatin;. </para>
<para
>Вы можете сохранить ваши новые файлы в соответствующей папке, в зависимости от языка к которому они относятся в <filename class="directory"
>.kde/share/apps/klatin/data/vocab/<replaceable
>код_языка</replaceable
>/</filename
>. Например, английские файлы &kvtml; хранятся в папке <filename class="directory"
>en</filename
>, немецкие в <filename class="directory"
>de</filename
>, и так далее. Также вы можете послать мне свои файлы, чтобы я добавил их в следующий релиз &klatin;. </para>
</sect1>
<!-- FIXME: They will still need specifically outlining -->
</chapter>

<chapter id="credits">

<title
>Благодарности и лицензии</title>

<para
>&klatin; </para>
<para
>Программа &copy; 2001-2004 George Wright <email
>gwright@users.sourceforge.net</email
> </para>
<para
>Участники: <itemizedlist>

<listitem
><para
>Neil Stevens <email
>neil@qualityassistant.org</email
></para>
</listitem>
<listitem
><para
>Anne-Marie Mahfouf <email
>annma@kde.org</email
></para>
</listitem>
<listitem
><para
>Mark Westcott <email
>mark@houseoffish.org</email
></para>
</listitem>

</itemizedlist>
</para>

<para
>Документация &copy; 2001-2004 George Wright <email
>gwright@users.sourceforge.net</email
> </para>

<para
>Перевод на русский: Константин Карпов <email
>constantine_2001@mail.ru</email
>, Максим Кузьмин <email
>kuzya@isnet.ru</email
></para
> 
&underFDL; &underGPL; </chapter>

<chapter id="klatin-index">
<title
>Заметки &klatin;</title>

<para
>Этот раздел охватывает программу курса  GCSE и предназначен для того, чтобы помочь вам в обучении. </para>

<para
>Вы можете получить помощь по следующим разделам: </para>

<itemizedlist>
<listitem
><para
><link
linkend="numbers"
>Латинские числительные</link>
</para
></listitem>
<listitem
><para
><link
linkend="verbs"
>Латинские глаголы</link>
</para
></listitem>
<listitem
><para
><link
linkend="nouns"
>Латинские существительные</link>
</para
></listitem>
<listitem
><para
><link
linkend="adjectives"
>Латинские прилагательные</link>
</para
></listitem>
<listitem
><para
><link
linkend="pronouns"
>Латинские местоимения</link>
</para
></listitem>
</itemizedlist>
&numbers; &verbs; &nouns; &adjectives; &pronouns; </chapter>

<appendix id="installation">
<title
>Установка</title>

<sect1 id="getting-klatin">
<title
>Как получить &klatin;</title>
&install.intro.documentation; </sect1>

<sect1 id="compilation">
<title
>Компиляция и установка</title>
&install.compile.documentation; </sect1>

</appendix>

&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:
-->

