<?xml version="1.0" ?>
<!--
  SPDX-FileCopyrightText: 2015 Andreas Cord-Lsandwehr <cordlandwehr@kde.org>
  SPDX-License-Identifier: CC-BY-SA-4.0
-->

<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [

  <!ENTITY artikulate "Artikulate">
  <!ENTITY kappname "&artikulate;">
  <!ENTITY package "artikulate">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Russian "INCLUDE">
]>
<book id="artikulate" lang="&language;">

<bookinfo>
<title
>Руководство пользователя &artikulate;</title>
<authorgroup>
<author
><personname
> <firstname
>Andreas</firstname
> <surname
>Cord-Landwehr</surname
> </personname
> <email
>cordlandwehr@kde.org</email
> </author>

<author
><personname
> <firstname
>Ondrila</firstname
> <surname
>Gupta</surname
> </personname
> <email
>oindrila.gupta92@gmail.com</email
> </author>

<othercredit role="translator"
><firstname
>Олеся</firstname
><surname
>Герасименко</surname
><affiliation
><address
><email
>goa@altlinux.org</email
></address
></affiliation
><contrib
>Перевод на русский язык</contrib
></othercredit
> 
</authorgroup>

<copyright
><year
>2014-2015</year
><holder
>Разработчики &artikulate;</holder
></copyright>

<date
>27 сентября 2015 г.</date>
<releaseinfo
>&artikulate; 0.6.0 (Приложения KDE 15.12)</releaseinfo>

<legalnotice
>&FDLNotice;</legalnotice>

<abstract>
<para
>&artikulate; — программа для тренировки произношения, позволяющая развить и усовершенствовать соответствующие навыки. Тренировка ведётся путём записи голоса пользователя и последующего сравнения полученной записи с произношением носителя языка. &artikulate; входит в состав образовательного пакета &kde;. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeedu</keyword>
<keyword
>language;язык</keyword>
<keyword
>course;курс</keyword>
<keyword
>unit;модуль</keyword>
<keyword
>phrase;фраза</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Введение</title>
<para
>&artikulate; — тренажёр для развития и совершенствования навыков произношения на неродном языке.  &artikulate; содержит курсы, созданные носителями языка; они записали свои голоса в качестве эталонного материала. Эти записи (курсы) можно загрузить из Интернета. Для тренировки применяется следующий цикл: воспроизводится сделанная носителем языка запись какой-либо фразы, записывается голос самого пользователя, а затем эти записи сравниваются, пока результат не станет достаточно хорошим для перехода к следующей фразе. </para>

<sect1 id="introduction-concept">
<title
>Концепция обучения</title>
<para
>Используемая в &artikulate; концепция обучения основывается на честной оценке пользователем своих навыков. За одну тренировку отрабатывается произношение нескольких фраз. Для каждой из них пользователь сначала воспроизводит сделанную носителем языка запись, а затем повторяет прозвучавшую фразу, при этом записывая свой голос. Далее пользователь сравнивает получившуюся запись с эталоном и решает, следует ли продолжить отработку произношения. Входящие в состав программы курсы позволяют как освоить определённые сценарии (например, заказ еды в ресторане), так и сосредоточиться на правильном произношении сложных слогов и слов конкретного языка. </para>
</sect1>

<sect1 id="introduction-first-steps">
<title
>Первые шаги в &artikulate;</title>
<para
>В этом разделе объясняется, как начать работу с &artikulate;. </para>

<sect2>
<title
>1. Загрузка нового курса</title>
<para
>Для загрузки курсов воспользуйтесь пунктом меню <menuchoice
><guimenu
>Файл</guimenu
> <guimenuitem
>Загрузить курсы</guimenuitem
></menuchoice
>. Если строка меню неактивна, меню <menuchoice
><guimenu
>Файл</guimenu
></menuchoice
> можно открыть щелчком по верхней правой кнопке. Появится окно загрузки со списком доступных языков, предоставленных сообществом пользователей &kde;. Этот список можно упорядочить (в правой части окна есть опции сортировки). Для выполнения загрузки нужно нажать кнопку <guilabel
>Установить</guilabel
>. </para>
<screenshot>
<screeninfo
>Загрузка курса.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="first-steps-3-download-course.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>
</sect2>

<sect2>
<title
>2. Начало тренировки</title>
<para
>Курсы состоят из нескольких обучающих модулей, в каждом из которых фразы обычно подобраны в соответствии с каким-либо сценарием. Курсы можно переключать с помощью раскрывающихся списков для выбора языка и курса (в верхней части окна). </para>
<screenshot>
<screeninfo
>Выбор модуля и начало тренировки.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="first-steps-4-start-training.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>
</sect2>

