2. Componentes

Desde que Microsoft introdujo Windows 3.1 al mercado, se han creado archivos de ayuda como WinHelp 3 (para Windows 3.1 y sistemas operativos Windows NT 3.x) y WinHelp 4 (para Windows 9x y sistemas operativos Windows NT 4). Los archivos de ayuda de Windows (HLP) constan normalmente de varios archivos distintos, como: HPJ, CNT, RTF, y BMP/SHG (u otros archivos gráficos). Para crear un archivo HLP, un compilador(Microsoft Help Compiler) utiliza un archivo HPJ para compilar uno o más archivos RTF, y archivos de imagen (BMP o SHG) para generar un archivo HLP.

• HPJ (Proyecto de Ayuda): Es un formato de archivo de texto que contiene información esencial para el Help-Compiler de Microsoft, que sirve para juntar todas las ayudas individuales en una sola. Los archivos HPJ pueden ser editados con editores de texto; sin embargo, es preferible usar herramientas de localización para adecuar los archivos de ayuda traducidos. Los archivos HPJ constan de las siguientes secciones:
  • Opciones: para comprimir (zipping), protocolo de error, idioma, derechos de autor, tabla de contenido, índice, tabla de imágenes, etc.
  • Archivos lista de todos los archivos que deberían incorporarse a la ayuda
  • Mapa: En esta sección, se asigna una identificación de contexto a los temas de ayuda, para la ayuda dependiente del contexto
  • Windows: Esta sección contiene información sobre el tamaño, color, título y posición de las ventanas en las que los textos de ayuda serán mostrados
  • Config: Esta sección contiene macros - p.ej. para crear botones adicionales

Al localizar archivos de ayuda de Windows y en particular archivos HPJ, es importante saber que, por lo general, los elementos traducibles son: El título de la ayuda, la información sobre derechos de autor, el título de las ventanas y el nombre de los botones contenido en macros.

• CNT (Archivo de contenido): Este tipo de formato es usado por el Help Compiler de Microsoft para crear la tabla de contenido que será usada para los archivos de ayuda. Es un formato de archivo de texto que contiene los títulos de todos los temas de ayuda. Cada vez que el usuario accede a la ayuda, se genera la tabla de contenido basada en el archivo CNT. Al momento de localizar archivos CNT, el traductor/localizador debe considerar lo siguiente: a) Los títulos de ayuda y estructura del índice de contenido; y b) el texto que se encuentra antes del signo de igual (p.ej. «2 Creating a new document=WRIPAD_CREATE_DOCUMENT»). En un archivo cnt, cada línea empieza con el número de nivel seguido de un signo igual, que divide al texto traducible (a la izquierda del signo igual) de los códigos, que son identificaciones del tema de ayuda (a la derecha del sígno igual).
• RTF (Rich Text Format): Este archivo contiene en realidad el texto de ayuda y puede ser editado con un procesador de textos común o un sistema de memoria de traducción. Entre los elementos traducibles de un archivo RTF se encuentran: El cuerpo del texto (texto oculto de identificación de contextos, códigos para representar símbolos y gráficos, texto con subrayado simple para los campos emergentes y texto con subrayado doble para los enlaces); notas a pie de página - algunas comienzan con «$» (para los títulos de los temas de ayuda) y otras con «K» (para los índices e índices de palabras clave).
• Archivos BMP/SHG: La mayoría de los gráficos en los archivos de ayuda son archivos bitmap con la extensión BMP o SHG. Los gráficos son integrados durante la compilación de archivos
• El archivo HLP, producto de la compilación, es el archivo de ayuda final.

(Adaptado de Esselink, 2000, y Whale 2000b)

La diferencia principal entre los archivos de ayuda de MicrosoftWinHelp y HTML son los archivos de origen usados para crear los archivos de ayuda en línea. Los archivos WinHelp son creados a partir de archivos Rich Text Format (*.rtf) y los archivos de ayuda HTML a partir de archivos HTML y archivos gráficos como *.jpg y/o *.gif. Los Archivos de Ayuda Compilados (CHM) basados en HTML constan generalmente de varios archivos distintos, como: HTML, HHC, HHK y archivos de imágenes (GIF o JPG). Se utiliza un archivo HHP, que contiene la configuración de ayuda completa (como el compilador Micrososft's HTML Help Workshop), para recopilar uno o más archivos HTML y de imágenes para generar un archivo CHM.

• Archivos HTML: Los archivos HTML usados en proyectos de ayuda son editados como los archivos HTML normales, usando un sistema de MT o un editor HTML. Puesto que los archivos HTML contienen etiquetas con información de formato y texto simple, se deben proteger las etiquetas y traducir el texto.
• Archivos HHP: Estos archivos de texto contienen la configuración completa usada para compilar el archivo de ayuda HTML. Se los puede editar usando el editor de texto. Los elementos traducibles en estos archivos son, por ejemplo: el título del archivo de ayuda HTML que se puede ver en la barra de título del archivo de ayuda; los títulos de las ventanas; los nombres de los botones; el texto en los campos emergentes, etc.
• Archivos HHC: Estos archivos, también conocidos como archivos sitemap, contienen las tablas de contenido para los archivos de ayuda HTML. Para localizar estos archivos se puede utilizar un editor de texto o un editor HTML.
• Archivos HHK: Estos archivos reemplazan la palabras clave y notas a pie de página de los archivos RTF utilizados en los proyectos WinHelp. Éstos contienen la lista de palabras clave de búsqueda incluída en los archivos de ayuda HTML. Se pueden traducir los archivos HHK utilizando un editor de texto o sistemas de memoria de traducción.

Se cree que tanto el formato HTML como HTML Help serán los formatos para proyectos de ayudas más usados en el futuro.

(Adaptado de Esselink, 2000)

Los archivos Léeme son normalmente documentos de texto (*.txt) sin la información de formato que suele venir en los discos de montaje de la aplicación. Estos archivos contienen información que puede no haber estado disponible cuando fueron creados o impresos los manuales - como correcciones, adiciones, etc. Los archivos Léeme pueden ser editados con un editor de texto como Notepad o con Microsoft Word si son archivos *.doc.