06 marzo 2008

Crear ficheros de ayuda de Windows (.CHM)

(Respondiendo a una consulta que he recibido hace poco por e-mail)

Crear ficheros de ayuda de Windows es sencillo. Las pautas básicas a seguir para crear un fichero elemental son:

  • Crear la ayuda, en formato HTML (una página web o varias enlazadas entre ellas).
  • Crear un pequeño fichero de texto, que será la descripción del fichero de ayuda (más adelante incluyo un ejemplo).
  • Descargar el "HTML Help SDK", una pequeña utilidad gratuita de Microsoft, de unos 3.3 Mb de tamaño, e instalarla.
  • Entrar al entorno (el fichero llamado HHW), abrir desde allí el fichero de descripción que habíamos creado y pulsar el botón "Compile HTML file".

Eso es todo (si no queremos índices ni otras características avanzadas, claro).

Un ejemplo de fichero, que crearíamos con cualquier editor de texto (incluso el "Bloc de notas" serviría) y que guardaríamos con el nombre "ejemplo.hhp" (el nombre puede ser cualquiera, pero la extensión HHP es importante).


[OPTIONS]
Compatibility=1.1 or later
Compiled file=ejemplo.chm
Default topic=index.htm
Display compile progress=No
Language=0xc0a Español (España)
Title=Ejemplo de fichero de ayuda

[FILES]
index.htm


Creo que todas las opciones son autoexplicativas. No hace falta indicar todos los ficheros en el apartado FILES. Basta con indicar cual es el principal, y automáticamente se incluirán todos los ficheros HTML y las imágenes que estén enlazados a partir de él.

En muy pocos segundos tendremos un único fichero comprimido que agrupa toda nuestra estructura web, incluso imágenes.