<sect2>
<title
>Завершение тренировки</title>
<para
>Тренировку можно завершить в любой момент — просто закройте программу. </para>
</sect2>
</sect1>
</chapter>

<!--
<chapter id="screens">
<title
>Screens</title>
<sect1 id="screens-training">
<title
>The Training Screen</title>
<para>
The training view is the most important view in &artikulate;.
Whenever starting a training, this view is opened and will be presented until the training of the selected training unit is finished or the student stops the training.
In the center of this screen, there are controls for playing a native speaker recording, the text of the corresponding phrase, and controls to record and playback the student's own voice.
When a student judges to be done with training the pronunciation of the current phrase, by clicking <guilabel
>OK</guilabel
> the current phrase is marked as done and a next phrase is selected.
Otherwise, when clicking on <guilabel
>Retry Later</guilabel
>, a next phrase is selected but the current phrase will be displayed later again.
</para>

<para>
For training the pronunciation of a current phrase, the student shall first play the native speaker's recording by pressing at the <guilabel
>Playback</guilabel
> button at the left.
The next step is to press on the <guilabel
>Record</guilabel
> button and read the presented phrase aloud.
A further press on the <guilabel
>Record</guilabel
> button stops the recording and the recording can then be played with the corresponding <guilabel
>Playback</guilabel
> button.
By listening to both recordings, the student shall judge if the phrase was pronounced correctly or not.
If it was pronounced correctly, clicking on <guilabel
>OK</guilabel
> marks the phrase as learned and proceeds with the next phrase.
Otherwise, if not yet satisfied with the recording, the student either can retry recording by again clicking on <guilabel
>Record</guilabel
> or schedule the phrase for later training by clicking on <guilabel
>Retry Later</guilabel
>.
</para>

<para>
&artikulate;'s units are composed of a list of phrases of different lengths (words, expressions, sentences, and paragraphs).
A student can see the current learning progress at the bottom when looking at <link linkend="screens-training-progressbar"
>the progress bar</link
>.
The progress bar also allows switching between phrases.
</para>

<para>
At any time, the student can choose to stop training by clicking at the <guilabel
>Finish</guilabel
> button.
</para>

<screenshot>
<screeninfo
>The Training Screen.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="screen-training-overview.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Screenshot of the Training Screen.</phrase>
</textobject>
</mediaobject>
</screenshot>

<sect2 id="screens-training-sound-controls">
<title
>Sound Controls</title>
<itemizedlist>
<listitem
><para>
<inlinemediaobject
><imageobject>
<imagedata fileref="hi32-action-artikulate-media-record.png" format="PNG"/></imageobject>
</inlinemediaobject>
<guilabel
>Record</guilabel
>: Record your pronunciation through your microphone. Click again to stop recording.
</para
></listitem>

<listitem
><para>
<inlinemediaobject
><imageobject>
<imagedata fileref="hi32-action-artikulate-media-playback-start.png" format="PNG"/></imageobject>
</inlinemediaobject>
<guilabel
>Playback</guilabel
>: Play a sound file. If active, click again to stop.
</para
></listitem>

</itemizedlist>
</sect2>

<sect2 id="screens-training-learning-controls">
<title
>Learning Controls</title>
<itemizedlist>
<listitem
><para>
<inlinemediaobject
><imageobject>
<imagedata fileref="training-ok.png" format="PNG"/></imageobject>
</inlinemediaobject>
<guilabel
>OK</guilabel
>: Mark current phrase as learned and continue with next phrase.
</para
></listitem>

<listitem
><para>
<inlinemediaobject
><imageobject>
<imagedata fileref="training-retry.png" format="PNG"/></imageobject>
</inlinemediaobject>
<guilabel
>Retry Later</guilabel
>: Continue with training next phrase, but try this phrase later again.
</para
></listitem>

<listitem
><para>
<inlinemediaobject
><imageobject>
<imagedata fileref="training-finish.png" format="PNG"/></imageobject>
</inlinemediaobject>
<guilabel
>Stop</guilabel
>: Stops the training and proceeds to the statistics view. Current training results are saved to training statistics.
</para
></listitem>
</itemizedlist>
</sect2>

<sect2 id="screens-training-progressbar">
<title
>Progress Bar</title>
<para>
The progress bar displays the learning progress for the current unit.
It consists of blocks representing the phrases in the current unit, whereas the color of a block explains the length of the phrase.
You can hover over these blocks to see the phrases and click on them to switch the currently trained phrase.
Dark elements are already trained, light ones are untrained.
</para>
<screenshot>
<screeninfo
>Progress Bar</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="screen-training-progressbar.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>The progress bar for the current unit.</phrase>
</textobject>
</mediaobject>
</screenshot>
<para>
On top of the progress bar you can see which type of phrases you are currently learning.
The available types are:
<itemizedlist>
    <listitem
