Por qué se rompen los caracteres internacionales en los archivos CHM y cómo lo soluciona HelpNDoc

Publicar archivos de ayuda de calidad profesional a menudo requiere compatibilidad con varios idiomas, de húngaro a japonés, griego o chino. Sin embargo, si alguna vez has generado un archivo CHM de ayuda y has descubierto que algunas letras tienen un aspecto extraño (como una ő sustituida por Q, una ű que aparece como q o signos de interrogación en vez de caracteres), has dado con una limitación profundamente enterrada en la historia del formato CHM. Por suerte, la herramienta de creación de documentación de ayuda HelpNDoc se ha diseñado teniendo estos retos presentes y ofrece un potente conjunto de herramientas para ayudarte a crear archivos CHM de ayuda precisos en múltiples idiomas. Examinemos más de cerca la causa de este problema y la fácil solución provista por HelpNDoc.

📜 La herencia de los archivos CHM: un formato anterior a Unicode

Aunque los archivos CHM se siguen usando ampliamente hoy en día, fueron creados en un momento en el que el software tenía unas presunciones muy diferentes sobre idiomas, conjuntos de caracteres y codificación.

Los archivos HTML compilados de ayuda (CHM) fueron presentados por Microsoft a finales de los 90 como una alternativa moderna a WinHelp. Sin embargo, aunque el HTML en sí estaba evolucionando rápidamente hacia una compatibilidad total con Unicode, el formato CHM (y lo que es más importante, el compilador Microsoft HTML Help Workshop) continuó vinculado a las antiguas codificaciones ANSI.
Esto significa que los archivos CHM no son compatibles nativamente con Unicode. En vez de ello, esperan que el contenido se corresponda con una página de códigos específica, un sistema que mapea los valores de bytes en caracteres según un idioma o región particular. En el caso de los idiomas de Europa occidental (inglés, francés, español, etc.), esta limitación suele pasar inadvertida. Pero en el caso de idiomas como el húngaro, el ruso, el griego, el árabe o el chino, entre otros, que requieren caracteres especiales no incluidos en el alfabeto latino, esta limitación se vuelve un problema grave.

En pocas palabras:

Cuando la página de códigos esperada por el compilador no coincide con los caracteres de tu contenido de ayuda, las letras especiales se rompen, sustituyen o resultan ilegibles.

Dónde aparecen los problemas en un archivo CHM

La corrupción de caracteres en los archivos CHHM suele notarse de inmediato en la Tabla de Contenidos. Pueden mostrarse caracteres especiales erróneamente en los títulos de los temas, incluso antes de que el usuario interactúe con el propio contenido. En algunos casos, las letras incorrectas también aparecen en el contenido de los temas, afectando a los encabezados o al texto del cuerpo cuando se utilizan caracteres no latinos. Además de en las páginas visibles, también aparecen problemas en la pestaña del Índice, donde las palabras clave pueden aparecer corruptas, o en la pestaña de Búsqueda, donde los resultados de búsqueda pueden mostrar títulos distorsionados o caracteres ilegibles. Como cada parte del archivo CHM procesa texto de manera ligeramente diferente durante la compilación, los errores de emparejamiento de codificación pueden causar errores inconsistentes en todo el archivo de ayuda.

Por suerte, las herramientas modernas de creación de documentación de ayuda como HelpNDoc permiten gestionar cuidadosamente y mitigar en gran parte estas limitaciones.

🛠️ HelpNDoc: una solución moderna para un formato antiguo

Reconociendo estas limitaciones, HelpNDoc integra funciones inteligentes que te ayudan a superar sin esfuerzo los retos de la codificación CHM.

Ajustes integrados de idioma y conjunto de caracteres

HelpNDoc te permite configurar fácilmente tu proyecto con el idioma y codificación de caracteres correctos, ayudándote a evitar la corrupción de caracteres en tus archivos CHM compilados.

Puedes acceder a los ajustes de idioma de dos maneras fáciles:

• Desde la pestaña de Inicio:

  • Haz clic en Opciones de proyecto.
  • Navega hasta la sección de Ajustes de idioma.

• Como alternativa, desde la Tabla de contenidos:

  • Haz clic en el tema de proyecto raíz (el primer elemento del árbol de la Tabla de contenidos).
  • Esto abrirá el Panel de opciones de proyecto.
  • Navega hasta la sección de Ajustes de idioma.

En los Ajustes de idioma puedes definir:

• El idioma del proyecto (como húngaro, griego, chino, etc.).
• El conjunto de caracteres de proyecto adecuado (como centroeuropeo).

Ajustar correctamente estas opciones garantizará que los temas, entradas de índice, palabras clave y base de datos de búsqueda de tus archivos CHM se compilen con la codificación de caracteres correcta, ofreciendo una experiencia consistente y profesional a todos los lectores.

Orientación sobre el idioma local del sistema de Windows

Como el compilador Microsoft HTML Help Workshop sigue leyendo los ajustes de sistema, HelpNDoc también ofrece una orientación clara para configurar el ajuste “Idioma para programas no Unicode” de Windows. Si el idioma local de tu sistema Windows no coincide con el idioma de tu proyecto (por ejemplo, si tu instalación de Windows está en inglés pero estás produciendo documentación en húngaro), es posible que haya caracteres corruptos a pesar de configurar el conjunto de caracteres correcto.

Por suerte, es fácil de arreglar:

