summaryrefslogtreecommitdiffstats
path: root/tde-i18n-ru/docs/tdebase/khelpcenter/userguide/under-the-hood.docbook
blob: 156d24c74fbd2cbcd885e3f06f56c4ab9047aacc (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
<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>TDEHOME</envar> в вашей системе), общесистемные - в подкаталоге <filename class="directory">share/config</filename> корневого каталога &kde;. (Для того чтобы узнать путь к этому каталогу, выполните <command>tde-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>TDEHOME</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="tdedebugdialog">
<sect1info>
<authorgroup>
<author><personname> <firstname>Adriaan</firstname> <surname>de Groot</surname> </personname> <email>groot@kde.org</email> </author>
</authorgroup>
</sect1info>

<title>&tdedebugdialog; - настройка вывода отладочной информации &kde;</title>

<sect2 id="tdedebugdialog-basic-usage">
<title>Основы использования</title>

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

<para>Список областей отладки отсортирован по номерам, а не по алфавиту, поэтому  tdeio (127) идёт перед artskde (400). Максимальный номер - около 200000, но областей всего 400. Для того чтобы найти требуемую, вам не придётся листать весь список: укажите в поле ввода в верхней части окна часть названия области, и в списке будут отображаться только те области, названия которых содержат указанную строку. Например, если вы введёте <userinput>k</userinput>, список уменьшится ненамного, но если вы введёте <userinput>kont</userinput>, в списке останется только пункт &kontact;. Используя кнопки <guibutton>Выбрать всё</guibutton> и <guibutton>Отменить весь выбор</guibutton>, вы можете заставить &kde; выдавать как огромное количество отладочной информации, так и очень небольшое.</para>
</sect2>

<sect2 id="tdedebugdialog-fullmode">
<title>Полный режим TDEDebugDialog</title>

<!-- this text partly taken from the tdedebugdialog handbook -->

<para>В полном режиме (команда tdedebugdialog --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>