<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&noatun;">
  <!ENTITY package "kdemultimedia">
  <!ENTITY % Russian "INCLUDE"
> <!-- change language only here -->
  <!ENTITY % addindex "IGNORE">
]>

<book lang="&language;">
<bookinfo>
<title
>Справочное руководство по &noatun;</title>

<authorgroup>
<author
><firstname
>Charles</firstname
> <surname
>Samuels</surname
> <affiliation
> <address
><email
>charles@kde.org</email
></address>
</affiliation>
</author>
<othercredit role="translator"
><firstname
>Григорий</firstname
><surname
>Мохин</surname
><affiliation
><address
><email
>mok@kde.ru</email
></address
></affiliation
><contrib
>Перевод на русский</contrib
></othercredit
> 
</authorgroup>

<copyright>
<year
>2001</year
><year
>2002</year>
<holder
>Charles Samuels</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2002-03-01</date>
<releaseinfo
>2.00.00</releaseinfo
> <!-- Use App version here -->

<abstract>
<para
>&noatun; -  это полнофункциональный модульный медиаплеер для &kde;.</para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>Noatun</keyword>
<keyword
>kdemultimedia</keyword>
<keyword
>mp3</keyword>
<keyword
>music</keyword>
<keyword
>media</keyword>
</keywordset>
</bookinfo>

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

<para
>&noatun; -  это полнофункциональный модульный медиаплеер для &kde;.</para>

<sect1 id="features">
<title
>Особенности</title>

<para
>&noatun; - это медиаплеер и интерфейс к &arts; &mdash; аналоговому синтезатору реального времени. Добавить дополнительные объекты для воспроизведения можно, зайдя на страницу <ulink url="http://noatun.kde.org/plugins.phtml"
> http://noatun.kde.org/plugins.phtml</ulink
> или <ulink url="http://mpeglib.sf.net"
>http://mpeglib.sf.net</ulink
>. По умолчанию &arts; поддерживает MP3 и MPEG-1. Vorbis также поддерживается в том случае, если библиотеки Vorbis были доступны при сборке &kde;. </para>

</sect1>
</chapter>

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

<para
>По умолчанию &noatun;, запускается в облике модуля Excellent. Этот модуль был выбран потому, что он более всех прочих похож на другие приложения &kde;.</para>

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

<sect1 id="title-format">
<title
>Формат заголовка</title>
<para
>В диалоге настройки &noatun; есть текстовое поле <guilabel
>Формат заголовка</guilabel
>. В нём вы можете задать формат, в котором будет выводиться строка заголовка. </para>

<itemizedlist>
<listitem
><para
>Текст будет выводиться как обычно, если он не заключен в <literal
>$( )</literal
>.</para
></listitem>
<listitem
><para
>Текст внутри <literal
>$( )</literal
> - это шаблон, для которого будет подставляться соответствующее значение.</para
></listitem>
<listitem
><para
>Если в тексте внутри <literal
>$( )</literal
> попадаются кавычки, то текст в кавычках будет выводиться обычным образом, если только такой шаблон в названии существует.</para
></listitem>
<listitem
><para
>Кавычки можно ставить в любом месте: в начале <literal
>$( )</literal
>,в конце его или по обеим сторонам.</para
></listitem>
</itemizedlist>

<para
>Например, <literal
>$(bitrate)</literal
> будет заменен значением битового потока, подгружаемого модулем метатегов. Однако текст при наличии кавычек будет показан так: <literal
>$(bitrate"kbps")</literal
> выведет значение битового потока и <literal
>&quot;kbps&quot;</literal
>. Ни то, ни другое не будет показано, если шаблон <quote
>bitrate</quote
> не существует. </para
>	
</sect1>

</chapter>

<chapter id="using-noatun-plugins">
<title
>Использование модулей &noatun;</title>

<para
>Вы можете добавить модули через пункт меню <guimenuitem
>Настройка</guimenuitem
> <guimenuitem
>Настроить &noatun;...</guimenuitem
>. Перейдите на вкладку <guilabel
>Модули</guilabel
> и выберите элемент. Затем подключите модуль, отметив флажок рядом с его именем. Нужно подключить хотя бы один из модулей пользовательского интерфейса и в точности один модуль списка песен. </para>

<sect1 id="milk-chocolate">
<title
>Молочный шоколад</title>

