# Obtención de ayuda ayuda en línea

Existe ayuda en línea disponible para cada una de las aplicaciones estándar de Common Desktop Environment (CDE). Tanto si utiliza el Gestor de archivos, la Agenda o la Aplicación de correo, por ejemplo, puede solicitar y mostrar temas de la ayuda de la misma manera. Puede también examinar información de ayuda en el sistema utilizando el Gestor de ayuda del escritorio.

Otras aplicaciones instaladas en el escritorio pueden aprovechar el uso del Sistema de ayudas del escritorio o proporcionar ayuda de otras maneras.

UG.GHelp.mkr.2
UG.GHelp.mkr.6
UG.GHelp.mkr.8
UG.GHelp.mkr.12
UG.GHelp.mkr.13
UG.GHelp.mkr.17
UG.GHelp.mkr.20

## Solicitud de ayuda

`
`Estas son las formas en que puede solicitar Ayuda:

- Pulsar F1 —también conocida como “tecla de ayuda”—para obtener ayuda sensible al contexto

- Elegir un mandato en el menú Ayuda de la aplicación

- Abrir el Gestor de ayuda desde el Panel frontal para examinar ayuda en el sistema

- Abrir el subpanel de Ayuda para seleccionar ayuda sobre el escritorio o para elegir Ayuda sobre el tema

### Pulsar F1 `—` La tecla Ayuda

Cuando tenga una duda, la forma más rápida y sencilla de obtener ayuda es pulsar F1. Cuando pulsa F1, la aplicación que está utilizando muestra el tema de la ayuda más relacionado con el componente que está resaltado (por ejemplo, una ventana o un botón).
Debido a que la aplicación determina el tema de la ayuda más adecuado, este tipo de ayuda se denomina sensible al contexto.

La tecla F1 es una forma rápida de obtener ayuda sobre un menú o un cuadro de diálogo de una aplicación. Por ejemplo, para solicitar ayuda sobre el menú Archivo del Gestor de archivos, abra el menú Archivo y pulse F1. El Gestor de archivos mostrará una descripción de cada opción del menú. Asimismo, si está abierto un cuadro de diálogo, cuando pulse F1 se mostrará una explicación sobre el cuadro de diálogo. La tecla F1 es un método abreviado equivalente a pulsar el botón Ayuda del cuadro de diálogo.

Algunos sistemas tienen una tecla “Ayuda” especial en el teclado. Si este es su caso, puede que dicha tecla sustituya a la tecla F1.

### Uso del menú Ayuda de una aplicación

La mayoría de las aplicaciones tienen un menú Ayuda que contiene mandatos para solicitar diferentes tipos de ayuda, por ejemplo información preliminar, tareas de la aplicación o información de consulta.

#### Menú Ayuda de la aplicación de CDE

Un menú Ayuda típico de CDE incluye estos mandatos:

Información general | Muestra el tema de inicio de la aplicación. El tema de inicio es el primer tema en la jerarquía de temas de la ayuda de la aplicación.
Tabla de contenido | Muestra todos los temas de la jerarquía de temas de ayuda de la aplicación.
Tareas | Muestra instrucciones sobre tareas para la mayoría de las operaciones realizadas con la aplicación.
Referencia | Muestra resúmenes de referencia para varios componentes, tales como ventanas y cuadros de diálogo, menús y recursos de la aplicación.
Sobre el tema | Le permite pulsar con el ratón un elemento de cualquier ventana de una aplicación y ver una descripción del elemento.
Uso de la ayuda | Proporciona ayuda sobre la utilización de las ventanas de la ayuda.
Acerca de la aplicación | Muestra la versión y la información de copyright correspondiente a la aplicación.

Las aplicaciones pueden incluir opciones adicionales. Además, las aplicaciones no pertenecientes a CDE pueden tener mandatos diferentes en sus menús de la Ayuda.

#### Ayuda de la aplicación Sobre el tema

La Ayuda sobre el tema es interactiva. Le permite colocar el puntero sobre un elemento determinado (tal como un menú, un botón o un cuadro de diálogo) y pulsar sobre el elemento para mostrar su ayuda correspondiente.

