# El &khelpcenter;

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

### Sistema de ayuda de &kde;

El sistema de ayuda de &kde; está diseñado para hacer que el acceso a los sistemas de ayuda habituales de &UNIX; (man y info) así como a la documentación (&XML;) nativa de &kde; sea simple.

Todas las aplicaciones base de &kde; están completamente documentadas, gracias a los esfuerzos del equipo de documentación. Si está interesado en ayudar en el trabajo de documentación, unase a la lista de correo y escriba al equipo a kde-doc-english@kde.org. No se requiere ninguna experiencia, sólo entusiasmo y paciencia.

Si desea ayudar a traducir la documentación de &kde; a su idioma nativo, revise la información, incluyendo los coordinadores de los equipos de cada idioma, en el sitio web de localización.

#### Instalación

&khelpcenter; es una parte integral de la instalación base de &kde;, y se instala con cualquier copia de &kde;. Se puede encontrar en el paquete kdebase-runtime, y está disponible desde el &kde-ftp;, o se encontrará en el paquete kdebase-runtime de su sistema operativo.

### Solicitar ayuda

Puede invocar a &khelpcenter; de varias maneras:

Desde el menú Ayuda

- Lo más habitual será probablemente desde dentro de una aplicación. Seleccione F1 Ayuda Manual de la aplicación para abrir el manual de la aplicación.

Desde el lanzador de aplicaciones Kickoff

- Seleccione la gran K de su panel, y pulse en la pestaña Aplicaciones, seleccionando a continuación Ayuda para abrir el &khelpcenter;, que se desplegará mostrando la página de inicio predeterminada.

Desde la línea de órdenes

- El &khelpcenter; puede ser iniciado utilizando una &URL; para mostrar un archivo. Las &URL;s también han sido añadidas para las páginas `info` y `man`. Puede utilizarlas del siguiente modo:

  Desde un archivo de ayuda de una aplicación

- `khelpcenter` `help:/`kwrite``

  Abre el archivo de ayuda de &kwrite;, en la página de contenidos.

Un &URL; local

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

Una página man

- `khelpcenter` `man:/`strcpy``

Una página de información

- `khelpcenter` `info:/`gcc``

Invocar `khelpcenter` sin parámetros abre la página de inicio predeterminada.

### La interfaz de &khelpcenter;

La interfaz del &khelpcenter; se compone de dos paneles de información.

La barra de herramientas y los menús se explican en más detalle en menu-and-toolbar-ref.

Los documentos contienen sus propias herramientas de navegación, permitiéndole moverse bien secuencialmente a través del documento, utilizando los enlaces Siguiente, Anterior, y Contenidos, o bien moverse a través de una manera menos estructurada, utilizando hiperenlaces.

Los enlaces pueden llevarle a otras partes del mismo documento, o a un documento diferente, y puede utilizar los iconos Atrás (flecha apuntando a la izquierda) o Adelante (flecha apuntando a la derecha) de la barra de herramientas para moverse a través de los documentos que esté visualizando en la sesión actual.

Los dos paneles muestran los contenidos del sistema de ayuda, y los propios archivos de ayuda, a la izquierda y a la derecha respectivamente.

#### El panel Contenidos

El panel Contenidos del &khelpcenter; se muestra en lado izquierdo de la ventana. Como puede esperar, puede mover la barra divisoria para asegurarte de poder leer confortablemente los contenidos de cada panel.

El panel Contenidos está además dividido en dos pestañas, una contiene un menú que muestra toda la información de ayuda del &khelpcenter;, y el otro contiene el glosario de términos de &kde;.

##### El menú Contenido

Los Contenidos contienen las siguientes entradas predeterminadas:

Manual de Plasma

- El manual de &plasma; es la documentación para el pilar más visible de &kde;, la interfaz central del escritorio.

Ayuda en línea

- Una página con enlaces a ayuda en línea e información adicional proporcionada por la comunidad de &kde;.

Manuales de aplicación

- Documentación de una aplicación nativa de &kde;. Todas las aplicaciones de &kde; tienen documentación en formato &XML;, que es convertida a HTML cuando las visualiza. Esta sección lista todas las aplicaciones &kde; con una breve descripción y un enlace a la documentación completa de la aplicación.

  Las aplicaciones se muestran en una estructura arbórea que imita la estructura predeterminada del menú K, facilitando encontrar la aplicación que está buscando.

Módulos del centro de control

- Proporciona una lista de enlaces a varios módulos que están localizados en la aplicación &systemsettings; de &kde;.

Módulos de KInfoCenter

- Contiene una lista de enlaces a la documentación de varios módulos de KInfocenter.

Kioslaves

- Contiene una lista de enlaces a la documentación de varios módulos de KIO.

Páginas de manual de &UNIX;

- Las páginas man de &UNIX; son el formato de documentación en línea tradicional para los sistemas &UNIX;. La mayoría de los programas de su sistema tienen una página man. Además, las páginas man existen para funciones de programación y formatos de archivo.

Scrollkeeper

- Documentación adicional no nativa de &kde; instalada en sus sistema.

Navegar por las páginas info

- La documentación TeXinfo es utilizada por muchas aplicaciones &GNU; incluyendo `gcc` (el compilador de C/C++), `emacs`, y muchos otros.

#### Las secciones Man y Info

Las páginas man son las páginas del manual estándar de &UNIX; y han sido utilizadas durante muchos años en muchos otros sistemas operativos. Son extremadamente completas, y son sin lugar a dudas el mejor lugar para obtener información sobre la mayoría de los comandos y las aplicaciones de &UNIX;. Cuando la gente dice RTFM, el manual al que se están refiriendo es casi siempre las páginas man.

