docs/kdebase-runtime/kcontrol/helpindex/index.docbook

   1 <?xml version="1.0" ?>
   2 <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
   3 "dtd/kdex.dtd" [
   4 <!ENTITY % addindex "IGNORE">
   5 <!ENTITY % Russian "INCLUDE"
   6 > <!-- change language only here -->
   7 ]>
   8
   9 <article lang="&language;">
  10 <articleinfo>
  11
  12 <authorgroup>
  13 <author
  14 >&Mike.McBride; &Mike.McBride.mail;</author>
  15 <author
  16 >&Jost.Schenck; &Jost.Schenck.mail;</author>
  17
  18 <othercredit role="translator"
  19 ><firstname
  20 >Екатерина</firstname
  21 ><surname
  22 >Пыжова</surname
  23 > <affiliation
  24 ><address
  25 ><email
  26 >haleth@yandex.ru</email
  27 ></address
  28 ></affiliation
  29 > <contrib
  30 >Перевод на русский</contrib
  31 ></othercredit
  32 >
  33 </authorgroup>
  34
  35 <date
  36 >2002-10-17</date>
  37 <releaseinfo
  38 >3.1</releaseinfo>
  39
  40 <keywordset>
  41 <keyword
  42 >KDE</keyword>
  43 <keyword
  44 >Центр настройки</keyword>
  45 <keyword
  46 >Индекс справки</keyword>
  47 <keyword
  48 >Индекс</keyword>
  49 </keywordset>
  50 </articleinfo>
  51
  52 <sect1 id="help-index">
  53
  54 <title
  55 >Индекс справки</title>
  56
  57 <note
  58 ><para
  59 >На момент написания этого руководства, в большинстве установок &kde; механизм поиска в &khelpcenter; был полностью недоступен, и настройки, сделанные в модуле &kcontrol; не играли никакой роли. Мы надеемся, что в будущих версиях это изменится.</para
  60 ></note>
  61
  62 <para
  63 >&kde; comes with a lot of documentation for applications and components. While it is possible to just browse the manuals until you find that piece of information you're looking for, this may be a very time-consuming task. To make this easier for you, &kde; offers fulltext search using a program called <application
  64 >ht://dig</application
  65 >. It works quite similar to search engines on the web, in fact some search engines you know might even use it. Just click on the <guilabel
  66 >Search</guilabel
  67 > tab in the &khelpcenter;, enter the word you are looking for, click <guibutton
  68 >Search</guibutton
  69 > and enjoy!</para>
  70
  71 <para
  72 >However, to make use of this feature, <application
  73 >ht://dig</application
  74 > has to be installed on your system and &kde; has to be configured to make use of it. This control module tries to help you doing the latter. If you haven't installed <application
  75 >ht://dig</application
  76 > and it wasn't shipped with your operating system you have to get ht://dig yourself. Have a look at <ulink url="http://www.htdig.org"
  77 >the ht://dig homepage</ulink
  78 > on how to download and install it.</para>
  79
  80 <para
  81 >При обычном запуске, вы находитесь в режиме просмотра. Чтобы изменить настройки, нажмите на кнопку <guibutton
  82 >Режим администратора</guibutton
  83 >. Если вы вошли в систему как <systemitem class="username"
  84 >root</systemitem
  85 >, вы попадете непосредственно в окно настройки. Иначе &kde; попросит пароль суперпользователя.</para>
  86 <sect2 id="help-index-use"
  87 >
  88
  89 <title
  90 >Использование</title
  91 >
  92
  93 <para
  94 >&kde; необходимо знать ответы на два важных вопроса, прежде чем запускать механизм полнотекстового поиска:</para>
  95
  96 <itemizedlist>
  97 <listitem
  98 ><para
  99 >где найти программы <application
 100 >ht://dig</application
 101 > для полнотекстового поиска;</para
 102 ></listitem>
 103 <listitem
 104 ><para
 105 >где искать.</para
 106 ></listitem>
 107 </itemizedlist>
 108
 109 <sect3 id="help-index-use-progs">
 110
 111 <title
 112 >Программы <application
 113 >ht://dig</application
 114 ></title>
 115
 116 <para
 117 >&kde; требует три программы, входящие в <application
 118 >ht://dig</application
 119 >: <command
 120 >htdig</command
 121 >, <command
 122 >htsearch</command
 123 > и <command
 124 >htmerge</command
 125 >. Для каждой программы необходимо указать полный путь, включая ее название, например <filename class="directory"
 126 >/usr/bin/htdig</filename
 127 >.</para
 128 >
 129
 130 <para
 131 >Где в точности установлены эти программы, зависит от вашей операционной системы и дистрибутива. Хотя есть несколько наиболее вероятных вариантов:</para>
 132
 133 <itemizedlist>
 134
 135 <listitem
 136 ><para
 137 ><command
 138 >htdig</command
 139 > и <command
 140 >htmerge</command
 141 > обычно находятся в <filename class="directory"
 142 >/usr/bin/</filename
 143 > или в <filename class="directory"
 144 >/usr/local/www/htdig/bin/</filename
 145 >.</para
 146 ></listitem>
 147
 148 <listitem
 149 ><para
 150 ><command
 151 >htsearch</command
 152 > можно найти в каталоге <filename class="directory"
 153 >cgi-bin</filename
 154 >, то есть, например в <filename class="directory"
 155 >/usr/local/httpd/cgi-bin/</filename
 156 >.</para>
 157
 158 </listitem>
 159 </itemizedlist>
 160
 161 <tip
 162 ><para
 163 >Чтобы узнать, где установлена, например, <command
 164 >htdig</command
 165 >, можно набрать в консоли <command
 166 >whereis htdig</command
 167 >. <command
 168 >whereis</command
 169 > ищет указанную команду в каталогах стандартных путей. Хотя каталоги вида <filename class="directory"
 170 >cgi-bin</filename
 171 > обычно не входят в стандартные пути поиска.</para
 172 ></tip>
 173
 174 </sect3>
 175
 176 <sect3 id="help-index-use-scope">
 177 <title
 178 >Области и пути поиска</title>
 179
 180 <para
 181 >В этом разделе можно выбрать, какие источники помощи должны индексироваться, &ie; должны быть доступными для механизма поиска.</para>
 182
 183 <para
 184 >В разделе <guilabel
 185 >Области</guilabel
 186 > можно выбрать некоторые типичные источники для индексирования, &ie; файлы помощи &kde; и информацию, предоставляемую командами <command
 187 >man</command
 188 > и <command
 189 >info</command
 190 >. Заметьте, что если некоторые из них пока не доступны, значит, поддержка для них еще не добавлена.</para>
 191
 192 <para
 193 >Возможно, у вас есть дополнительные файлы, для которых вы хотите использовать механизм полнотекстового поиска &khelpcenter;. Например, у вас есть <acronym
 194 >HTML</acronym
 195 >-документация, установленная в <filename
 196 >/home/jdoe/docs/selfhtml</filename
 197 >. Добавив этот путь в список дополнительных путей поиска, вы сделаете эту документацию доступной для полнотекстового поиска. Нажмите кнопку <guibutton
 198 >Добавить</guibutton
 199 > и в появившемся окне выберите дополнительный каталог для поиска (<filename class="directory"
 200 >/home/jdoe/docs/selfhtml</filename
 201 >) и нажмите <guibutton
 202 >OK</guibutton
 203 >. Чтобы удалить дополнительный путь поиска, выберите его и нажмите <guibutton
 204 >Удалить</guibutton
 205 >.</para>
 206
 207 <important
 208 ><para
 209 >Your changes to the scope and additional search paths will not take effect if you don't click on the <guibutton
 210 >Generate index</guibutton
 211 > button.</para
 212 ></important>
 213 </sect3>
 214
 215 </sect2>
 216
 217 </sect1>
 218 </article>
 219