<?xml version="1.0" ?>
<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN"
"dtd/kdex.dtd" [
<!ENTITY % addindex "IGNORE">
<!ENTITY % Spanish "INCLUDE" 
> <!-- change language only here -->
]>

<article lang="&language;">
<articleinfo>

<authorgroup>
<author
> <firstname
>Mike</firstname
> <surname
>McBride</surname
> </author>
<author
> <firstname
>Jost</firstname
> <surname
>Schenck</surname
> </author>
<othercredit role="translator"
> <firstname
>Pablo</firstname
> <surname
>de Vicente</surname
> <affiliation
><address
><email
>vicente@oan.es</email
></address
></affiliation
> <contrib
>Traductor</contrib
> </othercredit>
</authorgroup>

<date
>2002-10-17</date>
<releaseinfo
>3.1</releaseinfo>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>KControl</keyword>
<keyword
>Indice de ayuda</keyword>
<keyword
>Índice</keyword>
</keywordset>
</articleinfo>

<sect1 id="help-index">

<title
>Indice de ayuda</title>

<note
><para
>En el momento de la escritura de este documento, en la mayor parte de las instalaciones de &kde; toda la funcionalidad completa del motor de búsqueda en &khelpcenter; está desactivada, y las preferencias en este módulo de &kcontrol; no tendrán efecto. Esperamos volver a recuperarlo en una versión futura.</para
></note>

<para
>&kde; incluye una gran cantidad de documentación para aplicaciones y componentes. Aunque es posible navegar por los manuales hasta encontrar la información que está buscando, esto puede consumirle una gran cantidad de tiempo. Para facilitarle el trabajo, &kde; ofrece búsqueda completa de texto utilizando un programa llamado <application
>ht://dig</application
>. Funciona de un modo muy similar a los buscadores de la web, de hecho los buscadores que usted utiliza puede que lo usen también. Simplemente pulse sobre la pestaña <guilabel
>Buscar</guilabel
>en el &khelpcenter;, introduzca la palabra que está buscando, pulse <guibutton
>Buscar</guibutton
> y disfrute.</para>

<para
>Sin embargo, para poder utilizar esta propiedad, debe instalar <application
>ht://dig</application
> en su sistema y &kde; tiene que estar configurado para poder utilizarlo. Este módulo de control intenta ayudarle en esto último.Si usted no ha instalado <application
>ht://dig</application
> y no estaba incluido con su sistema operativo debe conseguir ht://dig por su cuenta. Eche una ojeada a <ulink url="http://www.htdig.org"
>la página de ht://dig</ulink
> sobre como descargarlo e instalarlo.</para>

<para
>Cuando usted inicia por primera vez el módulo, entrará en modo de sólo lectura. Para modificar sus preferencias, pulse sobre <guibutton
>Modo de administrador</guibutton
>. Si usted ha accedido como <systemitem class="username"
>root</systemitem
>, irá directamente al diálogo de modificación. Si no, &kde; le solicitará la contraseña del superusuario.</para>
<sect2 id="help-index-use"
> 

<title
>Uso</title
> 

<para
>Hay dos cosas importantes que indicarle a &kde; de modo que pueda utilizar el motor de búsqueda de texto completo:</para>

<itemizedlist
> <listitem
><para
>el lugar donde encontrar los programas <application
>ht://dig</application
> que KDE utiliza para la búsqueda de texto completo</para
></listitem
> <listitem
><para
>donde buscar</para
></listitem
> </itemizedlist>

<sect3 id="help-index-use-progs">

<title
>Los programas <application
>ht://dig</application
></title>

<para
> Hay tres programas que &kde; necesita y que incluye <application
>ht://dig</application
>: <command
>htdig</command
>, <command
>htsearch</command
> y <command
>htmerge</command
>. Para cada programa usted debe proporcionar la ruta completa incluyendo el nombre del programa, por ejemplo: <filename class="directory"
>/usr/bin/htdig</filename
>.</para
> 

<para
>El lugar donde se instalan estos programas depende de su sistema operativo o de su distribución. Sin embargo, hay algunas posibilidades bastante frecuentes que puede intentar:</para>

<itemizedlist
> <listitem
><para
><command
>htdig</command
> y <command
>htmerge</command
> se encuentran habitualmente en <filename class="directory"
>/usr/bin/</filename
> o en <filename class="directory"
>/usr/local/www/htdig/bin/</filename
>.</para
></listitem
> <listitem
><para
>el comando <command
>htsearch</command
> se encuntra frecuentemente en un subdirectorio denominado <filename class="directory"
>cgi-bin</filename
>, por ejemplo <filename class="directory"
>/usr/local/httpd/cgi-bin/</filename
>.</para
> </listitem
> </itemizedlist>

<tip
><para
>Para buscar donde está instalado por ejemplo <command
>htdig</command
> usted siempre puede introducir <command
>whereis htdig</command
> en la consola. <command
>whereis</command
> buscará el comando específico en las rutas estándar de directorios de ejecutables. Sin embargo, directorios como <filename class="directory"
>cgi-bin</filename
> no están frecuentemente en la ruta estándar de ejecutables.</para
></tip>

</sect3>

<sect3 id="help-index-use-scope">
<title
>Ambito y rutas de búsqueda</title>

<para
>En esta sección usted puede elegir qué recursos de ayuda deberían ser indexados, &ie; deben estar disponibles para ser encontrados por el buscador.</para>

<para
>En el marco <guilabel
>Ambito</guilabel
> puede seleccionar algunos recursos típicos que desea que estén indexados, &ie; los archivos de ayuda de &kde; y la información ofrecida por los comandos <command
>man</command
> e <command
>info</command
>. Advierta que algunos de ellos pueden estar desactivados, lo que significa que no se ha añadido soporte para ellos todavía.</para>

<para
>Quizá usted dispone de archivos adicionales a los que quiere acceder utilizando  la propiedad de búsqueda de texto completo de &khelpcenter;. Por ejemplo, puede tener una referencia <acronym
>HTML</acronym
> instalada en <filename
>/home/juan/docs/mistml</filename
>. Si añade esta ruta a la lista de rutas de búsqueda adicionales usted hace que esta documentación esté disponible también al buscador de &khelpcenter;. Simplemente pulse sobre el botón <guibutton
>Añadir</guibutton
> y un cuadro de diálogo le solicitará un directorio adicional de búsqueda. Seleccione <filename class="directory"
>/home/juan/docs/mishtml</filename
> y pulse <guibutton
>Aceptar</guibutton
>. Para eliminar una ruta adicional de búsqueda, simplemente seleccionela y pulse <guibutton
>Borrar</guibutton
>.</para>

<important
><para
>Sus cambios al ámbito y las rutas adicionales de búsqueda no tendrán efecto si no pulsa sobre el botón <guibutton
>Construir índice</guibutton
>.</para
></important>
</sect3>

</sect2>

<sect2 id="help-index-author">
<title
>Sección de autores</title>
<para
>Sección escrita por: Jost Schenck <email
>jost@schenck.de</email
></para>
<para
>Actualización menor por Mike McBride <email
>mpmcbride7@yahoo.com</email
></para>
</sect2>
</sect1>
</article>

