Matriz de generación, ítems de biblioteca de código bruto y compatibilidad con fragmentos externos en HelpNDoc 10.7

Nos complace anunciar el lanzamiento de HelpNDoc 10.7, una nueva actualización centrada en ofrecer a los escritores técnicos una información más clara, una reutilización de contenido más flexible y mayor fluidez en los flujos de trabajo diarios de creación de contenido. Esta versión presenta una potente Matriz de generación en el Analizador de temas, facilitando la comprensión exacta de por qué se incluye o no cada tema en cada disposición de un proyecto. Además, hemos mejorado la gestión del contenido reutilizable con el nuevo ítem de biblioteca de código bruto y añadido compatibilidad con archivos de fragmentos externos, así como considerables refinamientos en el editor de imágenes, el editor de temas, el editor de ecuaciones, la generación de contenido condicional y la fiabilidad en general.

Como siempre, HelpNDoc es gratuito para uso personal y de evaluación, así que puedes descargar HelpNDoc 10.7 hoy y explorar personalmente todas las mejoras de esta versión.

🧩 Matriz de generación: comprende exactamente por qué se exportan los temas

La nueva Matriz de generación del Analizador de temas explica por qué se va a exportar (o no) el tema actualmente analizado para cada disposición del proyecto.

El Analizador de temas de HelpNDoc es una herramienta esencial para entender los temas individuales. Proporciona estadísticas detalladas como el número de párrafos, palabras e ítems de biblioteca utilizados en un tema. También crea una lista de hipervínculos, marcadores, hipervínculos entrantes, condiciones, palabras clave, errores de ortografía y hasta los caracteres individuales que contiene el tema.

HelpNDoc 10.7 aumenta todavía más la utilidad del Analizador de temas con la nueva Matriz de generación. Para el tema que se esté analizando, la matriz proporciona una explicación por disposiciones de los temas exportados y el motivo de la exportación. Esto resulta especialmente valioso en los proyectos en los que se generan múltiples producciones, como un manual de usuario público, una base interna de conocimientos, una guía en PDF o una exportación Markdown, cada una con sus propias reglas de etiquetas, estatus y visibilidad.

Para cada disposición, la Matriz de generación verifica el tema y su jerarquía superior. Si el propio tema, o uno de sus temas padre, está oculto para una disposición, la matriz indicará claramente que el tema no será exportado. También comprueba las reglas de estado de los temas; por ejemplo, cuando una disposición excluye temas marcados como “En progreso”, cualquier tema o tema padre que utilice ese estado se excluirá de esa producción. Por último, analiza la correspondencia de etiquetas integradas y personalizadas entre temas, temas padre y disposiciones, dejando claro cuándo se excluye un tema porque se no corresponde con la configuración de etiquetas de la disposición.

Esto proporciona una respuesta inmediata a una de las preguntas más frecuentes de la publicación de documentación: "¿Por qué falta este tema en mi producción?" En vez de comprobar manualmente uno por uno los ajustes de la disposición, la visibilidad del tema, la visibilidad del tema padre, los filtros de estado y las reglas de etiquetas, los escritores ahora pueden encontrar la explicación completa en un solo sitio.

🧾 Ítem de biblioteca de código bruto: código personalizado específico de formato para cada producción

El antiguo ítem de biblioteca de código HTML se ha renombrado y ampliado a código bruto, añadiendo soporte para contenido HTML, Markdown y basado en texto.

El ítem de biblioteca antes conocido como código HTML se ha mejorado mucho en HelpNDoc 10.7 y ahora se llama código bruto. Este nuevo nombre refleja su función ampliada: en vez de verse limitado a formatos de documentación de HTML bruto o basados en HTML, ahora puede proporcionar contenido específico de formato para múltiples tipos de producción.

Los ítems de código bruto siguen pudiendo incluir código HTML para los formatos de documentación basados en HTML como CHM, HTML y producciones compatibles para libros electrónicos, pero ahora también pueden incluir contenido Markdown bruto para disposiciones Markdown, donde el código se exporta directamente como Markdown. Para todos los demás formatos de documentación, los elementos de código bruto pueden proporcionar contenido de texto plano que se exporta tal cual.

Esto abre la puerta a una personalización mucho más precisa de la producción. Los escritores técnicos y desarrolladores ahora pueden definir un único ítem de biblioteca reutilizables que se adapta a la documentación que se está generando. Por ejemplo, el mismo bloque conceptual podría producir un widget HTML personalizado en un manual web, sintaxis Markdown bruta en una exportación Markdown y un texto legible como alternativa en la documentación basada en informes.

Al permitir la reutilización de la personalización específica de cada formato a través de la Biblioteca, HelpNDoc 10.7 ayuda a los usuarios avanzados a evitar el posprocesamiento, reducir el contenido duplicado y mantener los proyectos más limpios al trabajar con múltiples formatos de documentación a partir de una única fuente.

📚 Compatibilidad con fragmentos externos: Comparte contenido enriquecido entre proyectos

Ahora es posible cargar fragmentos a partir de archivos externos durante la generación, por lo que es más fácil compartir y mantener contenido de texto enriquecido reutilizable entre múltiples proyectos.

Los ítems de biblioteca de fragmento son una manera muy útil de reutilizar contenido enriquecido en proyectos HelpNDoc. Pueden contener texto y párrafos con estilos, hipervínculos, imágenes, tablas y otros contenidos enriquecidos de temas. Hasta este momento, los fragmentos se almacenaban exclusivamente dentro del archivo de proyecto HelpNDoc, lo que los hacía prácticos al trabajar con un solo proyecto pero más difíciles de compartir entre múltiples proyectos.

