<chapter id="help-system-user-manual">
<docinfo>
<date>05/01/2001</date>
<releaseinfo>1.94.00</releaseinfo>
</docinfo>
<title>Manual del usuario del sistema de ayuda de KDE</title>
<anchor id="help">

<sect1 id="help-introduction">
<title>Sistema de ayuda de KDE</title>

<para>El sistema de ayuda de KDE est&aacute; diseñado para 
acceder a los sistemas de ayuda comunes de UNIX 
(<application>man</application> e <application>info</application>),
as&iacute; como a la documentaci&oacute;n nativa de KDE (<abbrev>HTML</abbrev>). </para>

<para>Todas las aplicaciones base de KDE est&aacute;n completamente documentadas,
gracias al esfuerzo del equipo de documentaci&oacute;n. Si usted desea colaborar
por favor escriba al coordinador de la documentaci&oacute;n, Mike McBride, en 
<email>mpmcbride7@yahoo.com</email> para que le informe. No se requiere
experiencia, simplemente entusiasmo y paciencia. Si desea ayudar en las 
traducciones de la documentaci&oacute;n de KDE a su lengua nativa el corrdinador 
de los equipos de traducci&oacute;n es &eacute;ric Bischoff
<email>ebisch@cybercable.tm.fr</email>, y él también agradecer&iacute;a su ayuda.
Se puede encontrar m&aacute;s informaci&oacute;n, incluyendo los coordinadores para 
los equipos de cada lengua, en 
<ulink url="http://i18n.kde.org">el servidor web de 
internacionalizaci&oacute;n</ulink>, 
y en la secci&oacute;n <link linkend="contact">contactos</link> de este 
documento.</para>

<sect2 id="installation">
<title>Instalaci&oacute;n</title>

<para>El Centro de Ayuda de KDE es una parte integral de la instalaci&oacute;n de KDE 
b&aacute;sico, y se instala
con cada copia de KDE.  Se puede encontrar en el paquete kdebase, y est&aacute; 
disponible desde <ulink url="ftp://ftp.kde.org/">el servidor FTP de KDE</ulink>
o en el paquete kdebase de su distribuci&oacute;n linux.</para>

</sect2>
</sect1>

<sect1 id="invoking-help">
<title>Invocando ayuda</title>

<para>El Centro de Ayuda de KDE se puede invocar de diferentes modos:</para>

<variablelist>
<varlistentry>
<term>Desde el men&uacute; de <guimenu>Ayuda</guimenu></term>
<listitem><para>El m&aacute;s com&uacute;n ser&aacute; desde cada aplicaci&oacute;n.
Pulse <menuchoice><guimenu>Ayuda</guimenu>
<guimenuitem>Contenido</guimenuitem></menuchoice> para abrir el archivo de 
ayuda de la aplicaci&oacute;n, en la p&aacute;gina de Contenidos.</para></listitem>
</varlistentry>

<varlistentry>
<term>Desde el men&uacute; <guimenu>K</guimenu></term>
<listitem><para>Pulse sobre la <guiicon>K</guiicon> grande del panel, y 
seleccione <guimenuitem>Ayuda</guimenuitem> para abrir el Centro de 
Ayuda, comenzando
en la p&aacute;gina de bienvenida por defecto.</para></listitem>
</varlistentry>

<varlistentry>
<term>Desde el panel</term>
<listitem><para>El panel <application>Kicker</application> contiene por 
defecto un icono denominado Centro de Ayuda. Pulsandolo, aparece la p&aacute;gina de 
bienvenida por defecto.</para></listitem>
</varlistentry>

<varlistentry>
<term>Desde la l&iacute;nea de comandos</term>
<listitem><para>El Centro de Ayuda puede ser iniciado utilizando una 
<abbrev>URL</abbrev>
para mostrar un archivo. Las <abbrev>URL</abbrev>s han sido a&ntilde;adidas para
las p&aacute;ginas de <application>Info</application>
y <application>man</application> tambi&eacute;n. Usted las puede utilizar como 
sigue:</para>