#### Para seleccionar Ayuda sobre el tema

1. Elija Sobre el tema, en el menú Ayuda.

   El puntero se convertirá en un signo de interrogación (?).

2. Coloque el puntero sobre un elemento de la aplicación y pulse el botón 1 del ratón.

   Se mostrará una descripción del elemento.

### Uso del Gestor de ayuda

El Gestor de ayuda es un volumen especial de la ayuda que lista toda la ayuda en línea que está registrada en el sistema. Cuando pulsa el control Gestor de ayuda, en el Panel frontal, se abre el volumen de ayuda correspondiente al Gestor de ayuda.

#### Control Gestor de ayuda

Pulse en cualquiera de los títulos subrayados para ver la correspondiente información de ayuda. Para obtener instrucciones adicionales sobre el uso del Gestor de ayuda, vea.

Para su comodidad, puede también encontrar ayuda sobre el escritorio y el Panel frontal en el subpanel Ayuda. También proporciona ayuda Sobre el tema para el Panel frontal y sus subpaneles.

## Uso de ventanas de ayuda

`
` El Sistema de ayudas está incorporado en cada una de las aplicaciones CDE (y posiblemente en otras aplicaciones instaladas en el sistema). Cuando solicita ayuda mientras está utilizando una aplicación, ésta muestra una ventana de ayuda.

Las aplicaciones pueden utilizar dos tipos de ventanas de ayuda para mostrar temas de la ayuda: una ventana de ayuda general y una ventana de ayuda rápida, que se muestra en la UG.GHelp.mkr.7.

### Tipos de ventanas de ayuda

Las ventanas de ayuda general tienen un árbol de temas y un área de visualización de temas. El árbol de temas es una lista de temas de la ayuda que el usuario puede examinar para buscar ayuda sobre un tema. Cuando elige un tema, se muestra en la parte inferior de la ventana de ayuda, denominada área de visualización de temas.

Las ventanas de ayuda rápida son ventanas de ayuda reducidas. Sólo tienen un área de visualización de temas y uno o más botones.

## Selección de temas de la ayuda

Existen dos formas de seleccionar un tema de la ayuda. Puede elegir un tema del árbol de temas. También, dentro de un tema de la ayuda, puede seleccionar un hiperenlace. Un hiperenlace es una palabra o frase activa que “salta” hacia otro tema relacionado de la ayuda. Cualquier texto subrayado de una ventana de ayuda es un hiperenlace.

Las imágenes gráficas también se pueden utilizar como hiperenlaces. Para obtener más información sobre los hiperenlaces, vea UG.GHelp.mkr.10en la.

### Uso del árbol de temas

El árbol de temas es un esquema de los temas principales de un volumen de la ayuda. Los subtemas aparecen sangrados debajo de los temas principales. El tema actual, cuyo contenido se muestra en el área de visualización de temas, está marcado con una flecha (˛). Puede desplazar el área de visualización de temas para ver todas las opciones de que dispone o cambiar el tamaño de la ventana de ayuda completa.

Puede también cambiar el tamaño del panel de temas. Para hacerlo, arrastre con el ratón la barra de división que se muestra en la UG.GHelp.mkr.9. Luego libere el botón del ratón para establecer el nuevo tamaño.

#### Cambio de tamaño del árbol de temas

#### Para seleccionar un tema

1. Coloque el puntero en el árbol de temas.

2. Pulse el botón 1 del ratón en el tema que desea mostrar.

### Uso de hiperenlaces

Cualquier texto subrayado de una ventana de ayuda es un hiperenlace. Mediante los hiperenlaces es fácil “saltar” a temas relacionados de la ayuda: simplemente pulse el ratón en el texto subrayado.

#### Aspecto de los hiperenlaces

Una línea de subrayado continua identifica los hiperenlaces estándar que muestran el nuevo tema en la ventana de ayuda actual. Por ejemplo, el último párrafo de la UG.GHelp.mkr.9 muestra un hiperenlace de este tipo.