• Abre los ajustes de Región (intl.cpl)
• Navega hasta la pestaña Administración
• Cambia el Idioma local del sistema al idioma deseado
• Reinicia si es necesario

HelpNDoc documentation te guía a través de estos pasos para garantizar una experiencia sin contratiempos.

Función “Usar conjunto de caracteres de proyecto para los temas”

En algunos casos, ni siquiera basta con configurar el conjunto de caracteres y el idioma local del sistema, especialmente para los idiomas que utilizan scripts o clústeres de caracteres más complejos. Por eso, HelpNDoc ofrece una protección adicional para asegurar una codificación correcta de caracteres con la función “Usar conjunto de caracteres de proyecto para los temas”. Así puedes habilitarla:

• En la pestaña Inicio, haz clic en la parte superior del botón Generar ayuda para abrir el cuadro de diálogo Generar documentación.
• En la lista de disposiciones, selecciona tu disposición CHM.
• Si la pestaña Ajustes de plantilla no es visible, haz clic en Personalizar para mostrarla.
• En la pestaña Ajustes de plantilla, marca la opción “Usar conjunto de caracteres para los temas”.
• Una vez seleccionada, vuelve a generar la documentación para aplicar el cambio.

Esta opción asegura que todos los temas HTML generados usen explícitamente el conjunto de caracteres correcto al ser compilados en el archivo CHM, evitando inconsistencias accidentales entre la codificación del archivo del tema y la del proyecto general. Se trata de una capa adicional de protección que aumenta dramáticamente la tasa de éxito al trabajar con idiomas no occidentales.

Lista rápida de comprobación para obtener archivos CHM multilingües perfectos

Este es un sencillo proceso que puedes seguir usando HelpNDoc:

1. Ajusta el idioma y conjunto de caracteres de proyecto correctos: por ej., húngaro + centroeuropeo
2. Ajusta el idioma local de tu sistema Windows al mismo que el idioma del proyecto
3. Habilita “Usar conjunto de caracteres de proyecto para los temas en los ajustes de tu disposición CHM
4. Genera tu archivo de ayuda CHM
5. Verifica que todas las secciones (títulos de los temas, índice, palabras clave, búsqueda y contenido) se muestren correctamente

Con la ayuda de HelpNDoc, hasta los proyectos multilingües más desafiantes se vuelven fáciles de gestionar.

🚀 De cara al futuro: más allá del formato CHM

Aunque el CHM sigue siendo un formato popular, la documentación moderna a menudo requiere mayor flexibilidad. HelpNDoc hace fácil dejar atrás el CHM generando múltiples formatos de producción para el mismo proyecto - sin esfuerzo adicional.

Con HelpNDoc puedes crear instantáneamente un sitio web HTML totalmente dinámico de ayuda en línea, crear documentos Word de aspecto profesional para manuales impresos o exportar archivos PDF para una fácil distribución y archivado. HelpNDoc también es compatible con eBooks ePub y Kindle para lectores móviles y de libros electrónicos, Markdown para desarrolladores que prefieren la documentación ligera y portátil y archivos Qt Help para la integración con aplicaciones basadas en Qt.
Con HelpNDoc puedes personalizar tu documentación para cualquier público objetivo o requisito técnico, todo desde un solo proyecto de origen, sin tener que reescribir ni volver a dar formato al contenido.

🏁 Conclusión: superar las limitaciones de CHM con HelpNDoc

Aunque los archivos CHM pertenecen a la época anterior a Unicode, siguen siendo útiles para muchos usuarios, siempre que se entiendan sus limitaciones y se gestionen cuidadosamente.

HelpNDoc no solo reconoce estos obstáculos técnicos, además ofrece una solución detallada y fácil de usar para asegurar que tus archivos de ayuda sean precisos, pulidos y profesionales con cualquier idioma y conjunto de caracteres. Ya publiques en húngaro, griego, chino, árabe, japonés u otro idioma, HelpNDoc te capacita para producir documentación profesional con unas cuantas funciones bien pensadas.
👉 Descarga HelpNDoc hoy (gratis para uso personal) y empieza a crear documentación multilingüe sin tacha en CHM, HTML, Word, PDF, eBooks y más, en solo unos cuantos clics.

Ver también...

Cómo personalizar la posición y tamaño iniciales de los archivos CHM Help

Con HelpNDoc, crear archivos CHM (Compiled HTML Help) es muy rápido gracias a su interfaz fácil de usar y sus potentes funciones. En este artículo, exploraremos cómo configurar el tamaño y la posición …

Lee Mas →

Equilibrio entre seguridad y usabilidad: los mejores formatos de documentación para compartir a nivel interno

Compartir documentación de manera eficaz y segura es fundamental en el entorno laboral actual. Ya se trate de la distribución interna de manuales, documentación de proyectos o políticas de empresa, la …

Lee Mas →

Aprovechar HelpNDoc al máximo: Beneficios de la función "Mantener Archivos Temporales" para los escritores técnicos

Al trabajar creando documentación técnica, toda herramienta y función de la que dispongamos puede marcar una diferencia considerable en la productividad y la eficacia. En HelpNDoc, una de estas …

Lee Mas →

Cómo crear un archivo de ayuda CHM: utiliza un software moderno de creación de documentación de ayuda en vez del anticuado HTML Help Workshop

Los archivos de ayuda CHM se utilizan para crear documentación y archivos de ayuda en línea para aplicaciones de software, plugins y drivers, y suelen ser distribuidos con instaladores de Windows. Hay …

Lee Mas →