05/01/2001 1.94.00 El sistema de ayuda de KDE está diseñado para acceder a los sistemas de ayuda comunes de UNIX (man e info), así como a la documentación nativa de KDE (HTML). Todas las aplicaciones base de KDE están completamente documentadas, gracias al esfuerzo del equipo de documentación. Si usted desea colaborar por favor escriba al coordinador de la documentación, Mike McBride, en mpmcbride7@yahoo.com para que le informe. No se requiere experiencia, simplemente entusiasmo y paciencia. Si desea ayudar en las traducciones de la documentación de KDE a su lengua nativa el corrdinador de los equipos de traducción es éric Bischoff ebisch@cybercable.tm.fr, y él también agradecería su ayuda. Se puede encontrar más información, incluyendo los coordinadores para los equipos de cada lengua, en el servidor web de internacionalización, y en la sección contactos de este documento. El Centro de Ayuda de KDE es una parte integral de la instalación de KDE básico, y se instala con cada copia de KDE. Se puede encontrar en el paquete kdebase, y está disponible desde el servidor FTP de KDE o en el paquete kdebase de su distribución linux. El Centro de Ayuda de KDE se puede invocar de diferentes modos: Desde el menú de Ayuda El más común será 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 el Centro de Ayuda, comenzando en la página de bienvenida por defecto. Desde el panel El panel Kicker contiene por defecto un icono denominado Centro de Ayuda. Pulsandolo, aparece la página de bienvenida por defecto. Desde la línea de comandos El Centro de Ayuda puede ser iniciado utilizando una URL para mostrar un archivo. Las URLs han sido añadidas para las páginas de Info y man también. Usted las puede utilizar como sigue: Un archivo de aplicación de ayuda khelpcenter help:/kedit Abre el archivo de ayuda de Kedit, sección de Contenido. 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 por defecto la página de bienvenida al sistema de ayuda. El interfaz del Centro de Ayuda consiste en dos paneles de información, empotrados en la ventana de &konq;. Esta propiedad hace que la navegación sea simple e intuitiva y que permita utlizar las barras de herramientas de &konq;, como si se tratase de una página web. Además, la mayoría de los documentos disponen de sus propias barras de navegación, permitiendole moverse secuencialmente por el documento, utilizando los enlaces Anterior y Previo, 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, Atrás (Flecha a la izquierda) o Adelante (Flecha a la derecha) para moverse a través del documento que ha 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 Contenidosen el Centro de Ayuda 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 solapas, una que contiene un menú mostrando un índice con toda la información de ayuda disponible en el Centro de Ayuda de KDE y otro que le permite Buscar información específica. Los Contenidos incluyen las siguientes entradas: Introducción Bienvenido a KDE - una introducción al Entorno de Escritorio K. 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 como 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 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ágina de manual del sistema 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. Directorio de información del sistema La documentación TexInfo es utilizada por muchas aplicaciones GNU, incluyendo gcc (el compilador C/C++), emacs, y muchas otras. Las P.F. de KDE Preguntas frecuentes sobre KDE, y sus respuestas. KDE en la web Enlaces de KDE en la web, el lugar oficial de KDE, y otros lugares útiles. Información de contacto Información de como contactar a los desarrolladores de KDE, y de como suscribirse a las listas de correo de KDE. Colaborando con KDE Como colaborar, y como involucrarse. Buscar requiere que usted haya instalado en su sistema la aplicación ht://Dig. La información de cómo instalar y configurar el índice de busqueda está incluida en la documentación. La configuración del índice de búsqueda se realiza desde el Centro de Control de KDE, eligiendo AyudaÍndice, y en este módulo aparecerá ayuda detallada. Para los propósitos de este documento, asumiremos que ya ha configurado las opciones. La búsqueda a travé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 Buscar. Los resultados se mostrarán en el panel de la derecha. Las opciones disponibles son: Método Decida el método de búsqueda cuando utilice varias palabras. Si elige y, sólo se mostrarán resultados si todos los términos buscados estaban incluidos en la página. o mostrará resultados si alguno de los términos buscados son encontrados, y booleano le permite buscar utilizando una combinación. La sintaxis booleana le permite utilizar los operadores AND, OR y NOT para crear búsquedas complejas. Algunos ejemplos: perro AND gato Busca páginas que tengan las palabras gato y perro en ellas. Las páginas con sólo una de ellas no se mostrarán en los resultados de la búsqueda. gato NOT perro Busca páginas con la palabra gato pero sólo devuelve aquellas que no tengan la palabra perro. gato OR (perro NOT nariz) Busca páginas que contengan gato, y páginas que contengan perro pero que no contengan nariz. Las páginas que contuvieran gato y nariz se mostrarían en los resultados, y las páginas que contuvieran las tres palabras no. Si la búsqueda no devuelve los resultados que espera, compruebe cuidadosamente que no ha excluido la palabra buscada con un NOT errático o con un paréntesis pérdido. Máximos resultados Determina el máximo número de resultados de la búsqueda. Formato Decide si usted desea simplemente un enlace corto a la página que contiene los términos de búsqueda, o un resumen más largo. Ordenar Ordena los resultados por Puntuación (según se ajusten los resultados a los terminos buscados), alfabéticamente por Título o por Fecha. Seleccionando Orden inverso en la cajita de selección, invierte el orden de los resultados. Actualizar índice Actualiza el índice de búsqueda, para incorporar nuevos documentos, o por si su base de datos está incompleta o dañada. Esto puede llevar cierto tiempo. Las páginas del manual son las páginas estandard 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 Linux. Cuando alguien habla de RTFM, el Manual al que se refiere es habitualmente la página de manual. A pesar de ello las páginas del manual 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 aridas, 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. 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 el Centro de Ayuda 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. 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 del manual 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 del manual. Los documentos info están organizados jerarquicamente de modo que cada página se denomina un nodo. Todos los documentos info tienen un nodo Superior, p. ej. la página de apertura. Siempre puede volver al Comienzo de un documento pulsando Inicio. Anterior y Siguiente se usan para moverse a las páginas previa 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 del manual 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. Centro de Ayuda de KDE Originalmente desarrollado por Matthias Elter me@kde.org Actualmente lo mantiene Matthias Hoelzer-Kluepfel mhk@kde.org &underFDL; &underGPL;