Publishing Formats

<< Click to Display Table of Contents >>

Navigation:  Reference >

Publishing Formats

This section provides an overview of the features, characteristics, advantages and disadvantages of the output formats currently supported by Help+Manual. There is no such thing as the "best" format. Each format serves its purpose, and each can be a good choice for some tasks and a less good choice for others.

The supported formats:

HTML Help:

This is currently the most popular electronic help format for Windows applications. It packs your entire help project into a single CHM file. Fast, compact, excellent navigation and usability, universally compatible and full interaction with applications. Displayed by the HTML Help Viewer, that has been included with Windows since Windows 98.

WebHelp:

Displays in normal web browsers on all platforms (Windows, Linux, Mac OS X, Unix). An emulation of the HTML Help interface, designed for use on the Web and intranets. Complete with a dynamic Table of Contents pane, keyword index and full-text search. Consists of a directory containing a large number of HTML files, graphics files and the files needed to display the Table of Contents etc.

Windows EWriter eBooks:

This proprietary Help+Manual format packs your entire project into a single executable file with an integrated viewer program that can be displayed on any Windows computer, from Windows 95 and above without any additional software. This format also provides an emulation of the familiar HTML Help Viewer layout so that all users will be able to use it intuitively without additional explanation.

Apple iBooks®/ePUB eBooks:

ePUB eBooks are an open format that is rapidly becoming a universal standard. In addition to displaying on Apple iOS devices (iPad, iPhone, iPod Touch), they are supported by many other hardware and software readers on many platforms.

Adobe PDF:

Your project can also be output as a fully-formatted and full-featured PDF file that can be displayed on any computer with a PDF reader. Ideal for providing manuals that users can print themselves, either on CDs or for download.

Printed manuals:

The Print Manual feature (in the File menu) generates a temporary PDF file in the background and outputs it to your printer. Also supports booklet format (multiple pages per sheet) and duplex printing.

MS Word RTF:

Old print-style format, support is provided for backward compatibility. Outputs your project to an MS Word Rich Text Format RTF file. Many dynamic help features are not supported, minimum options.

Visual Studio Help 2008 and 2010:

These specialized formats are also known as MS Help 2.0 and MS Help 3.0. They are provided for programmers who need them to document programming components in Visual Studio .NET. They are not documented extensively in the help because Microsoft has not released them for general use under Windows. Both formats are irrelevant for normal application documentation.

For details see Visual Studio Help in the More Advanced Procedures section and the documentation of the MS Visual Studio .NET package. (If you don't have this package you don't need and cannot use Visual Studio Help.)