<chapter id="help-system-user-manual">
<chapterinfo>
<date
>2002-02-03</date>
<releaseinfo
>0.08.00</releaseinfo>
</chapterinfo>
<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á diseñado para acceder de modo sencillo a los sistemas de ayuda comunes de &UNIX; (<application
>man</application
> e <application
>info</application
>), así como a la documentación nativa de &kde; (&XML;). </para>
	
<para
> Todas las aplicaciones base de &kde; están completamente documentadas, gracias a los esfuerzos del equipo de documentación. Si desea ayudar, por favor escriba a la coordinadora de documentación, Lauri Watts, en <email
>lauri@kde.org</email
> para que le informe. No se requiere experiencia, simplemente entusiamo y paciencia. </para>

<para
> Si desea ayudar en la traducción de la documentación de &kde; a su lengua nativa, el coordinador de traducciones es Thomas Diehl, <email
>thd@kde.org</email
>, y el también agradecería su ayuda. Se puede encontrar más información, incluyendo los nombres de los coordinadores para cada idioma, en la <ulink url="http://i18n.kde.org"
>web de internacionalización</ulink
>, y en la sección de <link linkend="contact"
>Contactos</link
> de este documento. </para>

<sect2 id="installation">
<title
>Instalación</title>

<para
> El &khelpcenter; es una parte integral de la instalación básica &kde;, y se instala con cada copia de &kde; Se puede encontrar en el paquete kdebase, y está disponible en &kde-ftp; o en el paquete kdebase de su distribución linux. </para>

</sect2>
</sect1>

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

<para
> &khelpcenter; se puede invocar de diferentes modos: </para>

<variablelist
> <varlistentry
> <term
>Desde el menú <guimenu
>Ayuda</guimenu
> </term
> <listitem
> <para
> El más común será desde cada aplicación. Pulse <menuchoice
><guimenu
>Ayuda</guimenu
> <guimenuitem
>Contenido</guimenuitem
></menuchoice
> para abrir el archivo de ayuda de la aplicación, en la página de contenidos. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
>Desde el menú <guimenu
>K</guimenu
></term
> <listitem
> <para
> Pulse sobre la <guiicon
>K</guiicon
> grande del panel, y seleccione <guimenuitem
>Ayuda</guimenuitem
> para abrir &khelpcenter;, comenzando en la página de bienvenida predeterminada. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
>Desde el panel</term
> <listitem
> <para
> El panel &kicker; contiene un icono predefinido para invocar &khelpcenter;. Se mostrará de nuevo la página de bienvenida por omisión. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
>Desde la línea de comandos</term
> <listitem
> <para
> &khelpcenter; puede ser iniciado utilizando una &URL; para mostrar un archivo. Las &URL;s han sido añadidas para las páginas de<command
>info</command
> y <command
>man</command
> también. Usted las puede utilizar como sigue: </para
> <variablelist
> <varlistentry
> <term
>Un archivo de aplicación de ayuda</term
> <listitem
> <para
> <command
>khelpcenter</command
> <option
>help:/<replaceable
>kedit</replaceable
></option
> </para
> <para
> Abre el archivo de ayuda de &kedit; sección de contenidos. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
>Una &URL; local</term
> <listitem
><para
> <command
>khelpcenter</command
> <option
>file:/ <replaceable
>usr/local/src/qt/html/index.html</replaceable
></option
> </para
> </listitem
> </varlistentry
> <varlistentry
> <term
>Una página de manual</term
> <listitem
> <para
> <command
>khelpcenter</command
> <option
>man:/<replaceable
>strcpy</replaceable
></option
> </para
> </listitem
> </varlistentry
> <varlistentry
> <term
>Una página de información</term
> <listitem
> <para
> <command
>khelpcenter</command
> <option
>info:/<replaceable
>gcc</replaceable
></option
> </para
> </listitem
> </varlistentry
> </variablelist
> <para
> Invocando <command
>khelpcenter</command
> sin parámetros abre por omisión la página de bienvenida al sistema de ayuda. </para
> </listitem
> </varlistentry
> </variablelist>
</sect1>

<sect1 id="interface-basics">
<title
>El interfaz de &khelpcenter;</title>

<para
> El interfaz de &khelpcenter; contiene dos pestañas de información. </para>

<para
> La barra de herramientas y los menús se explican más adelante en la sección <xref linkend="menu-and-toolbar-ref"/>. </para>

<para
> Los documentos contienen sus propias herramientas de navegación, permitiendole moverse bien secuencialmente a través de un documento, usando los enlaces <guilabel
>Siguiente</guilabel
>, <guilabel
>Previo</guilabel
>, <guilabel
>Arriba</guilabel
> e <guilabel
>Inicio</guilabel
>, o moverse de un modo menos ordenado, utilizando hiperenlaces. </para>