><para
>word: a single word, letter, or number</para
></listitem>
    <listitem
><para
>expression: an expression of several words that does not form a complete sentence</para
></listitem>
    <listitem
><para
>sentence: a complete sentence</para
></listitem>
    <listitem
><para
>paragraph: several sentences (usually 2-3) </para
></listitem>
</itemizedlist>
</para>
</sect2>
</sect1>
</chapter>
-->
<chapter>
<title
>Редактор</title>
<para
>Встроенный редактор курсов обладает широкими функциональными возможностями и позволяет разработчикам создавать языковые курсы для &artikulate; и вести совместную работу над ними. С одной стороны, редактор поддерживает запись звуковых файлов носителями языка. С другой стороны, он даёт возможность работать над так называемыми <emphasis
>заготовками</emphasis
> (прототипами языковых курсов, на основе которых можно легко и быстро создавать новые курсы). В редакторе можно изменять только те файлы, которые не входят в набор обучающих курсов (то есть набор курсов, загруженных в &artikulate;). </para>

<sect1>
<title
>Обзор</title>

<sect2>
<title
>Терминология редактора</title>
<para
>В редакторе курсов используется особый набор терминов. Он также задействован в следующих описаниях. </para>
<variablelist>
<varlistentry>
    <term
>Язык:</term>
    <listitem>
    <para
>В &artikulate; доступны только те языки, которые указаны с помощью языковых спецификаций. </para>
    </listitem>
</varlistentry>
<varlistentry>
    <term
>Курс:</term>
    <listitem>
    <para
>Курс связан с каким-либо одним языком и содержит ряд модулей. </para>
    </listitem>
</varlistentry>
<varlistentry>
    <term
>Модуль:</term>
    <listitem>
    <para
>Модуль состоит из фраз, которые объединены какой-либо темой. Например, это могут быть фразы, которые используются в ресторане, или фразы из уличного разговора туриста, выясняющего дорогу. </para>
    </listitem>
</varlistentry>
<varlistentry>
    <term
>Заготовки курсов:</term>
    <listitem>
    <para
>Заготовка курса формирует основу курса. Она помогает создавать курсы на нескольких языках, так как задаёт набор модулей и фраз (на английском), которые затем можно использовать в качестве шаблона для создания курса на другом языке. Обновления заготовок курсов также можно импортировать в курсы, созданные на основе заготовки. </para>
    </listitem>
</varlistentry>
<varlistentry>
    <term
>Фразы:</term>
    <listitem>
    <para
>Фразы предоставляются в виде текстовой строки и сделанной носителем языка записи. В программе фразы подразделяются по длине. Далее приводятся существующие варианты длины фраз. <itemizedlist>
        <listitem>
        <para
><inlinemediaobject
><imageobject>
        <imagedata fileref="hi32-action-artikulate-word.png" format="PNG"/></imageobject
></inlinemediaobject
> слово: одно слово, буква или цифра</para>
        </listitem>
        <listitem>
        <para
><inlinemediaobject
><imageobject>
        <imagedata fileref="hi32-action-artikulate-expression.png" format="PNG"/></imageobject
></inlinemediaobject
> выражение: выражение из нескольких слов, не формирующее полное предложение</para>
        </listitem>
        <listitem>
        <para
><inlinemediaobject
><imageobject>
        <imagedata fileref="hi32-action-artikulate-sentence.png" format="PNG"/></imageobject
></inlinemediaobject
> предложение: полное предложение</para>
        </listitem>
        <listitem>
        <para
><inlinemediaobject
><imageobject>
        <imagedata fileref="hi32-action-artikulate-paragraph.png" format="PNG"/></imageobject
></inlinemediaobject
> абзац: несколько предложений (обычно 2-3)</para>
        </listitem>
        </itemizedlist>
    </para>
    </listitem>
</varlistentry>
</variablelist>
<para
>Курс связан с определённым языком и состоит из ряда модулей. Каждый модуль представляет собой последовательность фраз различной длины. </para>
</sect2>

<sect2>
<title
>Выбор папки хранилища курсов</title>
<para
>Редактор работает внутри отдельной папки (далее — <emphasis
>хранилище</emphasis
>, так как для этой папки рекомендуется использовать какую-либо систему управления версиями). Там редактор выполняет поиск доступных для редактирования курсов и файлов заготовок, а также сохраняет новые файлы. </para>
<para
>Хранилище курсов можно указать в диалоге настройки. Чтобы его открыть, воспользуйтесь пунктом меню <menuchoice
><guimenu
>Настройка</guimenu
> <guimenuitem
>Настроить &artikulate;</guimenuitem
></menuchoice
> (параметры курсов доступны при выборе опции <guilabel
>Ресурсы курсов</guilabel
>). </para>
<screenshot>
<screeninfo
>Выбор хранилища курсов для редактора.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="editor-set-repository.png" format="PNG"/>
</imageobject>
<caption
><para
>Выбор хранилища курсов для редактора.</para
></caption>
</mediaobject>
</screenshot>
</sect2>
</sect1>

