Second part of prior commit

1 files changed, 636 insertions, 0 deletions

diff --git a/tde-i18n-ru/docs/tdebase/userguide/under-the-hood.docbook b/tde-i18n-ru/docs/tdebase/userguide/under-the-hood.docbook
new file mode 100644
index 00000000000..7edddeecc84
--- /dev/null
+++ b/tde-i18n-ru/docs/tdebase/userguide/under-the-hood.docbook
@@ -0,0 +1,636 @@
+<chapter id="tinkering-under-the-hood">
+<!-- Uncomment the <*info
+> below and add your name to be -->
+<!-- credited for writing this section. -->
+
+<!--
+<chapterinfo>
+<authorgroup>
+<author>
+<firstname
+>Your First Name here</firstname>
+<surname
+>Your Surname here </surname>
+</author>
+</authorgroup>
+</chapterinfo>
+-->
+
+<title
+>Тонкая настройка &kde;</title>
+
+<sect1 id="hand-editing-config-files">
+
+<sect1info>
+<author
+><personname
+> <firstname
+>Nicolas</firstname
+> <surname
+>Goutte</surname
+> </personname
+> <email
+>goutte@kde.org</email
+> </author>
+</sect1info>
+
+<title
+>Ручное редактирование файлов конфигурации</title>
+
+<sect2 id="hand-editing-intro">
+<title
+>Введение</title>
+<para
+>Файлы конфигурации &kde; можно редактировать любым текстовым редактором, например, &kate;, так как они - обычные текстовые файлы.</para>
+
+<para
+>Пример файла:</para>
+
+<programlisting
+>[General]
+AutoSave=1
+LastFile=/var/tmp/test.txt</programlisting>
+
+<para
+>Пользовательские параметры хранятся в каталоге <filename class="directory"
+>.kde/share/config</filename
+> (замените <filename
+>.kde</filename
+> на значение переменной $<envar
+>KDEHOME</envar
+> в вашей системе), общесистемные - в подкаталоге <filename class="directory"
+>share/config</filename
+> корневого каталога &kde;. (Для того чтобы узнать путь к этому каталогу, выполните <command
+>kde-config --prefix</command
+>.) Имена файлов обычно заканчиваются символами rc (без точки), например, <filename
+>kopeterc</filename
+>.</para>
+
+<warning
+><para
+>При редактировании файлов конфигурации вручную стабильность &kde; может быть нарушена, так как большинство приложений не проверяет правильность параметров при чтении.</para
+></warning>
+
+</sect2>
+
+<sect2 id="hand-editing-backups">
+<title
+>Резервные копии</title>
+
+<para
+>Создавайте резервные копии файлов перед тем, как их изменять. Резервные копии лучше всего хранить вне подкаталога <filename class="directory"
+>.kde</filename
+> (или другого каталога, на который указывает $<envar
+>KDEHOME</envar
+>). Резервные копии могут помочь вам и в случае системного сбоя &kde;, уничтожившего важные файлы конфигурации (например, файл конфигурации &kmail; - <filename
+>kmailrc</filename
+>). (Такие сбои не должны случаться, но они всё-таки случаются.)</para>
+</sect2>
+
+<sect2 id="hand-editing">
+<title
+>Редактирование</title>
+
+<para
+>Зачем вообще может понадобиться изменять файлы конфигурации? Во-первых, это необходимо при переводе системы в режим KIOSK. Разработчик приложения может попросить вас добавить параметр, чтобы помочь ему решить проблему с программой. Возможно, вы захотите устранить затруднения в работе с системой, не удаляя весь каталог <filename class="directory"
+>.kde</filename
+>. Наконец, таким способом можно узнать больше о &kde;.</para>
+
+<para
+>В любом из этих случаев вам может понадобиться вручную отредактировать файл конфигурации.</para>
+
+<para
+>Приступая к редактированию, убедитесь, что приложение, которое использует файл, не запущено. Если это один из системных файлов конфигурации, редактируйте его, не запуская &kde;.</para>
+
+<para
+>Готовы? Теперь сделайте резервную копию файла (надеюсь, вы об этом не забыли?), запустите ваш любимый редактор (предположим, это &kate;) и откройте файл (убедитесь, что используется кодировка  UTF-8, &kate; отображает её как <quote
+>utf8</quote
+>).</para>
+
+<para
+>Перед вами файл вида</para>
+
+<programlisting
+>[Имя_группы]
+Ключ1=Значение1
+Ключ2=Значение2
+Ключ3=Значение3</programlisting>
+
+<para
+>Теперь отредактируйте его (будьте внимательны!) и сохраните (в кодировке <acronym
+>UTF-8</acronym
+>).</para>
+
+<para
+>Теперь проверьте, как работает приложение. Если его поведение вас не устраивает, закройте его и восстановите файл конфигурации из резервной копии.</para>
+
+<itemizedlist>
+<title
+>Связанная информация</title>
+
+
+<listitem
+><para
+><xref linkend="kde-for-administrators"/> включает информацию о структуре каталогов &kde;. Это поможет вам найти файл, который вы хотите отредактировать.</para>
+</listitem>
+
+</itemizedlist>
+
+</sect2>
+
+</sect1>
+
+<sect1 id="scripting-the-desktop">
+<title
+>Создание сценариев</title>
+
+<para
+>&kde; использует мощный механизм взаимодействия между процессами - &DCOP;, Desktop COmmunication Protocol. С помощью &DCOP; вы можете управлять &kde; из командной строки или с помощью сценария, написанного на вашем любимом интерпретируемом языке. Также вы можете получать информацию от приложений &kde;, например, несколько мультимедийных проигрывателей &kde; могут возвращать информацию о текущем файле.</para>
+
+<para
+>Каждое приложение &kde; включает не менее одного <firstterm
+>интерфейса</firstterm
+> &DCOP;, который, в свою очередь, содержит методы (или функции, как вам угодно), которые могут быть вызваны другими приложениями. Если вы собираетесь использовать &DCOP;, в первую очередь следует найти функцию, с помощью которой вы можете выполнить свою задачу. Самый простой способ узнать доступные методы &DCOP; - использовать программу <application
+>kdcop</application
+>.</para>
+
+<para
+>Запустите <application
+>kdcop</application
+> из &konsole; или через окно запуска программ (выводится по <keycombo action="simul"
+>&Alt;<keycap
+>F2</keycap
+> </keycombo
+>). В окне <application
+>kdcop</application
+> в виде дерева показываются запущенные в данный момент приложения, которые предоставляют интерфейсы &DCOP;. Для того чтобы найти нужную функцию, иногда приходится поискать по этому дереву, однако запомните, что интерфейс, отмеченный <quote
+>(по умолчанию)</quote
+>, обычно содержит наиболее часто используемые функции.</para>
+
+
+
+<para
+>Для того чтобы выяснить, делает ли функция то, что вы от неё ожидаете, щёлкните дважды на пункте <guilabel
+>setColor</guilabel
+>. Для того чтобы установить цвет (переменная <varname
+>c</varname
+>), щёлкните на кнопке выбора цвета и укажите требуемый цвет. Если вы хотите, чтобы цвет был основным, установите флажок. Нажмите ОК, и будет установлен новый цвет фона.</para>
+
+<para
+>Для того чтобы обратиться к методу &DCOP;, используя ваш любимый интерпретируемый язык, вы можете употреблять связки &DCOP;, если они доступны в модуле tdebindings, или использовать приложение <command
+>dcop</command
+>. Для простых вызовов достаточно <command
+>dcop</command
+>. Для того чтобы вызвать метод &DCOP; из командной строки, мы должны указать приложение, интерфейс, которому принадлежит функция, её имя и аргументы. Форма вызова зависит от оболочки.</para>
+
+<para
+>Мы указываем данные в порядке приложение-интерфейс-метод-аргументы (аргументы в том порядке, в котором они отображаются в <application
+>kdcop</application
+>. Программа <command
+>dcop</command
+> имеет множество опций: см. <userinput
+><command
+>dcop</command
+> <option
+>--help</option
+></userinput
+>.</para>
+
+<para
+>От теории перейдём к практике:</para>
+
+<example>
+<title
+>Сценарий изменения цвета фона с помощью функций &DCOP;</title>
+
+<para
+>Мы создадим простой сценарий на Perl, использующий функции <command
+>dcop</command
+>. Он будет циклически изменять цвет фона рабочего стола (в порядке спектра).</para>
+
+<para
+>Сначала с помощью <application
+>kdcop</application
+> найдём подходящий метод. В этом примере мы опустим описание процесса поиска: нам требуется метод <menuchoice
+><guimenu
+>kdesktop</guimenu
+><guisubmenu
+>KBackgroundIface</guisubmenu
+><guimenuitem
+>setColor</guimenuitem
+> </menuchoice
+>. Аргументы и тип возвращаемого значения функции отображаются в соответствии с синтаксисом C++. Аргументы функции <methodname
+>setColor</methodname
+>: цвет (переменная <varname
+>c</varname
+>) - задаёт новый цвет фона, и двоичная переменная, <varname
+>isColorA</varname
+>, которая указывает, является цвет основным или вторичным (имеет значение, если фон формируется из 2-х цветов, т. е. используется градиент).</para>
+
+<para
+>Вызов метода <methodname
+>setColor</methodname
+> производится так: <screen
+><prompt
+>%</prompt
+> <userinput
+><command
+>dcop</command
+> kdesktop KBackgroundIface setColor '#ffffff' false</userinput
+>
+</screen>
+</para>
+
+<para
+>Значение RGB для цвета указывается в 16-ричной форме, как в &HTML;. Обратите внимание, что значение заключается в одинарные кавычки, чтобы оболочка правильно обработала символ <token
+>#</token
+>.</para>
+
+<para
+>Для того чтобы узнать значение RGB для какого-либо цвета, откройте любой диалог выбора цвета в приложении &kde; (например, в Центре управления - <menuchoice
+><guimenu
+>Внешний вид и темы</guimenu
+><guimenuitem
+>Цвета</guimenuitem
+></menuchoice
+>) и выберите желаемый цвет. Значение RGB отобразится в поле <guilabel
+>HTML</guilabel
+>.</para>
+
+
+<para
+>Больше &DCOP; применять не потребуется, можно перейти к созданию сценария. Вот пример реализации (не самый аккуратный): <programlisting
+><![CDATA[
+$min=49;  # Минимальное значение интенсивности красной, зелёной или синей составляющей цвета
+$max=174; # Максимальное значение интенсивности красной, зелёной или синей составляющей цвета
+$step=5;  # На эту величину значение будет изменяться на каждом шаге
+$sleeptime=15; # Пауза между изменениями цвета
+
+@start = ($max, $min, $min);
+@colour = @start;
+
+while (1) {
+        foreach (0..5) {
+                my $which = $_ % 3; # Какой цвет (красный, зелёный или синий) изменять
+                my $updown = $_ % 2; # Увеличивать или уменьшать интенсивность
+                do {
+                        if ($updown == 0) { $colour[$which]+=$step; }
+                        if ($updown == 1) { $colour[$which]-=$step; }
+                        my $dcopcall=sprintf "dcop kdesktop KBackgroundIface setColor '#%x%x%x' true\n", @colour;
+                        system($dcopcall);
+                        sleep $sleeptime;
+                        } while (($colour[$which] 
+>= $min) and ($colour[$which] <= $max));
+                }
+}
+]]>
+</programlisting>
+</para>
+
+<para
+>Запустите сценарий без аргументов, и он будет циклически изменять цвет фона рабочего стола в заданном порядке, пока не будет остановлен. <foreignphrase
+>Вот, собственно, и всё</foreignphrase
+>!</para>
+
+</example>
+
+<para
+>Конечно, вы можете создавать сценарии, использующие &DCOP;, не только на Perl; если вы предпочитаете сценарии оболочки - пожалуйста:</para>
+
+<example>
+<title
+>Установка фона через Интернет</title>
+
+<para
+>Следующий сценарий скачивает основной рисунок комикса <quote
+>User Friendly</quote
+> и устанавливает его в качестве фона рабочего стола. Сценарий использует общедоступные инструменты и функции &DCOP;.</para>
+
+<programlisting
+><![CDATA[
+#!/bin/sh
+COMICURL=`wget -qO - http://www.userfriendly.org/static/index.html | \
+          grep Latest | sed -e "s,.*SRC=\",," -e "s,\"
+>.*,,"`
+TMPFILE=`mktemp /tmp/$0.XXXXXX` || exit 1
+wget -q -O $TMPFILE $COMICURL
+dcop kdesktop KBackgroundIface setWallpaper $TMPFILE 1
+]]>
+</programlisting>
+
+<para
+>Первая строка сценария (после #!/bin/sh) с помощью <command
+>wget</command
+> и регулярных выражений получает адрес рисунка из основной &HTML;-страницы ресурса. Вторая и третья скачивают рисунок и, наконец, функция <command
+>dcop</command
+> помещает рисунок на рабочий стол.</para>
+
+</example>
+
+
+<!-- <itemizedlist>
+<title
+>Related Information</title>
+<listitem
+><para
+>to be written</para>
+</listitem>
+</itemizedlist
+> -->
+
+
+</sect1>
+
+
+<sect1 id="adding-extra-keys">
+<title
+>Добавление дополнительных комбинаций клавиш в &kde;</title>
+
+<para
+>На многих современных клавиатурах есть дополнительные клавиши, которые по умолчанию не используются.</para>
+
+<para
+>Клавиши мультимедийных функций обычно генерируют сигнал и могут быть использованы в комбинациях так же, как и обычные. Однако некоторые клавиши не обнаруживаются, поэтому бесполезно пытаться включить их в комбинации.</para>
+
+<para
+>Например, некоторые ноутбуки IBM рядом с клавишами "влево"-"вправо" имеют дополнительные клавиши, которые выглядят как <guiicon
+>page left</guiicon
+> и <guiicon
+>page right</guiicon
+>.</para>
+
+<procedure>
+<step
+><para
+>Для того чтобы узнать код клавиш, используйте <command
+>xev</command
+>. В указанном примере это 233 и 234. </para
+></step>
+<step
+><para
+>Выберите символы, которые будут соответствовать клавишам. Многие символы по умолчанию не используются, так что выбор есть. Список находится в файле <filename
+>/usr/X11R6/include/X11/keysymdef.h</filename
+> (или его эквиваленте в вашей системе).</para
+></step>
+<step
+><para
+>В домашнем каталоге создайте файл <filename
+>.Xmodmap</filename
+> и добавьте в него следующие строки:</para>
+<screen
+>keycode 233 = Next_Virtual_Screen
+keycode 234 = Prev_Virtual_Screen</screen>
+</step>
+<step
+><para
+>Выполните команду <userinput
+><command
+>xmodmap</command
+> <filename
+>~/.Xmodmap</filename
+></userinput
+></para
+></step>
+</procedure>
+
+<para
+>Теперь программа <command
+>xev</command
+> при нажатии этих клавиш должна отображать символы, которые вы с ними связали. Вы можете использовать эти клавиши в комбинациях.</para>
+
+<itemizedlist>
+<title
+>Связанная информация</title>
+<listitem
+><para
+>Для того чтобы прочитать руководство <command
+>xev</command
+>, введите <userinput
+>man:/xev</userinput
+> в строке адреса окна &konqueror; или <userinput
+><command
+>man</command
+> xev</userinput
+> - в окне терминала.</para
+></listitem>
+</itemizedlist>
+
+</sect1>
+
+<sect1 id="keys-for-scripts">
+<title
+>Добавление комбинаций клавиш для новых действий</title>
+
+<para
+>Вы можете назначить комбинации клавиш для большей части действий в приложениях и на рабочем столе. Вы можете сделать это, даже если добавили это действие сами, и оно не доступно стандартными способами.</para>
+
+<para
+>В одном из примеров мы совместим материал из двух предыдущих разделов с помощью клавиш, которые мы рассматривали в секции <xref linkend="adding-extra-keys"/>, будет осуществляться переход к следующему и предыдущему рабочему столу. Для этого нам потребуются две функции DCOP (последний рассматривается в разделе <xref linkend="scripting-the-desktop"/>).</para>
+
+<para
+>Это достигается следующим образом:</para>
+
+<procedure>
+<step>
+<para
+>Откройте Центр управления KDE, в секции <guilabel
+>Региональные и специальные возможности</guilabel
+> выберите <guilabel
+>Действия</guilabel
+>.</para>
+</step>
+<step>
+<para
+>Нажмите кнопку <guibutton
+>Создать действие</guibutton
+></para>
+</step>
+<step>
+<para
+>Присвойте ему имя, например, <userinput
+>Следующий рабочий стол</userinput
+></para>
+</step>
+<step>
+<para
+>Выберите <guilabel
+>тип действия</guilabel
+>: <guilabel
+>Комбинация клавиш -> Команда/URL (простой)</guilabel
+></para>
+</step>
+<step>
+<para
+>Перейдите на закладку <guilabel
+>Комбинации клавиш</guilabel
+>, щёлкните на кнопке и нажмите клавиши, которые хотите использовать. В нашем примере это клавиша <guiicon
+>Next Page</guiicon
+>. В поле будет отображаться символ <keysym
+>Next_Virtual_Screen</keysym
+>.</para>
+</step>
+<step>
+<para
+>На закладке <guilabel
+>Параметры команды/URL</guilabel
+> введите команду  <userinput
+><command
+>dcop twin default nextDesktop</command
+></userinput
+></para>
+</step>
+</procedure>
+
+<para
+>Повторите эти действия для клавиши <keysym
+>Prev_Virtual_Screen</keysym
+> (укажите команду <userinput
+><command
+>dcop twin default previousDesktop</command
+></userinput
+>).</para>
+
+<para
+>Теперь при нажатии клавиш  <keysym
+>Prev_Virtual_Screen</keysym
+> и <keysym
+>Next_Virtual_Screen</keysym
+> вы будете переходить к предыдущему и следующему виртуальному рабочему столу соответственно.</para>
+
+<para
+>Вы можете связать любую свободную клавишу с любым свободным действием.</para>
+
+<itemizedlist>
+<title
+>Связанная информация</title
+> 
+<listitem
+><para
+>Для того чтобы просмотреть документацию <application
+>KHotKeys</application
+>, выберите этот раздел в &khelpcenter; или введите <userinput
+>help:/khotkeys</userinput
+> в строке адреса окна &konqueror;.</para
+></listitem
+> 
+<listitem
+><para
+><xref linkend="adding-extra-keys"/></para
+></listitem>
+<listitem
+><para
+><xref linkend="scripting-the-desktop"/></para
+></listitem>
+</itemizedlist>
+
+</sect1>
+
+<sect1 id="kdebugdialog">
+<sect1info>
+<authorgroup>
+<author
+><personname
+> <firstname
+>Adriaan</firstname
+> <surname
+>de Groot</surname
+> </personname
+> <email
+>groot@kde.org</email
+> </author>
+</authorgroup>
+</sect1info>
+
+<title
+>&kdebugdialog; - настройка вывода отладочной информации &kde;</title>
+
+<sect2 id="kdebugdialog-basic-usage">
+<title
+>Основы использования</title>
+
+<para
+>&kdebugdialog; по умолчанию не указан в &kmenu;. Для того чтобы запустить его, введите команду <userinput
+><command
+>kdebugdialog</command
+></userinput
+> в окне терминала или окне запуска программ. Программа выведет список различных областей отладочной информации. Для того чтобы включить/выключить вывод отладочной информации соответствующих частей &kde;, установите/снимите флажок рядом с названием.</para>
+
+<para
+>Список областей отладки отсортирован по номерам, а не по алфавиту, поэтому  kio (127) идёт перед artskde (400). Максимальный номер - около 200000, но областей всего 400. Для того чтобы найти требуемую, вам не придётся листать весь список: укажите в поле ввода в верхней части окна часть названия области, и в списке будут отображаться только те области, названия которых содержат указанную строку. Например, если вы введёте <userinput
+>k</userinput
+>, список уменьшится ненамного, но если вы введёте <userinput
+>kont</userinput
+>, в списке останется только пункт &kontact;. Используя кнопки <guibutton
+>Выбрать всё</guibutton
+> и <guibutton
+>Отменить весь выбор</guibutton
+>, вы можете заставить &kde; выдавать как огромное количество отладочной информации, так и очень небольшое.</para>
+</sect2>
+
+<sect2 id="kdebugdialog-fullmode">
+<title
+>Полный режим KDebugDialog</title>
+
+<!-- this text partly taken from the kdebugdialog handbook -->
+
+<para
+>В полном режиме (команда kdebugdialog --fullmode) доступны те же области отладки, что и в обычном режиме, но теперь вы выбираете настраиваемую область из выпадающего списка и настраиваете каждую из них отдельно. Вы можете указать, куда будут выводиться сообщения следующих типов: Информация, Предупреждение, Ошибка и Критическая ошибка. </para>
+
+<para
+>В файл (вы должны будете указать имя). Файл будет создан в вашем домашнем каталоге.</para>
+
+<para
+>Вывод окна с сообщением. Каждое отладочное сообщение отображается в диалоговом окне. Нажмите <guibutton
+>ОК</guibutton
+>, чтобы приложение, отправившее сообщение, продолжило работу.</para>
+
+<para
+>Вывод в оболочку (значение по умолчанию). Сообщения отправляются в поток stderr, и будут либо отображены в окне оболочки, из которого приложение было запущено, либо дописаны в файл <filename
+>.xsession-errors</filename
+>.</para>
+
+<para
+>Запись в журнал системных сообщений. Сообщение отправляется процессу syslog, который производит дальнейшую обработку.</para>
+
+<para
+>Ничего. Вывод сообщения подавляется.</para>
+
+<para
+>Для критических ошибок не следует выбирать значение Ничего или Журнал системных сообщений, так как в обоих случаях вы, скорее всего, не увидите сообщение, а процесс приложения просто будет остановлен по неизвестной причине. Будет процесс остановлен при критической ошибке или нет, определяет флажок <guilabel
+>Отмена при фатальных ошибках</guilabel
+>, который по умолчанию установлен &mdash; но критическая ошибка и так почти всегда означает остановку приложения (в результате сбоя).</para>
+
+<!-- Add links to "further reading" here -->
+<!-- <itemizedlist>
+<title
+>Related Information</title>
+<listitem
+><para
+>to be written</para>
+</listitem>
+</itemizedlist
+>-->
+
+
+
+</sect2>
+</sect1>
+</chapter>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: xml
+sgml-omittag:nil
+sgml-shorttag:nil
+sgml-namecase-general:nil
+sgml-general-insert-case:lower
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:0
+sgml-indent-data:true
+sgml-parent-document:("index.docbook" "book" "chapter")
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+-->