2002-02-03
0.08.00

# Manual de usuario del sistema de ayuda de &kde;

## Sistema de ayuda de &kde;

El sistema de ayuda de &kde; está diseñado para acceder de modo sencillo a los sistemas de ayuda comunes de &UNIX; (man e info), así como a la documentación nativa de &kde; (&XML;).

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 lauri@kde.org para que le informe. No se requiere experiencia, simplemente entusiamo y paciencia.

Si desea ayudar en la traducción de la documentación de &kde; a su lengua nativa, el coordinador de traducciones es Albert Astals Cid, aacid@kde.org, y también agradecerá su ayuda. Se puede encontrar más información, incluyendo los nombres de los coordinadores para cada idioma, en la web de internacionalización, y en la sección de Contactos de este documento.

### Instalación

&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 sistema operativo.

## Invocando ayuda

&khelpcenter; se puede invocar de diferentes modos:

Desde el menú Ayuda

  Lo más común será que lo realice desde cada aplicación. Pulse Ayuda Contenido para abrir el archivo de ayuda de la aplicación en la página de contenidos.

Desde el menú K

  Pulse sobre la K grande del panel y seleccione Ayuda para abrir &khelpcenter;, comenzando en la página de bienvenida predeterminada.

Desde el panel

  El panel &kicker; contiene un icono predefinido para invocar &khelpcenter;. Se mostrará de nuevo la página de bienvenida predeterminada.

Desde la línea de órdenes

  &khelpcenter; puede ser iniciado utilizando una &URL; para mostrar un archivo. Las &URL;s han sido añadidas para las páginas `info` y `man` también. Usted las puede utilizar de la siguiente forma:

  Un archivo de aplicación de ayuda:

    `khelpcenter` `help:/kedit`

    Abre el archivo de ayuda de &kedit; sección de contenidos.

  Una &URL; local:

    `khelpcenter` `file:/ usr/local/src/qt/html/index.html`

  Una página de manual:

    `khelpcenter` `man:/strcpy`

  Una página de información:

    `khelpcenter` `info:/gcc`

  Invocando `khelpcenter` sin parámetros abre de manera predeterminado la página de bienvenida al sistema de ayuda.

## El interfaz de &khelpcenter;

El interfaz de &khelpcenter; contiene dos pestañas de información.

La barra de herramientas y los menús se explican más adelante en la sección .

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

Los enlaces le pueden llevar a otras partes del mismo documento o a un documento diferente y puede utilizar los iconos Atrás (flecha a la izquierda) o Adelante (flecha a la derecha) en la barra de herramientas para moverse a través de los documentos que haya visualizado en esta sesión.

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.

### El panel de contenidos

El panel de contenidos 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.

El panel de Contenidos está subdividido en dos pestañas, una que contiene un menú mostrando un índice con toda la información de ayuda disponible en &khelpcenter; y otro que contiene el glosario de términos de &kde;.

#### El menú de contenidos

Los contenidos incluyen las siguientes entradas predeterminadas:

Introducción

  Bienvenido a &kde; - una introducción al entorno de escritorio KDE.

Introducción a &kde;

  La guía rápida de inicio de &kde;. Incluye una excursión al interfaz de &kde; y ayuda específica y trucos de cómo trabajar con mayor provecho con &kde;.

El manual del usuario de &kde;

  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.

Manuales de aplicaciones

  Documentación de las aplicaciones nativas de &kde; Todas las aplicaciones de &kde; tienen documentación en formato &XML;, que es convertida a HTML. 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.

  Las aplicaciones se muestran en una estructura en forma de árbol que recuerda la estructura del menú K, facilitando encontrar la aplicación que se está buscando.

Páginas de manual de &UNIX;

  Las páginas de manual de &UNIX; (man) constituyen 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.

Explorar páginas info

  La documentación TexInfo es utilizada por muchas aplicaciones &GNU;, incluyendo gcc (el compilador C/C++), emacs y muchas otras.

Tutoriales

  Corto, basada en tareas o tutorías informativas.