<para
>Молочный шоколад - это простейший стиль пользовательского интерфейса. Кнопки его ведут себя так, как на CD-плеере, а кнопка <guiicon
>Извлечь</guiicon
> открывает список песен. Кнопка <guiicon
>с крестиком</guiicon
> удаляет текущий элемент из списка, но не с диска, а кнопка <guiicon
>стрелка</guiicon
> задает повтор воспроизведения. При щелчке правой кнопки мыши в любом месте окна открывается контекстное меню.</para>

</sect1>

<sect1 id="young-hickory">

<title
>Ветка гикори</title>

<para
>Ветка гикори - это модуль для системного лотка &kde;, области панели возле часов.</para>

<para
>При нажатии правой кнопкой на иконке выводится меню, левой кнопкой включаются или выключатся пользовательские окна &noatun;. Кстати говоря, списки песен к таковым не относятся.</para>

</sect1>

<sect1 id="html-exporter">
<title
>Экспорт списка в <acronym
>HTML</acronym
></title>

<para
>Этот модуль сохраняет список в виде симпатичной <acronym
>HTML</acronym
>-таблицы. В её настройках вы можете задать цвета, фоновый рисунок, включить изменение цветов ссылок при наведении мышью.</para>

<para
>Когда вы зададите параметры, через меню <guimenu
>Действия</guimenu
> <guimenuitem
>Экспорт списка...</guimenuitem
> будет открываться диалог, и вы сможете выбрать, куда сохранять файл. </para>

</sect1>

<sect1 id="kjofol-skin">
<title
>Образы <application
>K-Jöfol</application
></title>

<para
><application
>K-Jöfol</application
>, загрузчик образов для &noatun; - это подобие программы для &Windows; с тем же названием.</para>

<para
>Однако её версия для &noatun;, к сожалению, имеет ограничения . Образы должны храниться в несжатом виде на диске.</para>

<para
>Чтобы установить новый образ (в zip-формате для &Windows;), вы можете запустить установочную утилиту для образов через диалог настройки &noatun;.</para>

<para
>Так как некоторые образы упакованы некорректно, а установщик образов не может предугадать всё, то если установка образа прошла неудачно, вы можете следовать этим инструкциям:</para>

<screen
><prompt
>%</prompt
> <userinput
><command
>cd</command
> <filename class="directory"
>$KDEHOME/share/apps/noatun</filename
></userinput>
<prompt
>%</prompt
> <userinput
><command
>mkdir</command
> <option
>kjskins</option
></userinput
> (если это нужно)
<prompt
>%</prompt
> <userinput
><command
>cd</command
> <option
>kjskins</option
></userinput>
<prompt
>%</prompt
> <userinput
><command
>mkdir</command
> <prompt
>%</prompt
><option
>новый_образ</option
> ; <command
>cd</command
> <replaceable
>новы_образ</replaceable
></userinput>
<prompt
>%</prompt
> <userinput
><command
>unzip</command
> <replaceable
>/путь/до/нового_образа.zip</replaceable
></userinput
></screen>

<para
>Также вы можете создавать свои образы, следуя руководству на <ulink url="http://www.angelfire.com/mo/nequiem/tutorial.html"
>http://www.angelfire.com/mo/nequiem/tutorial.html</ulink
>. </para>

</sect1>

<sect1 id="splitplaylist">
<title
>Список Split</title>

<para
>Интерфейс списка Split ничем особенным не отличается. Вы можете начать воспроизведение, дважды щёлкнув по записи или выделив её и нажав <keycap
>Enter</keycap
>. Можно также перетаскивать мышью файлы и ссылки. </para>

<para
>Начиная с версии &kde; 3.0, список Split (<acronym
>SPL</acronym
>) сохраняет данные в формате &XML;, не если XML-файл не существует, то автоматически будет создан файл <acronym
>m3u</acronym
>. Это означает, что вы можете удалять XML-файлы и записывать в m3u-файлы, чтобы автоматически создавать такие списки. </para>

<para
>Само имя "Split" ничего не означает, поскольку уже давно ничего не разделяется (англ. - split). Оно осталось со времен молодости &noatun;, когда такое разделение на самом деле существовало. </para>
</sect1>

<sect1 id="winampskin">
<title
>Стили Winamp</title>
<para
>Если вы когда-либо запускали <trademark
>Winamp</trademark
>, этот стиль будет вам знаком. Щелчок по таймеру переключает направление отсчёта времени с прямого на обратное и наоборот. Выбор области эквалайзера включает или отключает его. Двойной щелчок по заголовку сворачивает окно, а щелчок правой кнопкой или щелчок по левой верхней кнопке окна приведет к показу панели инструментов &noatun;. </para>
<para
>Новый стиль можно устанавливать в каталог <filename class="directory"
>$KDEHOME/share/apps/noatun/skins/winamp</filename
>, если создать для него подкаталог и распаковать туда архив. Файлы стилей <trademark
>Winamp</trademark
> имеют расширение <literal role="extension"
>.wsz</literal
> - это обычные zip-архивы. Может потребоваться переименовать файл, если архиватор не понимает такое расширение. </para>
</sect1>