<para
> Los enlaces le pueden llevar a otras partes del mismo documento, o a un documento diferente, y puede utilizar los iconos <guiicon
>Atrás</guiicon
> (flecha a la izquierda) o <guiicon
>Adelante</guiicon
> (flecha a la derecha) en la barra de herramientas para moverse a través de los documentos que haya visualizado en esta sesió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 &khelpcenter; se muestra a la izquierda de la ventana. Como ya habrá supuesto, puede desplazar la barra de división para poder ver con comodidad los contenidos de cada panel. </para
> 

<para
> El panel de <guilabel
>Contenidos</guilabel
> está subdividido en dos pestañas, una que contiene un <link linkend="contents-menu"
>menú</link
> mostrando un índice con toda la información de ayuda disponible en &khelpcenter; y otro que contiene .el <link linkend="kde-glossary"
>glosario</link
> de términos de &kde;. </para>

<sect3 id="contents-menu">
<title
>El menú de <guilabel
>contenidos</guilabel
></title>

<para
> Los <guilabel
>contenidos</guilabel
> incluyen las siguientes entradas predeterminadas: </para
> 

<variablelist
> <varlistentry
> <term
><guilabel
>Introducción</guilabel
></term
> <listitem
><para
>Bienvenido a &kde; - una introducción al entorno de escritorio KDE.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Introducción a &kde;</guilabel
></term
> <listitem
> <para
> La guía rápida de inicio de &kde;. Incluye una excursión al interfaz de &kde; y ayuda especí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ón en profundidad de &kde;, que incluye la instalación, configuración, personalización y uso. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Manuales de aplicaciones</guilabel
></term
> <listitem
> <para
> Documentación de las aplicaciones nativas de &kde; Todas las aplicaciones de &kde; tienen documentación en formato &XML;, que es convertida a <acronym
>HTML</acronym
>. Esta sección muestra un listado de todas las aplicaciones de &kde; con una descripción sucinta y un enlace a la documentación completa de la aplicación. </para
> <para
> Las aplicaciones se muestran en una estructura en forma de árbol que recuerda la estructura del menú <guimenu
>K</guimenu
>, facilitando encontrar la aplicación que se está buscando. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Páginas de manual de Unix</guilabel
></term
> <listitem
> <para
> Las pá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ágina de manual. Además existen páginas de manual para funciones de programas y formatos de archivos. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Explorar páginas info</guilabel
></term
> <listitem
> <para
> La documentació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
><guilabel
>Tutoriales</guilabel
></term
> <listitem
> <para
> Corto, basada en tareas o tutorías informativas. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Las PFs de &kde;.</guilabel
></term
> <listitem
> <para
> Preguntas frecuentes sobre &kde;, y sus respuestas. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>&kde; en la web</guilabel
></term
> <listitem
> <para
> Enlaces de &kde; en la web, el lugar oficial de &kde;, y otros lugares útiles. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Información de contacto</guilabel
></term
> <listitem
> <para
> Información de como contactar a los desarrolladores de &kde;, y de como suscribirse a los foros de discusión de &kde;. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Colaborando con &kde;</guilabel
></term
> <listitem
> <para
> Como colaborar, y como involucrarse. </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
>Las secciones de páginas de <application
>man</application
> y páginas <application
>info</application
></title>

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

<para
>Las páginas de man no son perfectas. Suelen ser detalladas, pero extremadamente técnicas, y frecuentemente escritas por los desarrolladores y para los desarrolladores. En algunos casos esto las convierte en áridas, siendo incluso incomprensibles para muchos usuarios. Sin embargo, son la mejor, y muy frecuentemente la única, fuente de información sólida para las aplicaciones gobernadas por un línea de comandos.</para>

<para
>Si alguna vez se ha preguntado que significado tiene el número que a veces se introduce después de escribir man, éste se refiere a la sección del manual a la que pertenece el término que se busca. Advertirá que &khelpcenter; utiliza números para dividir las numerosas páginas de los manuales en secciones de modo que la búsqueda de la información sea más sencilla, si simplemente está navegando.</para>

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

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

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

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

<para
>Pulsar en un elemento del menú 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áginas de man se tratan de modo similar a las de info, siendo el nodo superior el índice de la sección y estando cada página del manual un nivel por debajo. Las entradas del manual ocupan una página.</para>

</sect3>
</sect2>

<sect2 id="kde-glossary">
<title
>El glosario de &kde;.</title>

<para
> El glosario proporciona un lugar de referencia rápida, donde puede mirar las definiciones de palabras que le pueden resultar poco familiares. Estas incluyen aplicaciones y tecnologías específicas de &kde; o incluso términos informáticos de &UNIX; </para>

<para
> En el panel de la izquierda verá una vista de árbol, con dos posibilidades: <guilabel
>Alfabético</guilabel
> o <guilabel
>Por tema</guilabel
>. Ambas contienen las mismas entradas, ordenadas de modo diferente, para permitirle encontrar rápidamente el asunto de interés. </para>