<variablelist>
<varlistentry>
<term>Un archivo de aplicaci&oacute;n de ayuda</term>
<listitem><para><command>khelpcenter
<option>help:/<replaceable>kedit</replaceable></option></command></para>
<para>Abre el archivo de ayuda de <application>Kedit</application>, secci&oacute;n de
Contenido.</para></listitem>
</varlistentry>

<varlistentry>
<term>Una url local</term>
<listitem><para><command>khelpcenter
<option><replaceable>file:/usr/local/src/qt/html/index.html</replaceable></option></command></para></listitem>
</varlistentry>

<varlistentry>
<term>Una p&aacute;gina de manual</term>
<listitem><para><command>khelpcenter
<option>man:/<replaceable>strcpy</replaceable></option></command></para></listitem>
</varlistentry>

<varlistentry>
<term>Una p&aacute;gina de informaci&oacute;n</term>
<listitem><para><command>khelpcenter 
<option>info:/<replaceable>gcc</replaceable></option></command></para></listitem>
</varlistentry>
</variablelist>

<para>Invocando <command>khelpcenter</command> sin par&aacute;metros abre por
defecto la p&aacute;gina de bienvenida al sistema de ayuda.</para></listitem>
</varlistentry>

</variablelist>
</sect1>

<!-- Interface - Basics, using Konqueror -->
<sect1 id="interface-basics">
<title>El interfaz del Centro de Ayuda</title>

<para>El interfaz del Centro de Ayuda consiste en dos paneles de informaci&oacute;n, 
empotrados
en la ventana de &konq;.  Esta propiedad hace que la navegaci&oacute;n sea simple e
intuitiva y que permita utlizar las barras de herramientas de &konq;, como
si se tratase de una p&aacute;gina web. Adem&aacute;s, la mayor&iacute;a de los documentos disponen
de sus propias barras de navegaci&oacute;n, permitiendole moverse secuencialmente
por el documento, utilizando los enlaces <guilabel>Anterior</guilabel> y 
<guilabel>Previo</guilabel>, o moviendose de una manera menos estructurada, 
utilizando hiperenlaces. Los enlaces le pueden llevar otras secciones del 
documento, o a un 
documento diferente, y usted puede utilizar los iconos de la barra de tareas, 
<guiicon>Atr&aacute;s</guiicon> (Flecha a la izquierda) o
<guiicon>Adelante</guiicon> (Flecha a la derecha) para moverse a trav&eacute;s del 
documento que ha visualizado en esta sesi&oacute;n.</para>

<para>Los dos paneles muestran el contenido del sistema de ayuda y a los 
propios archivos, el primero a la izquierda y el segundo a la derecha.</para>

<sect2 id="contents-pane">
<title>El panel de <guilabel>Contenidos</guilabel></title>

<para>El panel de <guilabel>Contenidos</guilabel>en el Centro de Ayuda se 
muestra a la 
izquierda de la ventana. Como ya habr&aacute; supuesto, puede desplazar la barra de 
divisi&oacute;n para poder ver con comodidad los contenidos de cada panel.</para>

<para>El panel de <guilabel>Contenidos</guilabel> est&aacute; subdividido en dos 
solapas, una que contiene un <link linkend="contents-menu">men&uacute;</link> 
mostrando un &iacute;ndice con toda la informaci&oacute;n de ayuda disponible en el Centro 
de Ayuda de KDE y 
otro que le permite <link linkend="search">Buscar</link> informaci&oacute;n 
espec&iacute;fica.</para>

<sect3 id="contents-menu">
<title>El men&uacute; de <guilabel>Contenidos</guilabel></title>

<para>Los <guilabel>Contenidos</guilabel> incluyen las siguientes 
entradas:</para>

