Jump to content

Help authoring tool

From Wikipedia, the free encyclopedia

This is an old revision of this page, as edited by Ósemka (talk | contribs) at 10:39, 17 June 2020 (Added reference to HAT tools definition by ITCQF Syllabus.). The present address (URL) is a permanent link to this revision, which may differ significantly from the current revision.

A Help Authoring Tool or HAT is a software program used by technical writers to create online help systems. A typical HAT allows importing various input formats for content, includes a word processor and a simple graphic design tool, but also integrates with configuration management, content management, training and translation tools. HATs make it possible to publish content from a single source to multiple output formats, including online, mobile, printable, presentation, etc.[1]

Functions

The basic functions of a Help Authoring Tool (HAT) can be divided into the following categories:

File input

HATs obtain their source text either by importing it from a file produced by another program, or by allowing the author to create the text within the tool by using an editor. File formats that can be imported vary from HAT to HAT. Acceptable file formats can include ASCII, HTML, OpenOffice Writer and Microsoft Word, and compiled Help formats such as Microsoft WinHelp and Microsoft Compressed HTML Help.

Help output

The output from a HAT can be either a compiled Help file in a format such as WinHelp (*.HLP) or Microsoft Compiled HTML Help (*.CHM), or noncompiled file formats such as Adobe PDF, XML, HTML or JavaHelp.

Auxiliary functions

Some HATs provide extra functions such as:

Common Help Authoring Tools

Some common HATs include:

Technical writers often use content management systems and version control systems to manage their work.

See also

References