Las PFs de &kde;.

  Preguntas frecuentes sobre &kde; y sus respuestas.

&kde; en la web

  Enlaces de &kde; en la web, el sitio oficial de &kde; y otros lugares útiles.

Información de contacto

  Información sobre cómo contactar con los desarrolladores de &kde; y de cómo suscribirse a las listas de correo de &kde;.

Colaborando con &kde;

  Cómo colaborar y cómo involucrarse.

### Las secciones páginas man y páginas info

Las páginas de 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 las órdenes y de las aplicaciones de &UNIX;. Cuando alguien habla de «RTFM», el manual al que se refiere es habitualmente la página man.

Las páginas man no son perfectas. Suelen ser detalladas, pero extremadamente técnicas y frecuentemente escritas por y para los desarrolladores. En algunos casos ésto 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 de la línea de órdenes.

Si alguna vez se ha preguntado que significado tiene que la gente en ocasiones escriba cosas como man(1), 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.

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.

#### Navegando por las páginas Info

Los documentos info están organizados jerárquicamente de modo que cada página se denomina un nodo. Todos los documentos info tienen un nodo de Inicio, &ie;, la página de apertura. Siempre puede volver al Inicio de un documento pulsando Inicio.

Anterior y Siguiente se usan para moverse a las páginas anterior y siguiente del nivel en el que se encuentre.

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 Subir.

Las páginas man se tratan de modo similar a las 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.

### El glosario de &kde;

El glosario proporciona un lugar de referencia rápida en el que poder mirar las definiciones de palabras que le puedan resultar poco familiares. Éstas incluyen aplicaciones y tecnologías específicas de &kde; o incluso términos informáticos de &UNIX;.

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

Navegue por las vistas de árbol a la izquierda y los elementos que seleccione se mostrarán a la derecha.

### Los menús y la barra de herramientas

&khelpcenter; tiene un interfaz mínimo, permitiendo concentrarse en obtener ayuda para no tener que aprender cómo usar el navegador de ayuda.

Los iconos disponibles en la barra de herramientas son los siguientes:

#### Iconos de la barra de herramientas

Atrás

  Irá a la página anterior que se estuviera viendo.

Adelante

  Avanza una página. Este icono sólo estará activo si ya ha utilizado el icono Atrás.

Imprimir

  Imprime los contenidos de la página visible actualmente.

Buscar

  Busca una palabra o palabras dento de la página actualmente visible.

Aumentar fuente

  Aumentar el tamaño del texto en el panel visualizador.

Disminuir fuente

  Disminuye el tamaño del texto en el panel visualizador. Este icono sólo está activado si previamente ha aumentado el texto.

Los menús contienen las siguientes entradas:

Archivo
  Archivo Imprimir...

    Imprime los contenidos de la página visible actualmente.

  &Ctrl;Q Archivo Salir

    Cerrar y salir de &khelpcenter;.

Editar
  &Ctrl;A Editar Seleccionar todo

    Selecciona todo el texto de la página actual.

  &Ctrl;F Editar Buscar...

    Busca una palabra o palabras en la página actualmente visible.

Ver
  Ver Ver fuente del documento

    Permite ver la fuente HTML de la página actualmente visualizada.

  Ver Fijar codificación

    Cambia la codificación de la página actual. Normalmente, la opción predeterminada Auto 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ú.

Ir Atrás

  Ir a la página anterior a la que está viendo.

Ir Adelante

  Si ya se ha movido previamente con el icono hacia atrás o con la entrada de menú, puede volver hacia delante de nuevo con esta entrada de menú.

Ir ...

  En la parte inferior del menú Ir, encontrará una lista histórica de las últimas páginas que ha visto. Seleccionando una de ellas puede volver a esa página.

## Créditos y licencias

&khelpcenter;

Originalmente desarrollado por &Matthias.Elter; &Matthias.Elter.mail;.

El encargado actual es &Cornelius.Schumacher; &Cornelius.Schumacher.mail;.

&underFDL; &underGPL;