<variablelist>
<varlistentry>
<term><guilabel>Introducci&oacute;n</guilabel></term>
<listitem><para>Bienvenido a KDE - una introducci&oacute;n al Entorno de Escritorio 
K.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Introducci&oacute;n a KDE</guilabel></term>
<listitem><para>La gu&iacute;a r&aacute;pida de inicio de KDE.  Incluye una excursi&oacute;n al 
interfaz de KDE y ayuda espec&iacute;fica y trucos de como trabajar con mayor 
provecho con KDE.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>El manual del usuario de KDE</guilabel></term>
<listitem><para>El manual del usuario de KDE es una exploraci&oacute;n en profundidad 
de KDE, que incluye la instalaci&oacute;n, configuraci&oacute;n, personalizaci&oacute;n y 
uso.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Manuales de aplicaciones</guilabel></term>
<listitem><para>Documentaci&oacute;n de las aplicaciones nativas de KDE.
Todas las aplicaciones de KDE tienen documentaci&oacute;n en <abbrev>HTML</abbrev>. 
Esta secci&oacute;n muestra un listado de todas las aplicaciones de KDE
con una descripci&oacute;n sucinta y un enlace a la documentaci&oacute;n completa de la 
aplicaci&oacute;n.</para>
<para>Las aplicaciones se muestran en una estructura en forma de &aacute;rbol que 
recuerda la estructura del men&uacute; <guimenu>K</guimenu>, facilitando encontrar la 
aplicaci&oacute;n que se est&aacute; buscando.</para></listitem> 
</varlistentry>

<varlistentry>
<term>P&aacute;gina de manual del sistema</term>
<listitem><para>Las p&aacute;ginas de manual de UNIX (man) es el formato tradicional 
para la ayuda disponible en su ordenador para sistemas Unix. La mayor parte de 
los programas del sistema disponen de una p&aacute;gina de manual. Adem&aacute;s existen 
p&aacute;ginas de manual para funciones de programas y formatos de 
archivos.</para></listitem>
</varlistentry>

<varlistentry>
<term>Directorio de informaci&oacute;n del sistema</term>
<listitem><para>La documentaci&oacute;n TexInfo es utilizada por muchas aplicaciones 
GNU, incluyendo <application>gcc</application> (el compilador  C/C++),
<application>emacs</application>, y muchas otras.</para></listitem>
</varlistentry>

<varlistentry>
<term>Las P.F. de KDE</term>
<listitem><para>Preguntas frecuentes sobre KDE, y sus 
respuestas.</para></listitem>
</varlistentry>

<varlistentry>
<term>KDE en la web</term>
<listitem><para>Enlaces de KDE en la web, el lugar oficial de KDE, y otros 
lugares &uacute;tiles.</para></listitem>
</varlistentry>

<varlistentry>
<term>Informaci&oacute;n de contacto</term>
<listitem><para>Informaci&oacute;n de como contactar a los desarrolladores de KDE, y 
de como suscribirse a las listas de correo de KDE.</para></listitem>
</varlistentry>

<varlistentry>
<term>Colaborando con KDE</term>
<listitem><para>Como colaborar, y como involucrarse.</para></listitem>
</varlistentry>
</variablelist>

</sect3>

<sect3 id="search">
<title>La solapa de <guilabel>Buscar</guilabel></title>

<para>Buscar requiere que usted haya instalado en su sistema la aplicaci&oacute;n 
<application>ht://Dig</application>. La informaci&oacute;n de c&oacute;mo instalar y 
configurar el &iacute;ndice de busqueda est&aacute; incluida en la documentaci&oacute;n.  La 
configuraci&oacute;n del &iacute;ndice de b&uacute;squeda se realiza desde el <application>Centro 
de Control de KDE</application>, eligiendo
<menuchoice><guisubmenu>Ayuda</guisubmenu><guimenuitem>Índice</guimenuitem></menuchoice>,
y en este m&oacute;dulo aparecer&aacute; ayuda detallada.</para>

<para>Para los prop&oacute;sitos de este documento, asumiremos que ya ha configurado 
las opciones.</para>

<para>La b&uacute;squeda a trav&eacute;s de los archivos de ayuda es bastante intuitiva, 
introduzca la(s) palabra(s) que desea buscar en la caja de texto, elija sus 
opciones (si hay alguna), y pulse <guibutton>Buscar</guibutton>. Los 
resultados se mostrar&aacute;n en el panel de la derecha.</para>