<!--<sect1
>TODO needs complete rewrite
<title
>Edit a Course</title>
<para>
The editor can be started from the main menu with <menuchoice
><guimenu
>Mode</guimenu
> <guimenuitem
>Course Editor mode</guimenuitem
></menuchoice
>.
There you have the options to work on existing skeleton files or to create new courses or edit existing ones.
After selecting a language, you can open an existing course to edit it, or otherwise use <guilabel
>New Course</guilabel
> to create a new course for this language.
In either case, you will be presented the list of units of the course, where you can create new units or open existing ones for edit.
</para>

<sect2>
<title
>Edit a Unit</title>
<para>
When opening a unit for editing, you will see the list of its phrases (see below).
One line of this list contains the following information:
<orderedlist>
    <listitem
><para
>edit button: open this phrase for edit</para
></listitem>
    <listitem
><para
>phrase type: icon that denotes the type of this phrase (e.g., word, expression)</para
></listitem>
    <listitem
><para
>edit state: a colored block that denotes the edit state of this phrase (red: unknown/no state set; orange: translated state; green: completed state)</para
></listitem>
    <listitem
><para
>the phrase</para
></listitem>
    <listitem
><para
>exclude button: if course derives from a course skeleton, this button allows excluding the phrase from the unit</para
></listitem>
</orderedlist>
</para>
<screenshot>
<screeninfo
>Editor View: list of phrases within a unit.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="editor-screenshot-unit.png" format="PNG"/>
</imageobject>
<caption
><para
>Editor View: list of phrases within a unit.</para
></caption>
</mediaobject>
</screenshot>
</sect2>

<sect2>
<title
>Edit a Phrase</title>
<para>
When opening a phrase for editing, you will see the phrase editor as shown below.
This edit interface contains the following elements:
</para>
<itemizedlist>
    <listitem
><para
>the phrase text as it will be shown in the trainer</para
></listitem>
    <listitem
><para
>the original phrase, if using a course skeleton</para
></listitem>
    <listitem
><para
>the edit state of the phrase</para
></listitem>
    <listitem
><para
>the type/length of the phrase</para
></listitem>
    <listitem
><para
>recording buttons for the native speaker recordings</para
></listitem>
    <listitem
><para
>buttons to denote interesting phonemes of the phrase (currently not used in training mode)</para
></listitem>
</itemizedlist>
<para>
You can close the phrase editing interface with
<inlinemediaobject
><imageobject>
<imagedata fileref="editor-apply.png" format="PNG"/></imageobject>
</inlinemediaobject>
to accept the changes you did, or with
<inlinemediaobject
><imageobject>
<imagedata fileref="editor-cancel.png" format="PNG"/></imageobject>
</inlinemediaobject>
to discard your changes.
</para>
<screenshot>
<screeninfo
>Editor View: editing view for a phrase.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="editor-screenshot-editing-phrase.png" format="PNG"/>
</imageobject>
<caption
><para
>Editor View: editing view for a phrase.</para
></caption>
</mediaobject>
</screenshot>
</sect2>

<sect2>
<title
>Update from Course Prototype</title>
<para>
If the currently edited course derives from a skeleton, then the course can be updated from the latest version of the skeleton by using the button <guilabel
>Update from Course Prototype</guilabel
> at the top left of the screen.
This button is deactivated if the course is not derived from a course skeleton.
</para>
</sect2>
</sect1
>-->
</chapter>


<chapter id="credits">
<title
>Авторские права и лицензия</title>

<para
>&artikulate; </para>
<para
>Авторские права на программу:</para>
<itemizedlist>
    <listitem
><para
>© Andreas Cord-Landwehr, 2013–2015</para
></listitem>
    <listitem
><para
>© Oindrila Gupta, 2013</para
></listitem>
    <listitem
><para
>© Magdalena Konkiewitz, 2013</para
></listitem>
    <listitem
><para
>© Samikshan Bairagya, 2013–2014</para
></listitem>
</itemizedlist>

<para
>Авторские права на документацию:</para>
<itemizedlist>
    <listitem
><para
>© Andreas Cord-Landwehr, 2014–2015</para
></listitem>
</itemizedlist>

<para
>Олеся Герасименко<email
>goa@altlinux.org</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:
-->
