One of the most important help file format produced by the HelpNDoc help authoring tool is the HTML documentation format: the fully functional documentation web-sites can be hosted on any web server for quick access to self-service documentation, thus simplifying customer accessibility and the work of the support team. Support agents frequently need to share context-sensitive URLs to customers to explain specific tasks but those are often too long and hard to remember and type. Fortunately, every topics created in HelpNDoc can have an unlimited number of URL aliases: let’s see how they can be defined in HelpNDoc’s user interface.

Context sensitive HTML help

Each topic produced by HelpNDoc’s default template is context sensitive: it has a unique URL which can be shared to access this specific topic.

Context sensitive HTML URLs

HelpNDoc’s HTML documentation generator uses each topic’s help ID property to produce its unique file name. As an example, a topic with a help ID defined as MySampleTopic hosted on the domain can be accessed using the URL.

Furthermore, the topic’s help context property can also be used to access it directly. Using the same sample domain name, a topic with a context number of 42 can be accessed using the URL.

Define topic aliases

Some topics are more popular than others and providing them with an easy to remember alias can greatly speed-up support and enhance the user experience.

HTML topic aliases

Once a topic is selected in HelpNDoc’s table of contents, the “Topic properties” panel can be used to define its different aliases:

  • Click in the Aliases property’s editor to show the “…” button
  • Click the “…” button to open the “List editor”
  • In the “List editor”, click “Add” and enter a name to add a new alias for that topic
  • Add as many aliases as needed then click “OK” to close the “List editor”

Once the HTML documentation web-site is generated by HelpNDoc, this topic will be accessible via any of those aliases.

As an example, the “FAQ and Troubleshooting” topic could have the following aliases, which will all redirect to the correct topic:

  • /faq.html will create the alias
  • /faq/index.html will create the and aliases
  • /troubleshooting.html will create the alias
  • /troubleshooting/index.html will create the and aliases

Thanks to its powerful HTML generation capabilities, HelpNDoc is the perfect help authoring tool to produce truly user friendly documentation web-sites with advanced features such as context sensitive URLs and unlimited topic aliases. Download your free version now to try it for yourself.

See also...

Converting Legacy WinHelp HLP to Modern Documentation [converting] [Featured]
Revitalize Your Help Files: Converting Legacy WinHelp HLP to Modern Documentation with HelpNDoc

In an age where information is consumed on a plethora of devices and platforms, the classic WinHelp HLP files — once the standard in Windows-based help documentation — are now relics of a bygone era. …

Read More →
HelpNDoc vs WordPress [versus] [Featured]
Mastering Multi-Channel Publishing: Why HelpNDoc Leaves WordPress in the Dust

In today’s interconnected digital world, the concept of multi-channel publishing has become more critical than ever. As audiences seek information through various platforms and formats, content …

Read More →
HelpNDoc's Generate documentation dialog [generate] [Featured]
Empowering Technical Writers: Harnessing HelpNDoc's Override Features for Unlimited Documentation Variations

In the ever-evolving landscape of technical writing, the need for flexibility, customization, and efficiency is more crucial than ever before. As technical writers, we often juggle multiple …

Read More →
The Future of Documentation: How Help Authoring Tools are Empowering Technical Writers and Organizations

The documentation landscape is constantly evolving, and HelpNDoc has emerged as a leading help authoring tool that’s changing the way we create, maintain, and share information. With its ability to …

Read More →

Categories: articles