<para
> Navegue por las vistas de árbol a la izquierda, y los elementos que seleccione se mostrarán en la derecha. </para>

</sect2>

<sect2 id="menu-and-toolbar-ref">
<title
>Los menús y la barra de herramienta</title>

<para
> &khelpcenter; tiene un interfaz mínimo, permitiendo concentrarse en obtener ayuda para no tener que aprender como usar el navegador de ayuda. </para>

<para
> Los iconos disponibles en la barra de herramientas son los que siguen: </para>

<variablelist
> <title
>Iconos de la barra de herramientas</title
> <varlistentry
> <term
><guiicon
>Atrás</guiicon
></term
> <listitem
> <para
>Ira a la página previa que está viendo.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guiicon
>Adelante</guiicon
></term
> <listitem
> <para
>Avanza una página. Este icono sólo es activo si ya ha utilizado el icono <guiicon
>Atrás</guiicon
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guiicon
>Imprimir</guiicon
></term
> <listitem
> <para
> Imprime los contenidos de la página visible actualmente. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guiicon
>Buscar</guiicon
></term
> <listitem
> <para
> Busca una palabra o palabras dento de la página actualmente visible </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guiicon
>Aumentar fuente</guiicon
></term
> <listitem
> <para
> Aumentar el tamaño del texto en el panel visualizador </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guiicon
>Disminuir fuente</guiicon
></term
> <listitem
> <para
> Disminuye el tamaño del texto en el panel visualizador. Este icono sólo está activado si previamente ha aumentado el texto. </para
> </listitem
> </varlistentry
> </variablelist>

<para
> Los menús contienen las siguientes entradas: </para>

<variablelist
> <varlistentry
> <term
><guimenu
>Archivo</guimenu
></term
> <listitem
> <variablelist
> <varlistentry
> <term
> <menuchoice
> <guimenu
>Archivo</guimenu
> <guimenuitem
>Imprimir...</guimenuitem
> </menuchoice
> </term
> <listitem
> <para
> Imprime los contenidos de la página visible actualmente. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
> <menuchoice
> <shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Archivo</guimenu
> <guimenuitem
>Salir</guimenuitem
> </menuchoice
> </term
> <listitem
> <para
> Cerrar y salir de &khelpcenter; </para
> </listitem
> </varlistentry
> </variablelist
> </listitem
> </varlistentry
> <varlistentry
> <term
><guimenu
>Editar</guimenu
></term
> <listitem
> <variablelist
> <varlistentry
> <term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>A</keycap
></keycombo
></shortcut
> <guimenu
>Editar</guimenu
> <guimenuitem
>Seleccionar todo</guimenuitem
> </menuchoice
> </term
> <listitem
> <para
> Selecciona todo el texto en la página actual. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>F</keycap
></keycombo
></shortcut
> <guimenu
>Editar</guimenu
> <guimenuitem
>Buscar...</guimenuitem
> </menuchoice
> </term
> <listitem
> <para
> Busca una palabra o palabras en la página actualmente visible. </para
> </listitem
> </varlistentry
> </variablelist
> </listitem
> </varlistentry
> <varlistentry
> <term
><guimenu
>Ver</guimenu
></term
> <listitem
> <variablelist
> <varlistentry
> <term
><menuchoice
> <guimenu
>Ver</guimenu
> <guimenuitem
>Ver fuente del documento</guimenuitem
> </menuchoice
> </term
> <listitem
> <para
> Permite ver la fuente <acronym
>HTML</acronym
> de la página actualmente visualizada. </para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenu
>Ver</guimenu
> <guisubmenu
>Fijar codificación</guisubmenu
> </menuchoice
> </term
> <listitem
> <para
> Cambia la codificación de la página actual. Normalmente, la opción predeterminada <guimenuitem
>Auto</guimenuitem
> debería ser suficiente, pero si tiene problemas viendo páginas escritas en idiomas diferentes del inglés, puede necesitar elegir una codificación específica en este menú. </para
> </listitem
> </varlistentry
> </variablelist
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenu
>Ir</guimenu
> <guimenuitem
>Atrás</guimenuitem
></menuchoice
></term
> <listitem
> <para
>Ir a la página previa a la que está viendo.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenu
>Ir</guimenu
> <guimenuitem
>Adelante</guimenuitem
> </menuchoice
></term
> <listitem
> <para
>Si ya se ha movido previamente con el icono hacia atrás o la entrada de menú, puede volver hacia delante de nuevo con esta entrada de menú.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenu
>Ir</guimenu
> <guimenuitem
>...</guimenuitem
> </menuchoice
></term
> <listitem
> <para
>Al fondo del menú <guimenu
>Ir</guimenu
>, encontrará una lista histórica de las últimas páginas que ha mirado. Seleccionando una de ellas puede volver ella.</para
> </listitem
></varlistentry
></variablelist>

</sect2>

</sect1>

<sect1 id="credits">
<title
>Créditos y licencias</title>

<para
>&khelpcenter;</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>