<sect1 id="metatag">
<title
>Метатег</title>
<para
>Это модуль, загружающий сведения о файле посредством механизма KFile, точно так же как &konqueror; выводит подсказки о файле при наведении мышью. Помимо вывода сведений он позволяет редактировать теги через меню <guimenu
>Действия</guimenu
> <guimenu
>Редактор тегов</guimenu
>. Можно редактировать теги <acronym
>ID3</acronym
> и OggVorbis. Он также читает значение битового потока. </para>
</sect1>

<sect1 id="keyz">
<title
>Keyz</title>
<para
>Карстен Пфайффер решил покончить с устоявшейся привычкой называть модули &noatun; не поймёшь как - вспомните хотя бы "молочный шоколад" и "ветку гикори". В чём смысл замены S на Z? Так уж принято говорить на хакерском новоязе! </para>
<para
>Каким бы простым не было название модуля, сам модуль может поспорить с ним в своей простоте. Так и есть, вы можете назначать клавиши различным действиям в &noatun;. Прелесть его в том, что эти клавиши будут работать везде, а не только в &noatun;. Что может наконец оправдать существование <quote
>мультимедийных клавиатур</quote
> в глазах их обладателей. </para>
</sect1>

<sect1 id="ir-control">
<title
>Инфракрасный пульт</title>
<para
>Если у вас есть инфракрасный пульт, например, поставляемый с телевизионными тюнерами <trademark class="registered"
>Brooktree</trademark
>, а сам пульт поддерживается <ulink url="http://www.lirc.org"
>LIRC</ulink
>, то вы сможете им воспользоваться. Как и Keyz, название не впечатляет, но функции модуля могут быть полезны. </para>
<para
>Чтобы назначить действие какой-либо клавишу, откройте страницу Инфракрасный пульт в окне настройки &noatun;. Выберите клавишу и соответствующее действие из выпадающего списка. Если вы хотите, чтобы действие повторялось, как, например, регулировка громкости, то отметьте флажок и укажите интервал повтора. </para>
<para
>Если у вас <acronym
>ТВ</acronym
> плата, то удобно будет соотнести с кнопкой <guibutton
>Отключить звук</guibutton
> действие Пауза. При этом ваш телевизор будет замолкать, а &noatun; - включаться, и наоборот. Очень удобно при показе рекламы. </para>
</sect1>
</chapter>

<chapter id="questions-answers-and-tips">

<title
>Вопросы, ответы, полезные советы</title>

<qandaset id="faq">
<title
>Часто задаваемые вопросы</title>
<qandaentry>
<question>
<para
>При воспроизведении случаются заметные паузы, когда перемещаются окна.</para>
</question>
<answer>
<para
>Настройте размер буфера &arts; так: </para
> 

<itemizedlist
> 
<listitem
><para
>Запустите Центр управления</para
></listitem>
<listitem
><para
>Откройте группу <guilabel
>Звук</guilabel
></para
></listitem
> 
<listitem
><para
>Найдите раздел <guilabel
>Звуковой сервер</guilabel
></para
></listitem
> 
<listitem
><para
>Увеличьте время отклика. Для большинства компьютеров значение 384 мс будет вполне достаточным.</para
></listitem
> 
</itemizedlist
> 

<para
>Вы можете также попробовать запускать звуковой сервер с приоритетом реального времени. Учтите, что это иногда может подвесить систему. </para
> 

</answer>
</qandaentry>
<qandaentry>
<question>
<para
>Не удаётся удалить список песен или пользовательский интерфейс из списка модулей.</para>
</question>
<answer>
<para
>Поскольку для работы &noatun; требуется как минимум один пользовательский интерфейс и ровно один список песен, вам следует добавить новый модуль пользовательского интерфейса, прежде чем удалять старый. Добавление нового списка песен автоматически заменяет старый список. </para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para
>Где взять другие модули?</para>
</question>
<answer>
<para
>Свободные программисты могут предоставлять модули собственной разработки на <ulink url="http://noatun.kde.org/plugins.phtml"
>сайт &noatun;</ulink
>, откуда их и скачивают себе пользователи. </para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para
>Как самому написать модуль &noatun;?</para>
</question>
<answer>
<para
>Документацию, справочник по <acronym
>API</acronym
> и пример исходного кода можно взять на <ulink url="http://noatun.kde.org"
>сайте &noatun;</ulink
>. Разумеется, в духе свободного программного обеспечения, &noatun; и его модули имеют открытый исходный код. </para>
</answer>
</qandaentry>
</qandaset>
</chapter>

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

