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
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
|
<chapter id="help-system-user-manual">
<chapterinfo><date>2002-02-03</date> <releaseinfo>0.08.00</releaseinfo> </chapterinfo>
<title>Система помощи &kde;: руководство пользователя</title>
<anchor id="help"/>
<sect1 id="help-introduction">
<title>Система помощи &kde;</title>
<para>Система помощи &kde; предназначена для того, чтобы упростить доступ к стандартным системам помощи &UNIX; (<application>man</application> и <application>info</application>), а также к документации по &kde; (&XML;). </para>
<para>Благодаря усилиям команды составителей документации, все базовые приложения &kde; полностью документированы. Если вы хотите помочь, свяжитесь с Lauri Watts, <email>lauri@kde.org</email>, координатором команды по документированию. Нет необходимости в опыте, требуется лишь энтузиазм и терпение. </para>
<para>Если вы хотите оказать содействие в переводе документации по &kde; на ваш родной язык, координатор переводов, Thomas Diehl, <email>thd@kde.org</email>, будет рад помощи. Более подробную информацию, включая имена координаторов каждой команды переводчиков, можно найти на <ulink url="http://i18n.kde.org">сайте интернационализации</ulink>, а также в разделе <link linkend="contact">Контактная информация</link> данного документа. Русский перевод &kde; в настоящее время координирует Григорий Мохин <email>mok@kde.ru</email>, а о том, как вы можете помочь команде переводчиков, написано в разделе документации <ulink url="http://www.kde.ru">русского сайта</ulink> &kde;. </para>
<sect2 id="installation">
<title>Установка</title>
<para>Установка Центра помощи &kde;, &khelpcenter;, является неотъемлемой частью установки базовых пакетов &kde; и происходит одновременно с установкой &kde;. &khelpcenter; можно найти в пакете tdebase, на <ulink url="ftp://ftp.kde.org/">&FTP;-сайте &kde; </ulink>, а также в пакете tdebase вашей операционной системы. </para>
</sect2>
</sect1>
<sect1 id="invoking-help">
<title>Вызов помощи</title>
<para>&khelpcenter; можно вызвать следующим образом: </para>
<variablelist>
<varlistentry>
<term>Из меню <guimenu>Справка</guimenu></term>
<listitem>
<para>Самый обычный способ: для того, чтобы открыть файл помощи для того или иного приложения, выберите в меню приложения <menuchoice><guimenu>Справка</guimenu> <guimenuitem>Содержание</guimenuitem></menuchoice>. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>Из <guimenu>K</guimenu>-меню</term>
<listitem>
<para>Нажмите на кнопку <guiicon>K</guiicon> на панели и выберите <guimenuitem>Справка</guimenuitem>; появится главная страница системы помощи &khelpcenter;. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>На панели</term>
<listitem>
<para>Панель &kicker; по умолчанию содержит пиктограмму, вызывающую &khelpcenter;. Опять-таки появится установленная по умолчанию главная страница. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>Из командной строки</term>
<listitem>
<para>Можно запустить &khelpcenter; при помощи ссылки &URL;. Ссылки &URL; добавлены также и для страниц <command>info</command> и <command>man</command>. Их можно использовать следующим образом: </para>
<variablelist>
<varlistentry>
<term>Файл помощи к определенному приложению</term>
<listitem>
<para><command>khelpcenter</command> <option>help:/<replaceable>kedit</replaceable></option> </para>
<para>Это открывает файл помощи к &kedit;. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>Локальная ссылка &URL;</term>
<listitem><para><command>khelpcenter</command> <option>file:/ <replaceable>usr/local/src/qt/html/index.html</replaceable></option> </para>
</listitem>
</varlistentry>
<varlistentry>
<term>Страница man</term>
<listitem>
<para><command>khelpcenter</command> <option>man:/<replaceable>strcpy</replaceable></option> </para>
</listitem>
</varlistentry>
<varlistentry>
<term>Страница Info</term>
<listitem>
<para><command>khelpcenter</command> <option>info:/<replaceable>gcc</replaceable></option> </para>
</listitem>
</varlistentry>
</variablelist>
<para>Вызов <command>khelpcenter</command> без указания параметров открывает страницу, установленную по умолчанию. </para>
</listitem>
</varlistentry>
</variablelist>
</sect1>
<sect1 id="interface-basics">
<title>Интерфейс &khelpcenter;</title>
<para>Интерфейс &khelpcenter; состоит из двух информационных панелей. </para>
<para>О панели инструментов и меню рассказывается в разделе <xref linkend="menu-and-toolbar-ref"/>. </para>
<para>Документы содержат свои собственные средства навигации, позволяющие вам пролистывать документ при помощи ссылок <guilabel>Следующая</guilabel>, <guilabel>Предыдущая</guilabel>, и <guilabel>В начало</guilabel>, или читать его в произвольном порядке по гиперссылкам. </para>
<para>Ссылки могут перенести вас в другие разделы того же документа или в другой документ, а при помощи пиктограмм <guiicon>Назад</guiicon> (cтрелка с указателем влево) и <guiicon>Вперед</guiicon> (cтрелка с указателем вправо) на панели инструментов вы можете вернуться к документам, которые вы просматривали в этом сеансе. </para>
<para>На двух панелях отображается содержание системы помощи (слева) и сами файлы помощи (справа). </para>
<sect2 id="contents-pane">
<title>Панель <guilabel>Содержание</guilabel></title>
<para>Панель <guilabel>Содержание</guilabel> в &khelpcenter; отображается в левой части окна. Как и можно ожидать, граница, разделяющая обе части, передвигается, чтобы можно было видеть все содержимое каждой панели. </para>
<para>Панель <guilabel>Содержание</guilabel> поделена на две вкладки; на первой содержится <link linkend="contents-menu">меню</link>, показывающее всю информацию, вошедшую в Центр помощи, а на второй - познакомиться с <link linkend="kde-glossary">глоссарием</link> терминов &kde;. </para>
<sect3 id="contents-menu">
<title>Меню <guilabel>Содержание</guilabel></title>
<para><guilabel>Содержание</guilabel> содержит по умолчанию следующие разделы: </para>
<variablelist>
<varlistentry>
<term><guilabel>Введение</guilabel></term>
<listitem><para>Добро пожаловать в &kde; - введение в графическую рабочую среду &kde;.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Введение в &kde;</guilabel></term>
<listitem>
<para>Обзор возможностей работы в графической среде &kde;. Здесь также содержатся рекомендации, как наиболее эффективно использовать &kde;. </para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Руководство пользователя &kde;</guilabel></term>
<listitem>
<para>Руководство пользователя &kde; - это обзор всех возможностей &kde;, включая установку, настройку и использование. </para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Документация приложений</guilabel></term>
<listitem>
<para>Документация по &kde;-приложениям. Документация по всем приложениям &kde; яранится в формате &XML; и преобразуется в формат <acronym>HTML</acronym> во время просмотра. В этом разделе содержится перечень всех приложений &kde; с кратким описанием их возможностей, а также ссылки на полную документацию по этим приложениям. </para>
<para>Приложения отображаются в виде дерева, повторяя структуру, которую имеет <guimenu>K</guimenu>-меню по умолчанию. Это упрощает процесс поиска нужного вам приложения. </para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Man-страницы (документация по &UNIX;)</guilabel></term>
<listitem>
<para>Man-страницы - традиционный формат документации для систем &UNIX;. Для большинства программ вашей системы существуют man-страницы. Также имеются man-страницы по функциям программирования и форматам файлов. </para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Просмотр info-страниц</guilabel></term>
<listitem>
<para>Документация TeXinfo используется многими приложениями &GNU;, включая <command>gcc</command> (компилятор C/C++), <command>emacs</command> и др. </para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Учебные руководства</guilabel></term>
<listitem>
<para>Краткие, по темам или информационные руководства. </para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Вопросы и ответы по &kde;</guilabel></term>
<listitem>
<para>Часто задаваемые вопросы по &kde; и ответы на них. </para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>&kde; в Интернете</guilabel></term>
<listitem>
<para>Ссылки на &kde; в Интернете, как на официальный, так и на другие полезные сайты. </para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Контактная информация</guilabel></term>
<listitem>
<para>Информация о том, как связаться с разработчиками &kde; и как зарегистрироваться в списках рассылки &kde;. </para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Поддержка &kde;</guilabel></term>
<listitem>
<para>О том, как помочь проекту KDE и как самому принять в нем участие. </para>
</listitem>
</varlistentry>
</variablelist>
</sect3>
<!--
<sect3 id="search">
<title>The <guilabel>Search</guilabel> tab</title>
<para>
Searching requires you have the <application>ht://Dig</application>
application installed. Information on installing and configuring the
search index is available in the document. Configuration of the search
index is performed in the &kcontrol;, by choosing
<menuchoice><guisubmenu>Help</guisubmenu><guimenuitem>Index</guimenuitem></menuchoice>,
and detailed help is available from this module.
</para>
<para>
For the purposes of this document, we'll assume you already have this set
up and configured.
</para>
<para>
Searching the help files is fairly intuitive, enter the word(s) you wish
to search for in the text box, choose your options (if any), and press
<guibutton>Search</guibutton>. The results display in the viewer pane
to the right.
</para>
<para>The options available are:</para>
<variablelist>
<varlistentry>
<term><guilabel>Method</guilabel></term>
<listitem>
<para>
Choose how to search for multiple words. If you choose
<guilabel>and</guilabel>, results are returned only if all your search
terms are included in the page. <guilabel>or</guilabel> returns results
if <emphasis>any</emphasis> of the search terms are found, and
<guilabel>boolean</guilabel> lets you search using a combination.
</para>
<para>
Boolean syntax lets you use the operators <literal>AND</literal>,
<literal>OR</literal> and <literal>NOT</literal> to create complex
searches. Some examples:</para>
<variablelist>
<varlistentry>
<term><userinput>cat and dog</userinput></term>
<listitem><para>Searches for pages which have both the words
<userinput>cat</userinput> and <userinput>dog</userinput> in them. Pages with
only one or the other will not be returned.</para></listitem>
</varlistentry>
<varlistentry>
<term><userinput>cat not dog</userinput></term>
<listitem><para>Searches for pages with <userinput>cat</userinput> in them, but
only returns the ones that don't have the word <userinput>dog</userinput> in
them.</para></listitem>
</varlistentry>
<varlistentry>
<term><userinput>cat or (dog not nose)</userinput></term>
<listitem><para>Searches for pages which contain <userinput>cat</userinput>, and
for pages which contain <userinput>dog</userinput> but don't contain
<userinput>nose</userinput>. Pages which contain both
<userinput>cat</userinput> and <userinput>nose</userinput> would be returned,
pages containing all three words would not.</para></listitem>
</varlistentry>
</variablelist>
<para>If your searches are not returning the results you expect, check
carefully you haven't excluded the wrong search term with an errand
<literal>NOT</literal> or a stray brace.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Max. results</guilabel></term>
<listitem><para>Determines the maximum number of results returned from your
search.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Format</guilabel></term>
<listitem><para>Decide if you want just a short link to the page
containing your search terms, or do you want a longer
summary.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Sort</guilabel></term>
<listitem><para>Sort the results in order of <guilabel>Score</guilabel> (how
closely your search terms were matched,) alphabetically by
<guilabel>Title</guilabel> or by <guilabel>Date</guilabel>. Selecting the
<guilabel>Reverse order</guilabel> check box, naturally enough, reverses the
sort order of the results.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Update index</guilabel></term>
<listitem><para>Update the search index, to incorporate new documents,
or if you think your database is incomplete or damaged. This may take
some time.</para></listitem>
</varlistentry>
</variablelist>
</sect3>
-->
</sect2>
<sect2 id="man-and-info">
<title>Разделы <application>Man</application> и <application>Info</application>.</title>
<para>Страницы man - это стандартные страницы документации по &UNIX;, которые использовались в течение многих лет на многих операционных системах. Они содержат подробнейшую информацию и являются самым лучшим источником сведений о большинстве команд и приложений в &UNIX;-системах. Когда люди говорят вам <quote>RTFM</quote>, читай руководство, то руководство, на которое они ссылаются, часто является именно man-страницей.</para>
<para>Man-страницы имеют некоторые недостатки. Они дают доскональную информацию, но они также и чрезвычайно техничны; часто они написаны разработчиками и для разработчиков. В некоторых случаях это делает их несколько недружелюбными, или вовсе непонятными для многих пользователей. Однако, это наилучший, а иногда и единственный источник надежной информации по большинству приложений, использующих командную строку.</para>
<para>Если вам когда-нибудь было интересно, что означают числа в выражениях, например, man(1), это означает раздел, в котором они находятся в руководстве. Вы увидите, что &khelpcenter; использует числа, чтобы поделить очень многие man-страницы на разделы, что облегчает поиск нужной информации при просмотре.</para>
<para>Существуют также и info-страницы, предназначенные для замены man-страниц. Разработчики некоторых приложений больше не обновляют man-страницы, и если существуют одновременно и man-страница и info-страница, вероятно, более свежей будет info. Однако, большинство приложений имеют или ту, или другую. Если приложение, по которому вы ищете справочную информацию, является утилитой &GNU;, вероятнее всего, вы найдете info-, а не man-страницу.</para>
<sect3 id="navigation">
<title>Просмотр <application>info</application>-страниц</title>
<para>Info-документы имеют древовидную структуру, и каждая страница называется узлом. Все info-документы имеют <guilabel>верхний</guilabel> узел, то есть вступительную часть. Можно вернуться к началу каждого документа, нажав <guilabel>Наверх</guilabel>.</para>
<para><guibutton>Предыдущая</guibutton> и <guibutton>Следующая</guibutton> используются для перехода на предыдущую/следующую страницу на том же уровне иерархии.</para>
<para>Нажатие на пункт меню в документе переводит на более низкий уровень в иерархии. Можно перемещаться и наверх, нажав <guibutton>вверх</guibutton>.</para>
<para>Man-страницы организованы подобно info-страницам; индекс раздела является верхним узлом, а каждая man-страница - на уровень ниже. Размер каждого подраздела man-документации - одна страница.</para>
</sect3>
</sect2>
<sect2 id="kde-glossary">
<title>Глоссарий &kde;</title>
<para>Глоссарий является справочником, где можно найти определение незнакомых слов, начиная со специфических приложений и технологий &kde; и заканчивая общей &UNIX;-терминологией. </para>
<para>На панели слева вы увидите два пункта: <guilabel>По алфавиту</guilabel> и <guilabel>По теме</guilabel>. Оба пункта содержат одинаковые компоненты, расположенные в разной последовательности, что позволяет быстро найти интересующий элемент. </para>
<para>Элементы, которые вы выбираете, перемещаясь по дереву слева, отображаются справа. </para>
</sect2>
<sect2 id="menu-and-toolbar-ref">
<title>Меню и панель инструментов</title>
<para>&khelpcenter;, имеет минимальный интерфейс, позволяющий сосредоточиться на получении информации, а не на изучении процедуры использования программы помощи. </para>
<para>Пиктограммы на панели инструментов: </para>
<variablelist>
<title>Пиктограммы инструментов</title>
<varlistentry>
<term><guiicon>Назад</guiicon></term>
<listitem>
<para>Возврат к предыдущей странице</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guiicon>Вперед</guiicon></term>
<listitem>
<para>Переход на одну страницу вперед, возможный только после того, как вы нажали кнопку <guiicon>Назад</guiicon>.</para></listitem>
</varlistentry>
<varlistentry>
<term><guiicon>Печать</guiicon></term>
<listitem>
<para>Напечатать содержимое просматриваемой страницы. </para>
</listitem>
</varlistentry>
<varlistentry>
<term><guiicon>Поиск</guiicon></term>
<listitem>
<para>Найти слово или слова на просматриваемой странице. </para>
</listitem>
</varlistentry>
<varlistentry>
<term><guiicon>Увеличить размер шрифта</guiicon></term>
<listitem>
<para>Увеличить размер текста на панели просмотра. </para>
</listitem>
</varlistentry>
<varlistentry>
<term><guiicon>Уменьшить размер шрифта</guiicon></term>
<listitem>
<para>Уменьшить размер текста на панели просмотра. Эта возможно лишь в том случае, если вы уже увеличивали текст. </para>
</listitem>
</varlistentry>
</variablelist>
<para>В меню есть следующие пункты: </para>
<variablelist>
<varlistentry>
<term><guimenu>Файл</guimenu></term>
<listitem>
<variablelist>
<varlistentry>
<term>
<menuchoice><guimenu>Файл</guimenu> <guimenuitem>Печать...</guimenuitem> </menuchoice>
</term>
<listitem>
<para>Напечатать содержимое просматриваемой страницы. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo> </shortcut> <guimenu>Файл</guimenu> <guimenuitem>Выход</guimenuitem> </menuchoice>
</term>
<listitem>
<para>Выход из &khelpcenter; </para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
<varlistentry>
<term><guimenu>Правка</guimenu></term>
<listitem>
<variablelist>
<varlistentry>
<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo> </shortcut> <guimenu>Правка</guimenu> <guimenuitem>Выделить все</guimenuitem> </menuchoice>
</term>
<listitem>
<para>Выделить весь текст на просматриваемой странице. </para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo></shortcut> <guimenu>Правка</guimenu> <guimenuitem>Поиск...</guimenuitem> </menuchoice>
</term>
<listitem>
<para>Найти слово или слова на просматриваемой странице. </para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
<varlistentry>
<term><guimenu>Вид</guimenu></term>
<listitem>
<variablelist>
<varlistentry>
<term><menuchoice><guimenu>Вид</guimenu> <guimenuitem>Просмотреть исходный текст документа</guimenuitem> </menuchoice>
</term>
<listitem>
<para>Просмотр исходного кода <acronym>HTML</acronym> страницы. </para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Вид</guimenu> <guimenuitem>Кодировка</guimenuitem> </menuchoice>
</term>
<listitem>
<para>Задать кодировку просматриваемой страницы. Обычно настройку по умолчанию <guimenuitem>Авто</guimenuitem> менять не приходится, но если у вас возникли проблемы с просмотром страниц на родном (не английском) языке, попробуйте явным образом указать кодировку через это меню. </para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Переход</guimenu> <guimenuitem>Назад</guimenuitem></menuchoice></term>
<listitem>
<para>Возврат к предыдущей просмотренной странице.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Переход</guimenu> <guimenuitem>Вперед</guimenuitem> </menuchoice></term>
<listitem>
<para>Переход на одну страницу вперед, возможный только после того, как вы возвращались "назад".</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Переход</guimenu> <guimenuitem>...</guimenuitem> </menuchoice></term>
<listitem>
<para>Внизу меню <guimenu>Переход</guimenu> находится перечень недавно просмотренных страниц. Выберите одну из них, чтобы сразу попасть на нее.</para>
</listitem></varlistentry></variablelist>
</sect2>
</sect1>
<sect1 id="credits">
<title>Разработчики и лицензирование</title>
<para>&khelpcenter;</para>
<para>Первоначальная разработка - &Matthias.Elter; &Matthias.Elter.mail;</para>
<para>Текущее сопровождение - &Cornelius.Schumacher; &Cornelius.Schumacher.mail;</para>
&underFDL; &underGPL; </sect1>
</chapter>
|