HTML Help Workshop
Utilidad para crear un sistema de ayuda basado en páginas HTML

Entrega número Dos

Publicado el 30/Jun/98
Autor: Guillermo 'guille' Som


Continuamos con el tema este de la ayuda en formato Windows98

En esta entrega vamos a crear varios links dentro de una misma página y varios niveles de libros/carpetas.
Y otras cosillas que lo mismo se me ocurren sobre la marcha.

Abre el proyecto que creamos en la entrega anterior y vamos al tajo.

Crear varios niveles

  • Para crear varios niveles, posiciónate en la solapa de Contents, pulsa en la hoja que tiene el título de la primera entrega.
  • Pulsa en el botón del lápiz (edit selection)
  • Pulsa en la solapa Advanced
  • Marca la segunda casilla (Change entry to a heading)
  • Si quieres usar otra imagen, seleccionala en Image index, por ahora dejaremos la del libro.
  • Pulsa en la hoja para insertar otra página.
  • En el título escribe: Manos a la obra
  • Pulsa el botón Add... y selecciona HTML Workshop -Primera (hhw01.htm)
  • Posiciónate en la casilla en la que ha aparecido hhw01.htm.
  • A continuación del nombre escribe el nombre del marcador, precedido por el signo #.
    No he encontrado una forma de poder seleccionar los marcadores disponibles, así que habrá que hacerlo manualmente.
  • Escribe Manos_a_la_obra, de forma que quede así: hhw01.htm#Manos_a_la_obra
  • Ahora vamos a cambiar el dibujillo que se mostrará.
  • Pulsa en la solapa Advanced y selecciona el icono número 35 (de la opción Imagen index)
  • Pulsa en OK y ya está.
  • Añade las siguientes hojas, al menos ponle los títulos y la página a la que deberá linkar.
  • Los marcadores, si quieres puedes ponerlos usando un editor de texto o bien escribiéndolos como hemos hecho en este que acabo de explicarte.

Añadir nuevos ficheros.

  • Antes de poder crear nuevos libros para un nuevo fichero, hay que añadir el fichero al que queremos hacer referencia
  • Pulsa en la solapa Project.
  • Pincha en el segundo botón, el que tiene una carpeta con una hoja, (Add/remove topic file).
  • Pulsa en el botón Add... y selecciona hhw02.htm, pulsa en OK.
  • El fichero que hemos añadido estará junto a los otros dos bajo la sección [Files]
  • Pulsa de nuevo en la solapa Contents
  • Selecciona el último icono, si no lo haces, lo que añadas, se hará a continuación de la selección.
    De todas formas, si te equivocas, puedes usar las flechas de movimiento para cambiar la posición de cualquiera de las imágenes, también puedes cambiar el orden arrastrando uno de los iconos hasta la nueva posición.
  • Pulsa en el botón con el libro y te mostrará el diálogo para añadir un nuevo encabezado.
  • Ya sabes, escribe el título (Entrega número Dos) y selecciona la página que se mostrará cuando se pulse en el libro.
    Si no quieres que se muestre ninguna página, como hicimos en el primero de todos los libros, simplemente no añadas ninguna página a la que linkar.
  • Añade un par de hojas con links a los marcadores: Crear_nuevos_niveles y Nuevos_ficheros de la página hhw02.htm

Un repaso a lo que tenemos

  • A estas alturas, tendremos un fichero de ayuda con unas cuantas opciones, acuérdate de añadir bajo el libro de la primera entrega los diez marcadores que hay en la página de la primera entrega (hhw01.htm)
  • Si has probado con los diferentes estilos y quieres dejarlo todo como estaba (o casi), deja los siguientes estilos:
    Automatically track sellection
    Plus/Minus squares
    Scroll bar on the left
    Start line from the root
    Sunken edge
  • Algunas de estas opciones no se si realmente funcionan, pero...
  • Si has seguido los pasos que te he dicho, los dos libros que hacen referencia a las dos entregas, estarán indentados "dentro" del libro principal.
  • Si esto no fuera así, puedes cambiar el "nivel" de indentación con las flechas que señalan a izquierda/derecha.

Añadir nuevas solapas a la tabla de contenidos

  • Empezaremos por añadir una solapa para efectuar búsquedas.
  • Si no está seleccionada la solapa Project, selecciónala y pulsa en el botón de propiedades.
  • Pulsa en la solapa Compiler y marca la casilla Compile full-text search information
  • Guarda los cambios y compila el fichero, verás que ahora tenemos dos solapas:
    Contents y Search
  • Pulsa en la solapa Search (búsqueda) y escribe en la casilla la letra que quieres buscar, pulsa intro
  • En la lista te mostrará los títulos de los ficheros en los que ha encontrado la palabra escrita.
  • Selecciona el fichero que quieras y haz doble click o pulsa en display.
  • Te mostrará el fichero y las palabras que ha encontrado estarán resaltadas.
  • Ten en cuenta que sólo busca palabras completas y en algunos casos las palabras completas no son lo que se espera.
    Por ejemplo, si buscas guille, verás que no encuentra 'guille', porque está entre apóstrofes...
    Pero puedes decirle que busque 'guille' y lo encontrará.
  • Si no quieres que resalte las palabras, pulsa en el botón Options del programa de ayuda (no del hhw) y marca la opción que pone: Search Highlight (On/Off según corresponda)
  • Puedes buscar partes de palabras usando los signos de comodín ? y *
  • De todas formas, el sistema de búsqueda es "medio" bueno, pero sólo medio...
    Aunque al menos permite buscar en el fichero sin tener que perder una eternidad como ocurría con los ficheros normales de ayuda del Win95 (.hlp)

