Publicación de un documento como ayuda HTML (solo Windows)
Requisitos previos: Arbortext Publishing Engine, Arbortext Styler o Opción Desktop Composer y HTML Help Workshop
Es posible usar Arbortext Editor para transformar documentos XML en ayuda HTML. La opción > > permite dividir el documento en temas HTML independientes y luego combinarlos en un fichero .chm. Por defecto, Arbortext Editor está configurado para crear ayuda HTML para documentos según el tipo de documento XML DocBook de Arbortext (axdocbook.dtd). Para publicar como Ayuda HTML documentos basados en otros DTD, póngase en contacto con los servicios de consultoría.
La opción Para Ayuda HTML aparecerá en el menú Publicar, pero no estará disponible hasta que se instale Microsoft HTML Help Workshop. Para descargar la última versión disponible, visite el sitio Web de Microsoft en http://www.microsoft.com. Busque la descarga en la biblioteca MSDN (probablemente no aparecerá entre las descargas estándar), y asegúrese de instalar toda la aplicación Workshop, y no sólo el visor.
Es necesario iniciar y cerrar HTML Help Workshop una vez antes de poder elegir > > .
 |
Si el documento incluye gráficos, debe especificar los atributos de ancho y alto de gráfico en píxeles para que se establezcan en la salida HTML. Los exploradores Web no pueden interpretar los atributos de ancho y alto de gráficos especificados en unidades distintas de píxeles.
Las ecuaciones con entrada TeX se mostrarán como cuadros en blanco en la salida HTML.
|
Para publicar un documento para ayuda HTML:
1. Para publicar ayuda HTML en los idiomas CJK, es necesario seleccionar primero la configuración regional y el idioma correspondiente en Windows. Consulte en la documentación del sistema operativo Windows el modo de cambiar la configuración regional y el idioma.
2. Elija > > . Se abrirá el cuadro de diálogo Publicar para ayuda HTML.
3. Especifique la ruta y el nombre del fichero donde desea guardar la ayuda HTML en el campo Guardar como. Pulse Inspeccionar para buscar un fichero existente.
4. Seleccione la opción Ver fichero de ayuda para ver el documento en el visualizador de ayuda HTML una vez publicado.
|
|
Si se selecciona la opción Ver fichero de ayuda y el nombre de fichero de documento incluye un símbolo (&), Arbortext Editor responderá que no puede arrancar el visualizador de ayuda HTML. Seleccione Sí para publicar con el visualizador desactivado, o No para cancelar el proceso de publicación.
|
5. Seleccione la hoja de estilo adecuada en la lista Hoja de estilo. Las hojas de estilo que soportan la publicación para Web también pueden aplicarse a la ayuda HTML. Pulse Inspeccionar para buscar una hoja de estilo existente que no aparezca en la lista.
Si se aplica el Uso de Arbortext Publishing Engine para publicar documentos, en la lista se muestran las hojas de estilo disponibles en el servidor Arbortext Publishing Engine. La anotación (pe) aparece en el nombre de la hoja de estilo. Las hojas de estilo se desestiman y no se pueden enviar al servidor con el documento.
6. Si se está publicando un documento DITA que tiene un fichero DITAVAL asociado, elija este fichero de la lista Fichero DITAVAL. Pulse en Inspeccionar para buscar un fichero DITAVAL existente que no aparezca en la lista.
7. Si el documento dispone de control de cambios, se podrá publicar en cualquiera de los estados del control de cambios. Por defecto, la vista de control de cambios de la ventana de edición está seleccionada, excepto cuando se realiza una publicación de un mapa DITA.
Si se está publicando un mapa DITA, la opción Cambios aplicados está seleccionada por defecto. Cuando se publica desde un mapa DITA, la vista Control de cambios que está seleccionada solo se aplica a los temas a los que se hace referencia desde los mapas DITA. El propio mapa DITA, así como los demás mapas a los que se hace referencia, siempre se publicarán con Cambios aplicados, independientemente de la vista Control de cambios seleccionada (incluso si un mapa tiene marcadores de control de cambios).
Las opciones son las siguientes:
◦ Cambios realzados: permite mostrar todos los cambios propuestos, realzados con marcas de revisión.
◦ Cambios aplicados: permite mostrar todos los cambios propuestos incorporados al documento, sin marcas de revisión.
◦ Original: permite mostrar el documento original sin incorporar los cambios propuestos en el documento.
8. Si se activa la opción Poner transacción en cola, se le solicitará al usuario el nombre de fichero de Guardar como y si se debe Ver fichero de ayuda al recuperar el resultado de la lista de Transacciones en cola, disponible en el menú Herramientas. Si se elige la opción Poner transacción en cola, se borrarán los valores de Guardar como y Ver fichero de ayuda en el cuadro de diálogo. Si se han introducido valores en estos campos, éstos se mostrarán de nuevo si se despeja la casilla Poner transacción en cola.
El comportamiento de Poner transacción en cola se controla mediante un conjunto de Arbortext Publishing Engine.
9. Elija si desea introducir un Nombre de transacción. El nombre de la transacción se mostrará al recuperar el resultado de la lista de Transacciones en cola, disponible en el menú Herramientas.
Para introducir nombres de transacción para utilizarlos por defecto o para tipos de salida concretos, introduzca valores en el Cuadro de diálogo Nombres de transacciones en cola.
10. Si desea aplicar perfiles al documento, pulse Definir perfiles para abrir el cuadro de diálogo Definir perfiles. Pulse Aceptar o Cancelar para salir del cuadro de diálogo Definir perfiles. El botón Definir perfiles sólo está disponible si se han configurado perfiles para el tipo de documento seleccionado.
11. Para crear una regla de publicación, pulse en Crear regla para abrir Crear regla de publicación nueva, donde se puede crear una nueva regla o conjunto de reglas de publicación para publicar ayuda HTML.
12. Pulse en Aceptar en el cuadro de diálogo Publicar para ayuda HTML.
Tenga en cuenta los siguientes elementos durante la publicación en la ayuda HTML:
• Si se aplica el Uso de Arbortext Publishing Engine para publicar documentos, es necesario que HTML Help Workshop esté instalado en el servidor Arbortext Publishing Engine. Si está marcada la opción Ver fichero de ayuda cuando se devuelve el fichero de ayuda HTML publicado, Arbortext Editor lo mostrará en el Visualizador de ayuda HTML local.
• Durante el proceso de publicación, Arbortext Editor reemplaza algunas entidades de carácter que no se visualizan correctamente. Las entidades de carácter de reemplazo se definen en ruta-Arbortext\composer\htmlHelpNavEntSub.xml. Este fichero sólo determina la sustitución de entidades en el panel de navegación de la ayuda HTML, y no en el panel de contenido.
• Arbortext Styler soporta tres métodos diferentes para incluir información CSS en la salida HTML. Consulte la sección sobre ficheros CSS en salida HTML para obtener más información.
• El compilador de ayuda HTML de Microsoft (hhc.exe) no puede crear ficheros .chm en un directorio cuya ruta contenga un nombre de carpeta que comience por un punto. Si la variable de entorno APTCACHE especifica un directorio con una carpeta de este tipo, el compilador de ayuda fallará cuando se intente crear un fichero .chm. Una solución alternativa consiste en utilizar la variable de entorno APTCACHE para especificar un directorio cuyos nombres de carpeta no comiencen por punto.
HTML Help Workshop a veces tiene problemas para configurarse en las versiones actuales de Microsoft Windows. Después de instalarlo, se debe ver una opción de menú > > en Arbortext Styler. Si esta opción está desactivada, significa que Arbortext Styler no puede identificar el programa que se debe utilizar para los ficheros de ayuda HTML.
Para corregirlo, se puede forzar la asociación de ficheros *.hhp con HTML Help Workshop:
1. Cree un fichero vacío llamado "dummy.hhp".
2. En Explorador de Windows, pulse dos veces en el fichero. Se recibe un mensaje de Windows preguntándole qué programa desea utilizar para abrirlo. Seleccione la opción More programs, navegue hasta C:\Archivos de programa (x86)\HTML Help Workshop y seleccione hhw.exe. Asegúrese de que la opción Always use this program esté seleccionada.
3. Si Arbortext Styler está abierto, ciérrelo y vuelva a abrirlo. La opción de publicación de ayuda HTML está ahora disponible.