Un subrayado de línea de guiones identifica un enlace de definición, que muestra una ventana de ayuda rápida.

Un gráfico — un icono, por ejemplo — puede también ser un hiperenlace. Un borde gris sin esquinas identifica un hiperenlace gráfico. La UG.GHelp.mkr.11 muestra los diferentes formatos de hiperenlace que se pueden utilizar en temas de la ayuda.

##### Formatos de hiperenlace

#### Enlaces que muestran un nueva ventana

La mayoría de los hiperenlaces muestran el tema relacionado en la misma ventana. Sin embargo, si elige un hiperenlace que salta a un tema de la ayuda para otra aplicación, se muestra una nueva ventana. Los enlaces que saltan desde la ayuda en línea de una aplicación a la de otra se denominan hiperenlaces entre volúmenes o entre aplicaciones.

#### Para seleccionar un hiperenlace

1. Coloque el puntero en el texto subrayado o en la imagen gráfica.

2. Pulse el botón 1 del ratón.

## Desplazamiento entre temas de la ayuda

Para ir de un tema a otro de la ayuda, utilice estos mandatos del menú Desplazarse:

Retroceder | Vuelve al tema anterior. Retroceder le permite volver a cada tema que ha examinado.
Histórico | Muestra el cuadro de diálogo Histórico que lista los volúmenes y temas de la ayuda que ha visitado. Seleccione un tema de la ayuda para volver a mostrarlo.
Tema de inicio | Vuelve al tema de inicio, es decir, el principio del volumen de la ayuda.

Para su comodidad, los mandatos Retroceder e Histórico también se proporcionan en forma de botones de acción.

### Menú emergente Ayuda

En una ventana de ayuda general, puede también utilizar el menú emergente Ayuda como método abreviado. El menú emergente incluye los mandatos Retroceder y Tema de inicio, que se utilizan con frecuencia.

Las ventanas de ayuda rápida no tienen un menú emergente.

#### Para mostrar el menú emergente Ayuda

1. Señale el área de visualización de temas y pulse el botón 3 del ratón.

2. Elija Retroceder o Tema de inicio.

##### Menú emergente Ayuda

### Dónde estoy

Cada aplicación que proporciona ayuda en línea tiene un volumen de ayudas. Un volumen consta de un grupo de temas de ayuda que describen la aplicación y explican cómo utilizar sus características. Por ejemplo, una aplicación podría organizar su ayuda utilizando estos temas principales: Conceptos, Tareas y Referencia.

#### Organización del volumen de ayudas

El tema de inicio es el primer tema, es decir, el principio del volumen de ayudas. Los temas de nivel principal son accesibles desde el tema de inicio, o pueden también estar listados en el menú Ayuda de la aplicación.

#### Desplazamiento entre diferentes volúmenes de ayudas

A menudo los hiperenlaces le llevan a otro tema del volumen de ayudas de la aplicación. Por ejemplo, mientras examina los temas de Tareas podría seleccionar un hiperenlace hacia un tema de la sección Referencia.

Sin embargo, un grupo de aplicaciones relacionadas pueden utilizar hiperenlaces que apuntan a información de referencias cruzadas situada en volúmenes de ayudas diferentes. Por ejemplo, una aplicación podría incluir un hiperenlace con el volumen de ayudas de introducción del escritorio que describe los conocimientos básicos sobre el ratón y el teclado.

Debido a que los hiperenlaces le pueden llevar rápidamente de un elemento de información a otro, tal vez le interese saber dónde se encuentra. Un examen rápido de la ventana de ayuda puede proporcionarle la información que necesita.

- La línea situada debajo de la barra de menús indica el nombre del volumen que está viendo. Esto es útil cuando ha explorado varios volúmenes de ayudas mediante el Gestor de ayuda, el índice de la ayuda o enlaces entre volúmenes.

- Dentro del árbol de temas, el primer elemento es el tema de inicio, que es el comienzo del volumen de ayudas. Después de explorar temas, puede volver fácilmente al tema de inicio desplazándose hacia el principio del árbol de temas. O puede elegir Tema de inicio, en el menú Desplazarse o en el menú emergente.