<para>Las opciones disponibles son:</para>

<variablelist>
<varlistentry>
<term><guilabel>M&eacute;todo</guilabel></term>
<listitem><para>Decida el m&eacute;todo de b&uacute;squeda cuando utilice varias palabras. 
Si elige 
<guilabel>y</guilabel>, s&oacute;lo se mostrar&aacute;n resultados si todos los t&eacute;rminos 
buscados estaban incluidos en la p&aacute;gina. <guilabel>o</guilabel> mostrar&aacute; 
resultados si <emphasis>alguno</emphasis> de los t&eacute;rminos buscados son 
encontrados, y <guilabel>booleano</guilabel> le permite buscar utilizando una 
combinaci&oacute;n.</para>
<para>La sintaxis booleana le permite utilizar los operadores 
<literal>AND</literal>, <literal>OR</literal> y <literal>NOT</literal> para 
crear b&uacute;squedas complejas.
Algunos ejemplos:</para>
<variablelist>
<varlistentry>
<term><userinput>perro AND gato</userinput></term>
<listitem><para>Busca p&aacute;ginas que tengan las palabras
<userinput>gato</userinput> y <userinput>perro</userinput> en ellas. Las 
p&aacute;ginas con s&oacute;lo una de ellas no se mostrar&aacute;n en los resultados de la 
b&uacute;squeda.</para></listitem>
</varlistentry>
<varlistentry>
<term><userinput>gato NOT perro</userinput></term>
<listitem><para>Busca p&aacute;ginas con la palabra <userinput>gato</userinput> pero 
s&oacute;lo devuelve aquellas que no tengan la palabra <userinput>perro</userinput>. 
</para></listitem>
</varlistentry>
<varlistentry>
<term><userinput>gato OR (perro NOT nariz)</userinput></term>
<listitem><para>Busca p&aacute;ginas que contengan <userinput>gato</userinput>, y
p&aacute;ginas que contengan <userinput>perro</userinput> pero que no contengan 
<userinput>nariz</userinput>. Las p&aacute;ginas que contuvieran 
<userinput>gato</userinput> y <userinput>nariz</userinput> se mostrar&iacute;an en 
los resultados, y las p&aacute;ginas que contuvieran las tres palabras 
no.</para></listitem> 
</varlistentry>
</variablelist>
<para>Si la b&uacute;squeda no devuelve los resultados que espera, compruebe 
cuidadosamente que no ha excluido la palabra buscada con un 
<literal>NOT</literal> err&aacute;tico
o con un par&eacute;ntesis p&eacute;rdido.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>M&aacute;ximos resultados</guilabel></term>
<listitem><para>Determina el m&aacute;ximo n&uacute;mero de resultados de la 
b&uacute;squeda.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Formato</guilabel></term>
<listitem><para>Decide si usted desea simplemente un enlace corto a la p&aacute;gina 
que contiene los t&eacute;rminos de b&uacute;squeda, o un resumen m&aacute;s 
largo.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Ordenar</guilabel></term>
<listitem><para>Ordena los resultados por <guilabel>Puntuaci&oacute;n</guilabel> 
(seg&uacute;n se ajusten los resultados a los terminos buscados),
alfab&eacute;ticamente por
<guilabel>T&iacute;tulo</guilabel> o por <guilabel>Fecha</guilabel>.  Seleccionando
<guilabel>Orden inverso</guilabel> en la cajita de selecci&oacute;n, invierte el 
orden de los resultados.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Actualizar &iacute;ndice</guilabel></term>
<listitem><para>Actualiza el &iacute;ndice de b&uacute;squeda, para incorporar nuevos 
documentos, o por si su base de datos est&aacute; incompleta o da&ntilde;ada.  Esto puede 
llevar cierto tiempo.</para></listitem>
</varlistentry>
</variablelist>
</sect3>
</sect2>

<sect2 id="man-and-info">
<title>Las secciones de p&aacute;ginas de <application>manual</application> y 
p&aacute;ginas <application>info</application></title>