HelpNDoc 10.7 admite archivos de fragmentos externos. Ahora es posible editar los fragmentos y cargarlos desde un disco, por lo que pueden estar ubicados fuera del proyecto. Al generar documentación, HelpNDoc carga a demanda el contenido de fragmento externo, utilizando el contenido actual del archivo en el momento de generar la documentación.

Esto simplifica enormemente la reutilización de contenido de texto enriquecido entre múltiples proyectos. Ahora, los equipos pueden mantener elementos compartidos como advertencias, avisos legales, instrucciones de soporte, descripciones de productos, procedimientos, renuncias de responsabilidad o bloques de documentación reutilizables en archivos externos y hacer referencia a ellos desde varios proyectos de HelpNDoc. Al actualizar el archivo compartido, cada proyecto que lo utilice puede disponer de la última versión la próxima vez que se genere la documentación.

🖼️ Mejoras en los editores de imágenes, temas y ecuaciones

HelpNDoc 10.7 optimiza diversos flujos de trabajo de edición cotidianos, mejorando el comportamiento de pegado de imágenes, la fiabilidad de las operaciones de copiado de Markdown y la velocidad de la edición de ecuaciones.

El editor de imágenes integrado de HelpNDoc facilita el enriquecimiento de imágenes con anotaciones visuales como sellos, texto, líneas, formas y otros elementos. En HelpNDoc 10.7, pegar una imagen con la capa de fondo seleccionada ahora es más flexible, permitiéndote elegir si deseas sustituir la imagen de fondo o crear una nueva capa de imagens.

Esto hace el uso del editor de imágenes más fácil y versátil. Sustituir el fondo es perfecto al actualizar la captura de pantalla o ilustración de origen, mientras que crear una nueva capa es la mejor opción al añadir una imagen pegada como elemento de composición o superpuesto. HelpNDoc te permite elegir el comportamiento adecuado en el momento de pegar el elemento, lo que reduce los errores y aumenta la predictibilidad de la edición de imágenes. Esta versión también elimina un error que distorsionaba una imagen al pegarla como capa de fondo: ahora, la capa se redimensiona correctamente para adaptarse a la imagen recién pegada.

Adicionalmente, hemos introducido una importante mejora en el flujo de trabajo de Markdown: al copiar como Markdown contenido seleccionado de un tema, las imágenes incrustadas ahora se incluyen como datos codificados en Base64 en línea. Esto significa que, al pegar el contenido en un editor Markdown de terceros o en un visor, rastreador de problemas, herramienta de toma de notas o plataforma de documentación, las imágenes seguirán estando disponibles junto con el texto, en vez de perderse.

Esto produce un flujo de trabajo mucho más fiable al extraer contenido de HelpNDoc como Markdown, lo que resulta especialmente útil para revisiones, colaboraciones, borradores editoriales rápidos, respuestas de soporte, documentación para desarrolladores o cualquier situación en la que es necesario que el Markdown copiado se mantenga autocontenido, sin requerir archivos de imagen adicionales por separado.

El editor de ecuaciones también ha recibido mejoras: hemos reducido considerablemente el tiempo de carga, especialmente al abrirlo por primera vez al abrir la aplicación, por lo que ahora editar ecuaciones es más rápido y dinámico. Además, la experiencia de edición de ecuaciones ahora es más fluida gracias al aumento de fiabilidad de la introducción de contenido con el teclado virtual, la navegación mejorada del cursor y la mayor precisión de formato para las expresiones acentuadas, delimitadores y operaciones de relación.

Finalmente, hemos realizado varias mejoras de fiabilidad. Las ecuaciones editadas de gran tamaño ahora se muestran correctamente en el editor de temas sin recortes no deseados ni barras de desplazamiento horizontales, y hemos eliminado el riesgo de que HelpNDoc mostrase la ecuación predeterminada E=mc2 en vez de la ecuación que se está editando. En conjunto, estos refinamientos hacen la creación de contenido matemático y científico más rápida, clara y fiable.

🛠️ Otras nuevas funciones, arreglos de bugs y mejoras

HelpNDoc 10.7 también incluye arreglos adicionales centrados en limpiar la generación, hacer más fiables las operaciones de copiado y mejorar el comportamiento de los editores.

La generación de contenido condicional se ha mejorado para que las líneas de marcador IF, ELSE y END independientes ahora se eliminan limpiamente sin dejar líneas en blanco adicionales. Esto produce una documentación generada más limpia y reduce la necesidad de realizar ajustes manuales de formato al utilizar gran cantidad de contenido condicional.

Esta versión también arregla un error de “Acceso denegado” que podía producirse al copiar contenido del Editor de temas que incluyese imágenes. Copiar contenido enriquecido desde HelpNDoc ahora es más fiable, sobre todo al trabajar con temas con muchas imágenes o al mover contenido entre HelpNDoc y aplicaciones externas.

Como siempre, la lista completa de cambios está disponible en las notas detalladas de versión a continuación.

🚀 Descarga HelpNDoc 10.7 hoy

HelpNDoc 10.7 está disponible de manera gratuita para uso personal y de evaluación. Descárgalo ahora y comprueba personalmente todas estas mejoras.

Ya sea auditando complejas reglas de publicación con la nueva Matriz de generación, personalizando producciones multiformato con ítems de biblioteca de código bruto, compartiendo contenido enriquecido reutilizable mediante fragmentos externos o aprovechando los flujos de trabajo más fluidos de edición y generación, HelpNDoc 10.7 ofrece mejoras prácticas para los escritores técnicos trabajando en proyectos de todos los tamaños.

👉 Descarga HelpNDoc 10.7 hoy y descubre cómo pueden estas mejoras hacer tu flujo de trabajo más claro, rápido y fiable.