- Una flecha señala el título del tema seleccionado. Cuando selecciona temas, la flecha se desplaza para identificar su selección. El desplazamiento por el árbol de temas le mostrará dónde se encuentra con respecto a otros temas.

### Dónde he estado

Una ventana de ayuda general hace un seguimiento de los temas que el usuario ha explorado. El mandato Histórico abre un cuadro de diálogo que lista los volúmenes de ayudas y los temas de ayuda que el usuario ha explorado.

#### Cuadro de diálogo Histórico

#### Para utilizar Histórico para volver a un tema

1. Pulse el botón Histórico.

2. Elija el título del volumen de ayudas o del tema que desea que se muestre.

3. Cuando haya terminado, pulse Cerrar.

## Búsqueda de información específica

Como en un libro, un volumen de ayudas tiene un índice de palabras y frases significativas que puede utilizar para buscar temas de la ayuda sobre una materia. Puede examinar o buscar en el índice del volumen actual, de volúmenes seleccionados o de todos los volúmenes de ayudas disponibles en el sistema.

### Cuadro de diálogo Buscar índice

Debido a que el índice de la ayuda puede ser bastante grande, incluso para un único volumen, las entradas de índice se pueden ampliar o reducir. Un signo más (+) indica que la entrada de índice está relacionada con más de un tema de la ayuda. El número muestra la cuenta de temas de la ayuda. Puede pulsar en el elemento de índice para listar los temas.

Por ejemplo, la UG.GHelp.mkr.14 muestra el resultado de una búsqueda por índice de la palabra “display”. El prefijo -36 indica que existen 36 entradas de índice que contienen la palabra clave “display”. Cuando se pulsa sobre cualquier título marcado con un signo más (+) se amplía la lista y el signo más se convierte en un signo menos (-). La última entrada de índice que muestra la figura se ha ampliado de esta forma.

### Para buscar temas mediante el índice de la ayuda

El índice de la ayuda sólo aparece en una ventana de ayuda general

1. Para abrir el índice, pulse el botón Índice.

   El índice lista todas las entradas del volumen de ayudas seleccionado. Puede elegir Todos los volúmenes para ver un índice de todos los volúmenes de ayudas disponibles o elegir Seleccionado si desea seleccionar sólo determinados volúmenes.

2. Seleccione el campo Entradas con, escriba la palabra o frase que está buscando, y pulse Intro.

   Las búsquedas por índice no distinguen entre mayúsculas y minúsculas. Se pueden utilizar caracteres comodines, tales como el asterisco (*) y el signo de interrogación (?) (vea UG.GHelp.mkr.16 más adelante).

3. Seleccione la entrada de índice que desea ver.

   Si la entrada tiene un signo más (+) como prefijo, la lista se ampliará para mostrar opciones adicionales. A continuación seleccione un tema de la ayuda para ver.

   Puede visualizar tantos temas como desee.

4. Cuando haya terminado, pulse Cerrar.

#### Búsquedas por patrón

En un patrón de búsqueda determinados caracteres (denominados “comodines”) tienen un significado especial. Puede combinar estos caracteres de varias formas.

Dos comodines utilizados con frecuencia son el asterisco ( `*`) y el signo de interrogación (`?`). El `*` coincide con cualquier cadena de caracteres (incluyendo su ausencia), y el `?` coincide con cualquier carácter individual. Otros comodines son:

. (punto) | Coincide con cualquier carácter
| (barra vertical) | Especifica dos patrones de búsqueda y coincide con cualquiera de los dos patrones (operador lógico OR)
() (paréntesis) | Delimita una expresión modelo

Para buscar un carácter que tiene un significado especial dentro de una expresión regular, preceda el carácter con una barra inclinada invertida ().

##### Ejemplos