<para
>Программирование - copyright 2000-2002 Charles Samuels <email
>charles@kde.org</email
></para>

<para
>Документация - copyright 2002 Charles Samuels <email
>charles@kde.org</email
></para>

<para
>&noatun; обрел жизнь благодаря усилиям следующих людей:</para>

<itemizedlist>
<listitem>
<para
>Charles Samuels <email
>charles@kde.org</email
></para>
</listitem>
<listitem>
<para
>Neil Stevens <email
>multivac@fcmail.com</email
></para>
</listitem>
<listitem>
<para
>Stefan Westerfeld <email
>stefan@space.twc.de</email
></para>
</listitem>
<listitem>
<para
>Martin Vogt <email
>mvogt@rhrk.uni-kl.de</email
></para>
</listitem>
<listitem>
<para
>Malte Starostik <email
>malte.starostik@t-online.de</email
></para>
</listitem>
<listitem>
<para
>Nikolas Zimmermann <email
>wildfox@kde.org</email
></para>
</listitem>
<listitem>
<para
>Stefan Schimanski <email
>1Stein@gmx.de</email
></para>
</listitem>
</itemizedlist>
<para
>Перевод на русский: Григорий Мохин <email
>mok@kde.ru</email
></para
> 
&underFDL; &underBSDLicense; </chapter>

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

<sect1 id="how-to-obtain-Noatun">
<title
>Где взять &noatun;</title>
&install.intro.documentation; </sect1>

<sect1 id="requirements">
<title
>Требования</title>

<para
>&noatun; работает на Pentium 200 под &Linux;, на PowerPC под &Linux; 2.4.1 или позднее, а также на других платформах. С каждой новой версией расширяется список поддерживаемых платформ.</para>

<para
>Чтобы программа легко переносилась на какую-либо платформу, на ней должны поддерживаться потоки (pthread) и звук <acronym
>OSS</acronym
>, однако под &Linux; поддерживается и <acronym
>ALSA</acronym
>.</para>

</sect1>

<sect1 id="compilation-and-installation">
<title
>Сборка и установка</title>
&install.compile.documentation; <para
>Если же что-то у вас не получилось, сообщите о проблемах автору: <email
>charles@kde.org</email
>.</para>

<para
>Если вы читаете этот документ, то скорее всего &noatun; у вас уже собран.</para>

</sect1>

</appendix>

<glossary id="glossary">
<title
>Словарь</title>

<glossentry id="gloss-mc">
<glossterm
>Молочный шоколад</glossterm
><glossdef>
<para
>Молочный шоколад - незатейливый модуль пользовательского интерфейса </para
></glossdef
></glossentry>

<glossentry id="gloss-arts">
<glossterm
>&arts;</glossterm
><glossdef>
<para
>&arts; - аналоговый синтезатор реального времени. Мощная мультимедийная программная система, используемая &noatun; </para
></glossdef
></glossentry>
<glossentry id="gloss-kj">
<glossterm
>K-Jöfol</glossterm
><glossdef>
<para
>Модуль загружает стили, подобно тому как это делает программа под &Windows; с похожим названием. </para
></glossdef
></glossentry>

<glossentry id="gloss-keyz">
<glossterm
>Keyz</glossterm
><glossdef>
<para
>Keyz - горячие клавиши для &noatun; </para
></glossdef
></glossentry>
<glossentry id="gloss-young-hickory">
<glossterm
>Ветка гикори</glossterm
><glossdef>
<para
>Ветка гикори - модуль встраивания в системный лоток. </para
></glossdef
></glossentry>
<glossentry id="gloss-kaiman">
<glossterm
>Noatun</glossterm
><glossdef>
<para
>Kaiman - модуль подключения стилей плеера GQMPEG. Kaiman - это также предшественник &noatun;, входивший в состав &kde; 2.0. &noatun; впервые был включен в &kde; 2.1, и загрузчик стилей Kaiman стал модулем &noatun;. </para
></glossdef
></glossentry>

</glossary>

&documentation.index;
</book>