La solapa Index

  • Vamos a añadir una nueva solapa: Index.
  • Pulsa en la solapa Index y te mostrará un diálogo preguntando si quieres crear un nuevo fichero o usar uno existente, déjalo tal como está y pulsa en OK.
  • Te preguntará el nombre y la carpeta en la que se guardará el índice, seguramente te volverá a salir "Mis Documentos".
  • Busca el directorio en el que tienes los ficheros de ejemplo y deja el nombre que te da por defecto: Index.hhk
  • Ahora tenemos una serie de botones que son casi los mismos que en la solapa de contenidos.
  • Los cambios son que ahora existe un botón para crear un índice (o clave) y que se pueden clasificar.
  • Este proceso es un poco más tedioso, ya que tendremos que especificar las claves que queremos que muestre y los links a los que debe hacer referencia (la verdad es que también es un poco rollo cuando se añaden hojas)
  • Pulsa en el botón con la llave
  • Escribe el nombre de la palabra clave, por ejemplo: Entregas
  • Pulsa en el botón Add... y selecciona el fichero que quieres que se muestre cuando se seleccione esa clave.
  • Si quieres añadir más ficheros, pulsa de nuevo en Add...
  • En esta clave, se deberían añadir los dos ficheros que tenemos de las entregas.
  • Pulsa OK y guarda el proyecto y compílalo.
  • Si observas que en algunas ocasiones no hace caso a la selección de opciones que le damos,
    cierra el proyecto y vuelve a abrirlo, lo vuelves a compilar y ya estará todo en su sitio.
  • Para crear subclaves, es decir como hojas en los libros, añade una nueva clave y pulsa en el botón de la flecha hacia la derecha, de esta forma, se incluye debajo de la clave anterior.
  • Podríamos añadir dos subclaves a la clave que acabamos de crear, para que hagan referencia a cada una de las entregas.
  • Para hacerlo, añade una clave y escribe en el nombre (cuadro de texto Keyword), Primera entrega
  • Pulsa en Add... y asocia el fichero de la primera entrega con esta clave.
  • Haz lo mismo con la Segunda entrega, pero asociando el fichero de la segunda entrega...
  • Cuando lo tengas, compila y prueba.
  • Cuando pulses en la solapa Index del fichero compilado, verás que te muestra tres claves:
    Entregas, Primera entrega y Segunda entrega.
  • Si haces dobleclick en cualquiera de las dos últimas, te mostrará la página correspondiente,
    pero si pulsas en Entregas, verás que te sale un cuadro de diálogo mostrándote las opciones disponibles.
  • Si quieres que una clave apunte a un Marcador (bookmark), tendrás que hacer lo mismo que con las hojas, es decir seleccionar la página y añadirle #nombre_marcador
  • Añade nuevas claves, las dejo a tu elección.
  • Recuerda que puedes cambiar el orden y la indentación con las cuatro flechas.
  • Si quieres que queden ordenadas, pulsa en el botón A/Z

Ventanas pop-up

  • La creación de ventanas Pop-Up (emergentes) y algunas otras "virguerías", se hacen por medio de un Wizard.
  • El problema es que no funciona todo lo bien que debiera, pero...
  • Para poder usar una ventana emergente es necesario tener un fichero HLP normalito en el que esté definido el "tópico" al que queremos llamar, así que por ahora lo dejamos y más adelante volveremos a verlo.
  •  
  • De todas formas si quieres hacerlo, sigue estos pasos:
  • Pulsa en la solapa Project
  • Haz doble-clic en prueba.htm para que se muestre el fichero html
  • Localiza la palabra HTML Help Workshop que está después de la tabla y que está en el párrafo que empieza con "Esta es la página inicial..." selecciónala.
  • Pulsa en el icono que tiene forma de cucurucho (realmente es el gorro del Mago)
  • Se mostrará un cuadro de diálogo, selecciona de la lista: Winhelp topic y pulsa en Next>
  • Selecciona la opción Hidden (only used for scripting) y pulsa Next>
  • Selecciona la opción In a pop-up window
  • En el primer cuadro escribe el nombre del fichero de ayuda, debe ser formato HLP.
    Debes especificar un path, aunque sea .\ para indicar que está en el mismo directorio que el fichero de ayuda.
    Si no especificas el path, el fichero se debe encontrar en el directorio Windows\Help, aunque te mostrará una serie de mensajes de error porque no encuentra el fichero de ayuda.
    Por supuesto que también puedes indicarle el path completo para evitar esos mensajes de error.
  • En el siguiente el nombre del tópico o clave a la que quieres hacer referencia dentro de ese fichero HLP
  • Pulsa en Next> y después a Finish y ya está.
  • Verás que ha añadido una serie de líneas que empiezan por <OBJECT
  • Aunque seguro que se habrá dejado algo pendiente, por ejemplo el que se muestre la frase subrayada.
  • Para que eso sea posible, tendrás que añadir las siguientes líneas:
    <PARAM name="Text" value="Text:HTML Help Workshop">
    <param NAME="FONT" VALUE="VERDANA,8,0x000800,underline">
  • Cierra el fichero para que se graben los cambios

Bueno, vamos a dejarlo por ahora que lo siguiente que viene es lo que realmente interesa: Conectar este tipo de ayuda con un programa de Visual Basic, pero eso será en la próxima entrega.

Nos vemos.
Guillermo

Si quieres bajarte los ficheros que se están usando, pulsa en este link (hhw2.zip 14.6 KB)


ir al índice principal