mouse*clicking | Coincide con las entradas que contengan la palabra “mouse” seguida de un número cualquiera de caracteres seguidos a su vez de la palabra “clicking”
mouse | click | Coincide con las entradas que contengan la palabra “mouse” o “click”
(session | style)*manager | Coincide con las entradas que contengan la palabra “Session Manager” o “Style Manager”

## Exploración de la ayuda del sistema

Puede explorar todos los volúmenes de ayudas de aplicación registrados en el sistema sin tener que iniciar cada aplicación individual: sólo tiene que iniciar el Gestor de ayuda desde el Panel frontal.

En el nivel superior, el Gestor de ayuda agrupa los volúmenes de ayudas en familias de ayudas. Por ejemplo, la familia de ayudas Common Desktop Environment lista volúmenes de ayudas para las aplicaciones de escritorio estándar. Puede explorar y abrir cualquiera de los volúmenes listados.

### Para abrir el Gestor de ayuda

1. Pulse el control Gestor de ayuda, en el Panel frontal (vea la ug.ghelp.mkr.5).

   Una ventana de ayuda mostrará una lista de familias de ayudas con ayuda en línea. Ese es el nivel superior del Gestor de ayuda.

   #### Vista de nivel superior del Gestor de ayuda

2. Desplace la ventana para buscar el grupo de productos en que está interesado y pulse en su título (subrayado).

   Esto hará que se listen los volúmenes de ayudas que hay disponibles para ese producto.

3. Para abrir un volumen de ayudas determinado, pulse en su título (texto subrayado).

4. Para volver al nivel superior del Gestor de ayuda, pulse el
   botón Nivel superior.

#### Ejemplo

Para explorar la ayuda en línea del Gestor de archivos:

1. Pulse el control Gestor de ayuda.

2. Elija Common Desktop Environment.

3. Desplace la lista de volúmenes de ayudas hasta que vea Ayuda del Gestor de archivos.

4. Pulse en Ayuda del Gestor de archivos.

   Se mostrará la ayuda del Gestor de archivos. Esta es la misma información de ayuda que vería si abriera Gestor de archivos y seleccionará Información general en el menú Ayuda.

##### Ayuda del Gestor de archivos visualizada en el Gestor de ayuda

### Para duplicar una ventana de ayuda

1. Elija Ventana nueva en el menú Archivo del Gestor de ayuda.

   Se duplicará la ventana de ayuda actual. Puede cambiar el tamaño de la nueva ventana y seleccionar temas con independencia de la ventana original.

2. Para eliminar la ventana, elija Cerrar en el menú Archivo.

El mandato Ventana nueva sólo está disponible en la ayuda del Gestor de ayuda (vea UG.GHelp.mkr.4 UG.GHelp.mkr.17).

## Visualización de una página de manual en línea

Las páginas de referencia del manual en línea se pueden visualizar utilizando la acción Visor de página de manual. El icono de acción está situado en la carpeta Apls_Escritorio del Gestor de aplicaciones.

### Icono de acción Página de manual

### Para mostrar una página de manual en línea

1. Pulse el control Gestor de aplicaciones, en el Panel frontal.

2. Efectúe una doble pulsación sobre el icono Apls_Escritorio.

3. Pulse el icono Visor de página de manual.

   Se mostrará un cuadro de diálogo, que le solicita que entre un nombre de página de manual.

4. Escriba el nombre de la página de manual que desea ver y pulse Intro.

   La página de manual aparecerá en una ventana de ayuda rápida.

5. Pulse Cerrar para eliminar la página de manual.

## Impresión de temas de la ayuda

En ocasiones, tal vez le interese tener una versión impresa de un tema de la ayuda para una aplicación determinada. Puede imprimir un tema individual de la ayuda, una tabla de contenido y un índice o el volumen de ayudas completo. En el cuadro de diálogo Imprimir también se pueden establecer opciones de impresión, tales como el tamaño del papel, el número de copias y la impresora de destino.

Los temas de la ayuda impresos se envían a la impresora predeterminada, a menos que el usuario proporcione un nombre de impresora diferente en el cuadro de diálogo. La salida impresa consta sólo de texto.

### Para imprimir un tema de la ayuda

