Uno de los formatos de archivo de ayuda más importantes producido por la herramienta de creación de documentación de ayuda HelpNDoc es el formato de documentación HTML: las páginas de documentación totalmente funcionales pueden alojarse en cualquier servidor web para un rápido acceso a la documentación a voluntad, lo que simplifica la accesibilidad de los clientes y el trabajo del equipo de soporte. Los agentes de soporte a menudo necesitan compartir URL dependientes de contexto con los clientes para explicar tareas específicas, pero estas direcciones a menudo son demasiado largas o difíciles de recordar y escribir. Afortunadamente, todos los temas creados con HelpNDoc pueden tener un número ilimitado de aliases de URL: veamos cómo podemos definirlos en la interfaz de usuario de HelpNDoc.

Ayuda HTML dependiente de contexto

Cada tema producido con la plantilla predeterminada de HelpNDoc es [dependiente de contexto: tiene una URL única que puede ser compartida para acceder a ese tema específico.

Context sensitive HTML URLs

El generador de documentación HTML de HelpNDoc usa la propiedad de ID de ayuda de cada tema para producir su nombre único de archivo. Como ejemplo, puede accederse a un tema con una ID de ayuda definida como MySampleTopic y alojada en https://example.com a través de la URL https://example.com/MySampleTopic.html.

Además, la [propiedad de contexto de ayuda del tema también puede usarse para acceder al tema directamente. Usando el mismo ejemplo, el nombre de dominio https://example.com, puede accederse a un tema con un número de contexto de 42 a través de la URL https://example.com/context/42.html.

Definir aliases de temas

Algunos temas son más populares que otros y darles un alias fácil de recordar puede acelerar enormemente el soporte y mejorar la experiencia del usuario.

HTML topic aliases

Una vez seleccionado un tema en la tabla de contenidos de HelpNDoc, el panel “Propiedades de tema” puede usarse para definir sus diferentes aliases:

  • Haz clic en el editor de la propiedad Aliases para mostrar el botón “…”
  • Haz clic en el botón “…” para abrir el “Editor de lista”
  • En el “Editor de lista”, haz clic en “Añadir” e introduce un nombre para añadir un nuevo alias para ese tema
  • Añade todos los aliases necesarios y luego haz clic en “OK” para cerrar el “Editor de lista”

Una vez generada la página web de documentación HTML por HelpNDoc, este tema será accesible a través de cualquiera de esos aliases.

Como ejemplo, el tema “FAQ y resolución de problemas” podría tener los aliases siguientes, que dirigirán todos al tema correcto:

  • /faq.html creará el alias https://example.com/faq.html
  • /faq/index.html creará los aliases https://example.com/faq/ y https://example.com/faq/index.html
  • /troubleshooting.html creará el alias https://example.com/troubleshooting.html
  • /troubleshooting/index.html creará los aliases https://example.com/troubleshooting/ y https://example.com/troubleshooting/index.html

Gracias a sus potentes capacidades de generación HTML, HelpNDoc es la herramienta perfecta de creación de archivos de ayuda para producir páginas web de documentación realmente sencilla de entender para los usuarios con funciones avanzadas como URL dependientes de contexto o aliases de tema ilimitados. Descarga ahora tu versión gratuita y pruébala por ti mismo.

Ver también...

Escritor técnico contento usando HelpNDoc [happy] [Featured]
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 →
Convertir archivos antiguos de WinHelp en documentación moderna [converting] [Featured]
Revitaliza tus archivos de ayuda: convierte archivos antiguos WinHelp HLP en documentación moderna con HelpNDoc

En una época en la que la información se consume en una enorme variedad de dispositivos y plataformas, los archivos clásicos WinHelp HLP (que en su momento fueron la documentación de ayuda estándar …

Lee Mas →
HelpNDoc vs WordPress [versus] [Featured]
Dominar la publicación multicanal: Por qué HelpNDoc es mucho mejor que WordPress

En el mundo digital interconectado de hoy en día, el concepto de publicación multicanal se ha hecho más esencial que nunca. Al buscar el público información a través de diversas plataformas y …

Lee Mas →
Cuadro de diálogo Generar documentación de HelpNDoc [generate] [Featured]
Empoderando a los escritores técnicos: saca partido a las funciones de anulación de HelpNDoc para obtener variaciones ilimitadas de tu documentación

En el siempre cambiante paisaje de la escritura técnica, la necesidad de flexibilidad, personalización y eficacia es más importante que nunca. Como escritores técnicos, a veces tenemos entre manos …

Lee Mas →

Categorías: artículos