Los archivos CHM no funcionan – aparecen en blanco

Para algunos de los lectores de esta crónica, esta información les será útil y seguramente habrán llegado a la misma porque están tratando de utilizar un archivo CHM que aparece erróneo; otros lectores, quizás estén aquí por curiosidad o sugerencia, y finalmente habrá una que otra persona que no ha tenido ocasión de trabajar con tales archivos.

Si vienes buscando solución al problema de tener un chm que se muestra en blanco o que no funciona, no prolongaré la espera; lo que sucede es que en Windows 7 y en adelante, los CHM se bloquean por seguridad. Se deben habilitar manualmente para que su contenido se muestre y se activen las funcionalidades de los mismos. No transcribiré aquí la receta para solventarlo, ya que tampoco deseo robar el crédito. En la siguiente liga encontrarás paso a paso cómo hacerlo:

https://stackoverflow.com/questions/15037029/php-manual-chm-file-is-not-working

Si estás en este párrafo, entonces supondré que he atrapado tu atención y me dispondré a desarrollar estra crónica con un poco de historia.

Para el ojo escrutador, resultará evidente el porqué llegué a la url de stackoverflow. Descargué el manual de usuario de PHP en formato chm y al abrirlo me aparecía en blanco.

Pensé que había descargado una versión equivocada o que el archivo descargado tenía error, así que intenté descargarlo nuevamente y cambiar de versión. Ambos esfuerzos derivaron en el mismo fracaso, sin importar cuál, siempre veía el archivo en blanco y con sus controles inhabilitados. En los foros del sitio de PHP no había mención alguna a los administradores acusando errores en los archivos, por lo que evidentemente el problema estaba de mi lado.

Finalmente escribí en el buscador precisamente eso, manual php chm not working y la solución apareció.

¿Por qué un chm y no consultarlo directamente en internet o descargar el compendio en html, si también está disponible?

Busqué el chm por conveniencia personal. Conocí PHP por el ya lejano año 2001; el lenguaje estaba en su versión 3.x y no tardaba en desplegar su versión 4.x. El acceso a Internet no era tan sencillo, flexible, y sobre todo, tan barato como ahora, por lo que el tiempo en línea era valiosísimo. Pensar en consultar el manual en internet así estaba fuera de mis capacidades tecnológicas y financieras. Urgando entre la sección de documentación del lenguaje ví que la documentación estaba disponible en CHM.

En aquellos años, como ahora, en las aplicaciones para MS Windows, al apretar la tecla F1 la ayuda se mostraba, y normalmente, lo que se abría era un archivo chm. De hecho, si eras temerario y te adentrabas en las carpetas «prohibidas» de Windows (Program Files o el famoso Progra~1) y navegabas dentro de las carpetas de MS Office y otros tantos, los chm estaban a tu alcance.

La gracia de estos archivos está en su naturaleza. CHM es un formato de archivo cuyo contenido es HTML compilado (Compiled HTML) y era normalmente utilizado por Microsoft para mostrar la ayuda y documentación de sus suites (por Microsoft y otros fabricantes).

Estos archivos están compuestos por varios documentos HTML comprimidos, y pueden incluir imágenes y otros componentes soporte, como código Javascript, todo en un solo compendio, lo que permite tener un mini sitio web estático en un único archivo. El visor de CHM, además, permite navegar esta colección de archivos, presentando una tabla de contenido en forma de árbol, un índice de temas y funcionalidad de búsqueda de texto completa (full text searching).

El índice permite hacer búsqueda por temática, lo que resulta bastante útil si se está familiarizado con la terminología de lo que se consulta.

Como mencioné unos párrafos antes, el visor de CHM permite realizar full text search, y para el particular de PHP, por ejemplo, buscar por función/comando es muy sencillo. Como se aprecia en la imagen, full text search permite agregar caracteres de control como «+» «-» para hacer la búsqueda más precisa.

Finalmente y para cerrar esta crónica, repito que he buscado explícitamente el manual de PHP en este formato por conveniencia… Y nostalgia, quizás. Para quien escribe, el hecho de tener toda la documentación a la mano sin necesidad de estar navegando en internet es sumamente práctico, no sólo en el equipo propio, sino como un archivo que cargo en una usb que llevo conmigo.