<para>Las p&aacute;ginas del manual son las p&aacute;ginas estandard de manual de Unix, y se 
han utilizado durante muchos a&ntilde;os en muchos sistemas operativos. Son 
extremadamente detalladas, y son el mejor lugar para obtener informaci&oacute;n de la 
mayor parte de los comandos y de las aplicaciones de Linux. Cuando alguien 
habla de <quote>RTFM</quote>, el Manual al que se refiere es habitualmente la 
p&aacute;gina de manual.</para>

<para>A pesar de ello las p&aacute;ginas del manual no son perfectas. Suelen ser 
detalladas, pero extremadamente t&eacute;cnicas, y frecuentemente escritas por los 
desarrolladores y para los desarrolladores. En algunos casos esto las 
convierte en aridas, siendo incluso incomprensibles para muchos 
usuarios.
Sin embargo, son la mejor, y muy frecuentemente la &uacute;nica, fuente de 
informaci&oacute;n s&oacute;lida para las aplicaciones gobernadas por un l&iacute;nea de 
comandos.</para>

<para>Si alguna vez se ha preguntado que significado tiene el n&uacute;mero que a 
veces se introduce despu&eacute;s de escribir man, &eacute;ste se refiere a la secci&oacute;n del 
manual a la que pertenece el t&eacute;rmino que se busca. Advertir&aacute; que el Centro de 
Ayuda utiliza n&uacute;meros para dividir las numerosas p&aacute;ginas de los  manuales en 
secciones de modo que la b&uacute;squeda de la informaci&oacute;n sea m&aacute;s 
sencilla.</para>

<para>Tambi&eacute;n est&aacute;n accesibles las p&aacute;ginas de Info, que se pretend&iacute;a que 
sustituyesen a las de los manuales. Algunos programadores de aplicaciones 
ya no actualizan las p&aacute;ginas de manuales, de modo que si para dichas 
aplicaciones existe una p&aacute;gina del manual y una de info, &eacute;sta &uacute;ltima ser&aacute; 
probablemente la m&aacute;s reciente. Sin embargo la mayor parte de las aplicaciones 
disponen de unas o de las otras. Si est&aacute; buscando ayuda para una aplicaci&oacute;n 
<abbrev>GNU</abbrev>, lo m&aacute;s probable es que la encuentre en una p&aacute;gina info y 
no del manual.</para>

<sect3 id="navigation">
<title>Navegando por las p&aacute;ginas de <application>Info</application></title>

<para>Los documentos info est&aacute;n organizados jerarquicamente de modo que cada 
p&aacute;gina se denomina un nodo. Todos los documentos info tienen un nodo
<guilabel>Superior</guilabel>,
<abbrev>p. ej.</abbrev> la p&aacute;gina de apertura. Siempre puede volver al 
<guilabel>Comienzo</guilabel> de un documento pulsando 
<guilabel>Inicio</guilabel>.</para>

<para><guibutton>Anterior</guibutton> y <guibutton>Siguiente</guibutton> se 
usan 
para moverse a las p&aacute;ginas previa y siguiente del nivel en el que se 
encuentre.</para>

<para>Pulsar en un elemento del men&uacute; en un documento sirve para moverse a un 
nivel inferior al que se encuentra. Puede subir un nivel pulsando
<guibutton>Subir</guibutton>.</para>

<para>Las p&aacute;ginas del manual se tratan de modo similar a las de info, 
siendo el nodo superior el &iacute;ndice de la secci&oacute;n y estando cada p&aacute;gina 
del manual un nivel por debajo. Las entradas del manual ocupan una 
p&aacute;gina.</para>

</sect3>
</sect2>
</sect1>

<sect1 id="credits">
<title>Cr&eacute;ditos y Licencias</title>

<para>Centro de Ayuda de KDE</para>

<para>Originalmente desarrollado por Matthias Elter 
<email>me@kde.org</email></para>
<para>Actualmente lo mantiene Matthias Hoelzer-Kluepfel
<email>mhk@kde.org</email></para>

&underFDL;
&underGPL;

</sect1>
</chapter>