1. Elija Imprimir en el menú Archivo. (En una ventana de ayuda rápida, pulse el botón Imprimir.)

   Puede utilizar los valores predeterminados del cuadro de diálogo Imprimir e ir al paso 5 o entrar nuevos valores para el trabajo de impresión.

2. Opcional. Escriba el nombre de la impresora que desea utilizar.

3. Opcional. Escriba el número de copias a imprimir.

4. Opcional. Pulse el botón del tamaño de papel para elegir un tamaño de papel.

5. Seleccione el tema o los temas que desea imprimir.

   Tema Actual (valor predeterminado) | Imprime sólo el tema seleccionado
   Actual y Subtemas | Imprime el tema seleccionado y sus subtemas
   Tabla de Contenido e Índice | Imprime la tabla de contenido y el índice del volumen de ayudas
   Todos los Temas en el Volumen | Imprime el contenido del volumen de ayudas, incluyendo la tabla de contenido y el índice

6. Pulse Imprimir.

### Configuración de impresión

El cuadro de diálogo Imprimir muestra el nombre de la impresora predeterminada. Puede cambiar el nombre de la impresora predeterminada modificando la variable de entorno LPDEST. Puede también cambiar la impresora para una aplicación determinada modificando el archivo de valores predeterminados de la aplicación.

#### Para definir el recurso de impresora para una aplicación

- Edite el archivo DirectorioInicio/ `.Xdefaults` añadiendo este recurso:

      nombre_aplicación*printer: nombre

  Si no tiene un archivo `.Xdefaults`, cree el archivo en su directorio de inicio.

##### Ejemplo

Desea dirigir toda la ayuda impresa de una aplicación llamada ImageScan a una impresora llamada `laser2` en lugar de dirigirla a la impresora predeterminada.

Añada este recurso al archivo `.Xdefaults`:

    ImageScan*printer: laser2

## Modificación de los colores de la ventana de ayuda

Puede cambiar los colores del árbol de temas o del área de visualización de temas de una ventana de ayuda definiendo recursos de aplicación. Es importante elegir colores contrastantes. Esto asegura que el texto (color en primer plano) se distinga del color de fondo.

### Para cambiar los colores de una ventana de ayuda de una aplicación

1. Edite el archivo `DirectorioInicio/.Xdefaults` añadiendo estos recursos:

       nombre_aplicación*DtHelpDialog*DisplayArea.foreground: color
       nombre_aplicación*DtHelpDialog*DisplayArea.background: color
       nombre_aplicación*DtHelpDialog*TocArea.foreground:  color
       nombre_aplicación*DtHelpDialog*TocArea.background:  color
       nombre_aplicación*DtHelpQuickDialog*DisplayArea.foreground:  color
       nombre_aplicación*DtHelpQuickDialog*DisplayArea.background:  color

   Sustituya nombre_aplicación por el nombre de la aplicación cuyas ventanas de ayuda desea cambiar.

   Puede solicitar al administrador del sistema una lista de colores que pueda utilizar o consultar la documentación del sistema.

2. Guarde y cierre el archivo.

   Cuando reinicie la aplicación, está utilizará en sus ventanas de ayuda los nuevos valores de color para el árbol de temas y el área de visualización de temas.

#### Ejemplo

Estas entradas de recurso cambian los colores del texto y de fondo del árbol de temas (TocArea) y del área de visualización de temas (DisplayArea) para una aplicación llamada DtCardCatalog.

    DtCardCatalog*DtHelpDialog*TocArea.foreground: yellow
    DtCardCatalog*DtHelpDialog*TocArea.background: blue
    DtCardCatalog*DtHelpDialog*DisplayArea.foreground: yellow
    DtCardCatalog*DtHelpDialog*DisplayArea.background: blue
    DtCardCatalog*DtHelpQuickDialog*DisplayArea.foreground: yellow
    DtCardCatalog*DtHelpQuickDialog*DisplayArea.background: blue

Las ventanas de ayuda rápida no tienen un árbol de temas, por lo tanto se omite el recurso `TocArea`.