Ficheros HLP

Este tutorial pretende que el usuario se inicie el la creación de archivos de ayuda, llegando al final a poder realizar un fichero HLP con enlaces entre sus páginas.

Unos en los aspectos en que Windows ha conseguido hacer un estándar es en los ficheros de ayuda. Actualmente hay dos tipos de archivos de ayuda que son:

Archivos HLP. Son el estandar de windows 9x
Archivos CHM Son archivos de ayuda html compilados

Cuando se programaba en entornos DOS, una de las principales desventajas que teníamos los desarrolladores era la de brindar ayuda al usuario. Siempre terminábamos por inventar un sistema de ayuda para cada aplicación.

En Windows, todos los programas usan un mismo sistema de ayuda: los archivos HLP. Hay otros muchos formatos para ficheros de ayuda, pero los primeros fueron estos ficheros. Y es de este tipo de archivos, de los que me voy a dedicar en este tutorial.

Herramientas necesarias

Para poder hacer un sistema de ayuda para sus aplicaciones necesitará, básicamente, tres elementos: un editor, un compilador de ayudas, y un visualizador de ayudas.

Como editor nos sirve cualquiera que admita el formato RTF, como compilador de ayuda, nos sirve el que Visual Basic trae, el HC, y como visualizador de estos ficheros, usaremos el propio WINHELP.

En este tutorial se usará el Word como editor de textos que admite formato RTF.
Un archivo RTF no es utilizable por el WINHELP, así que previamente hay que compilarlo, y ahí es donde entre en juego el HCW (Help Compiler Windows). Usaré el Word 6.0 y el HCW 4.03, y así .

Empezando...

Crearemos un primer ejemplo, sin gráficos ni enlaces. Sólo texto.

Abrimos el Word y escribimos cualquier texto, con posibilidad de utilizar distintos tipos de letra, tamaños, colores, ....y lo guardamos con formato RTF

Ahora ya estamos en disposición de crear un archivo de poryecto, que es el fichero donde le vamos a indicar al compilador de qué archivos está compuesto nuestro futuro HLP.

Abrimos el Windows Help Compiler, y le damos File, New y en el cuadro que sale seleccionamos la opcion "Help Project", le damos un nombre y lo guardamos
Ahora estamos listos para adicionarle el archivo que acabamos de crear, para esto hacemos click en "Files" y seleccionamos el archivo, este nos aparece en la pantalla del HWC
Entonces procedemos a hacer click en el boton "Save and Compile", con esto ya tenemos nuestro Archivo de ayuda

Mas de una Pagina

Para hacer más de una página, sólo tenemos que introducir saltos de página en nuestro documento RTF. En Word se hace con la combinación de teclas <CTRL> + <INTRO>. Para que el usuario pueda pasar de una página a otra, lo que se hace es asignar un identificador a cada página. Este identificador será único y servirá para facilitar la navegación mediante enlaces.

Para asignar estos identificadores hay que situar el cursor de Word al comienzo de la página que se quiere “indentificar”. Luego hay que insertar una nota al pie de página. En Word, encuentra esta opción en el menú Insertar, y la opción Nota al pie. Como marca personal introduciremos una almohadilla (#), que indicará al HCW que lo que viene a continuación es un identificador. Al pulsar el botón Aceptar, se abrirá una ventana en la parte de abajo en la que deberá introducir el identificador.

Una vez tengamos las páginas con un identificador cada una podemos agregar enlaces para ir de unas a otras. Para que el HC sepa que un conjunto de palabras van a actuar en forma de enlace, tenemos que darles el atributo de doble subrayado. Es decir, escribimos el texto, y lo seleccionamos. Luego, en el menú Formato, en Fuentes, tenemos la opción de doble subrayado, que demos de seleccionar.

Ahora que ya tenemos un enlace, debemos indicar al HCW a dónde lleva dicho enlace. Para ello, justo después del enlace, sin dejar ningún espacio, escribimos el identificador al que hace referencia el enlace. Además tenemos que dar el atributo de oculto a este identificador. En Formato | Fuentes tenemos el atributo oculto.

Para que el texto oculto lo podamos ver durante la edición, nos vamos al menú Herramientas, y a la opción Opciones. Ahí tenemos una Ficha que se llama Ver, y dentro de ella, en el grupo Símbolos no imprimibles, activamos la opción Texto oculto.

Compilamos nuevamente el proyecto y ya tenemos listo el archivo de ayuda listo

Insertando Imagenes

Para insertar imagenes utilizamos el comando {BMC imagen.bmp}, para no tener inconvenientes durante la compilacion de la ayuda, se recomienda poner las imagenes en el mismo directorio del proyecto de ayuda.
Tambien podriamos indicarle al compilador donde se encuentran los graficos, para eso hacemos clik en el boton "Bitmaps..", y los seleccionamos.
Pero siempre es mejor idea ubicarlos en un solo sitio, y que este sea el directorio de el proyecto de ayuda.