Generar archivo compilado HTML de ayuda (CHM) a partir de documento de MS Word

¿Alguna vez has necesitado generar un archivo compilado HTML de ayuda (CHM) para tu programa? ¿Tienes el manual de usuario en un documento de MS Word? ¡No hay problema! Para generar archivos compilados HTML de ayuda desde archivos de MS Word, existe un programa llamado chmProcessor. Este programa es gratuito y de código abierto, publicado bajo la licencia GPL.

El programa chmProcessor puede descargarse en: http://chmprocessor.sourceforge.net/#Downloads

Los requerimientos para utilizar este programa son:

• Sistema operativo Microsoft Windows: del 2000 al 10, de 32 o 64 bits (desde la versión 1.5 de chmProcessor en adelante).
• Microsoft .NET Framework 2.0
• HTML Help Workshop: Sirve para compilar la ayuda en archivo CHM.

A continuación se describen los pasos básicos para generar un archivo HTML compilado y un sitio web de ayuda utilizando chmProcessor:

1.  Crea tu manual de uso en un documento de MS Word (chmProcessor 1.7.x soporta archivos de MS Word del 2000 al 2013, pero no de versiones Starter). Es importante mencionar que el índice de contenido de la ayuda se generará en base a los estilos de título utilizados en el documento de MS Word. El nivel del título indicará el nivel de anidamiento del tema en el índice.



Para los que no son “del Imperio”, chmProcessor también permite utilizar archivos HTML, en cuyo caso el índice se genera en base a las etiquetas (h1, h2, h3…).

2.   Instala el programa chmProcessor (si aún no lo tienes instalado) e inícialo. Luego de instalarse, en Windows 7 puede encontrarse en Inicio > Todos los programas > chmProcessor.

3.  En la parte superior de la ventana se debe agregar uno o más archivos fuente, que son los documentos de MS Word a partir de los cuales se generará la ayuda. Para ello, se debe presionar el botón Add, y luego seleccionar el documento de Word respectivo.


4.  Una vez seleccionado el archivo, este aparece en el listado ubicado en la parte superior de la ventana. Puede notarse además que en la parte de abajo, en el campo Dst. File aparece automáticamente la ruta y nombre del archivo CHM que se va a generar. Puede observarse que dicho archivo por defecto será generado en el mismo directorio donde se encuentra el archivo de Word fuente. La ruta y el nombre del archivo destino pueden modificarse editando directamente en la caja de texto, o presionando el botón de puntos suspensivos ubicado al lado de la caja de texto, lo cual abrirá una ventana de diálogo en la que se permitirá especificar el archivo destino.


5.   De forma opcional, es posible también generar un sitio web de ayuda. Para ello se selecciona la ficha Web Help, y se marca la casilla Generate Web, ubicada en la parte media izquierda de la ventana. Con ello se habilitan los campos a la derecha, que permiten especificar diversas opciones del sitio web a generar. La principal opción es Dst. Web directory, que es el directorio destino donde se generarán los archivos del sitio web. Este se asigna por defecto en la misma ruta donde se ubica el archivo Word fuente, pero puede ser modificado.


6.  Una vez establecidos todos los parámetros, se presiona el botón Generate. El programa procede a generar los archivos de ayuda, mostrando una ventana emergente en la que muestra las acciones que va realizando.



7.  El programa indica la finalización del proceso en la ventana emergente. En este momento solo queda presionar el botón Accept.



Al abrir los directorios destino, pueden observarse los archivos generados. En este caso, puede observarse que se ha generado el archivo Manual de usuario.chm, que es el archivo de ayuda HTML compilado, así como la carpeta Manual de usuario-web, que contiene el sitio web.


Al abrir el archivo CHM, se obtiene un resultado similar a este:


Para ver el sitio web, se ingresa a la carpeta que lo contiene (Manual de usuario-web), y se abre el archivo index.html.


Este es el resultado (visto en el navegador web Firefox).


Adicionalmente, si se quiere guardar la configuración actual de chmProcessor para generar los archivos de ayuda, basta con seleccionar el menú File > Save as… e indicar el nombre y ubicación del archivo de proyecto.


Este fue un ejemplo básico sobre el uso de chmProcessor, pero este programa incluye muchas más opciones y beneficios. Para obtener mayor información puedes visitar su sitio web: http://chmprocessor.sourceforge.net/