Las páginas man no son perfectas. Tienden a entrar en profundidad, pero también son extremadamente técnicas, a menudo están escritas por desarrolladores, y para desarrolladores. En algunos casos esto las hace algo desamigables, si es que no hasta imposibles de comprender para muchos usuarios. No obstante, son la mejor fuente de información sólida sobre la mayoría de las aplicaciones de línea de ordenes, y muy a menudo la única fuente.

Si alguna vez se ha preguntado que quiere decir el número cuando la gente escribe cosas como man (1), su significado es la sección del manual en la que está el elemento. Verá que &khelpcenter; utiliza los números para dividir las numerosas páginas man en sus propias secciones, facilitándole la búsqueda de la información que está buscando, si está navegando.

También están disponibles las páginas info, que pretenden ser un reemplazo de las páginas man. Los mantenedores de algunas aplicaciones han dejado de actualizar las páginas man, por lo que si están disponibles tanto una página man como una página info, la página info es probablemente la más reciente. La mayoría de las aplicaciones tienen una o la otra. Si la aplicación para la que está buscando ayuda es una utilidad &GNU;, lo más probable es que encuentre que tiene una página info, y no una página man.

##### Navegando dentro de las páginas Info

Los documentos Info están organizados jerárquicamente con cada página denominada nodo. Todos los documentos info tienen un nodo Top, &ie; la página de apertura. Puede volver al Top de un documento info pulsando Top.

Anterior > & Siguiente se utilizan para moverse a las páginas anterior/siguiente del nivel actual de la jerarquía.

Hacer clic en un elemento de menú dentro de un documento le llevará a un nivel más bajo en la jerarquía. Puede subir en la jerarquía presionando Arriba.

Man es tratado de forma similar a info, con la sección índice siendo el nodo Top y con cada página man en el nivel inferior. Las entradas man son páginas largas.

#### El glosario de &kde;

El glosario proporciona un punto de referencia rápida, en el que puede buscar las definiciones de aquellas palabras que no le sean familiares. En él se incluyen desde aplicaciones y tecnologías específicas de &kde;, a términos de computación generales de &UNIX;.

En el panel de la izquierda verá una vista arbórea, con dos opciones: Alfabéticamente o Por tema. Ambas contienen las mismas entradas, ordenadas de forma diferente, para permitirle encontrar rápidamente el tema que le interesa.

Navegue hacia abajo en las vistas árbol de la izquierda, y los temas que seleccione se mostrarán en el panel de la derecha.

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

&khelpcenter; tiene una interfaz muy simple, para permitirle concentrarse en obtener la ayuda en lugar de 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

Tabla de contenido

- Ir a la página de inicio principal del &khelpcenter;.

Atrás

- Ir a la página anterior que ha visto. Haga clic en la marca de comprobación que hay a la derecha del icono. Esto muestra una lista de las páginas vistas anteriormente. Al seleccionar una de ellas será llevado directamente a la página en cuestión.

Adelante

- Avanzar una página. Éste icono sólo estará activo si ya ha utilizado el icono Atrás.

Copiar

- Copia el texto al portapapeles para ser pegado en otra aplicación.

Buscar

- Busca una o varias palabras dentro de la página actualmente visible.

Aumentar el tamaño de las letras

- Aumenta el tamaño del texto en el panel visor.

Disminuir el tamaño de las letras

- Disminuye el tamaño del texto en el panel visor. Este icono solo estará activado si has anteriormente había aumentado el tamaño del texto.

Los menús contienen las siguientes entradas:

Archivo

- &Ctrl;S Archivo Salir

- Cerrar y salir de &khelpcenter;

Editar

- &Ctrl;C Editar Copiar

- Copia el texto seleccionado al portapapeles.

&Ctrl;t Editar Seleccionar todo

- Selecciona todo el texto de la página actual.

&Ctrl;B Editar Buscar...

- Buscar una palabra o palabras en la página visible en ese momento.

Ver

- Ver Especificar codificación

- Cambia la codificación de la página actual. Normalmente, la configuración por defecto de Predeterminada debería ser suficiente, pero si está teniendo problemas con la visualización de páginas escritas en idiomas diferentes al Inglés, puede que necesite seleccionar una codificación específica en este menú.

Ir

- &Alt;Inicio Ir Tabla de contenido

- Ir a la página de inicio principal del &khelpcenter;.

&Ctrl;RePág Ir Página anterior

- Ir a la página anterior de la documentación actual.

&Ctrl;AvPág Ir Página siguiente

- Ir a la página siguiente de la documentación actual.

&Alt;Izquierda Ir Atrás

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

&Alt;Derecha Ir Adelante

- Si previamente se ha movido atrás con el icono o la entrada de menú atrás, puede volver adelante con esta entrada de menú.

Preferencias

- Preferencias Mostrar la barra de herramientas

- Muestra u oculta la barra de herramientas que contiene los iconos en la parte superior de la aplicación.

Preferencias Mostrar la barra de estado

- Muestra u oculta la barra de estado que está localizada en la parte inferior de la aplicación.

Preferencias Configurar los tipos de letra...

- Le permite configurar la familia de tipo de letra y el tamaño de letra que utiliza &khelpcenter;.

Preferencias Configurar los accesos rápidos...

- Configura los accesos rápidos disponibles para &khelpcenter;.

Preferencias Configurar las barras de herramientas...

- Configura las barras de herramientas disponibles para &khelpcenter;.

### Créditos y licencia

&khelpcenter;

Desarrollo iniciado por &Matthias.Elter; &Matthias.Elter.mail;

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

Traducido por Pablo de Vicente pablo.devicente@gmail.com, Marcos Fouces Lago mfouces@yahoo.es y Cristina Yenyxe González García the.blue.valkyrie@gmail.com.

&underFDL; &underGPL;