Determining the Output Type

DotNet Help is a Help output format developed by MadCap Software for Windows desktop applications. It was designed to include the best attributes of HTML Help and WebHelp, while filling the holes left behind by those formats. DotNet Help is designed specifically to support Visual Studio 2005 developers. It includes a freely redistributable viewer (MadCap Help Viewer), as well as components for the Visual Studio 2005 developer. These components can be dropped into your Flare project to facilitate context-sensitive Help, embedded Help, and features such as automated search string communication between the application and the DotNet Help documentation. 

The DotNet Help output consists of a collection of files that you will distribute to users with the freely downloadable MadCap Help Viewer. The main entry file has an .mchelp extension.

DotNet Help is a good choice if:

• You need a format that supports .NET applications.
• You want to produce a customizable interface that is much more modern looking than the aging HTML Help. It will blend easily into a modern Vista environment.
• You want users to be able to select between multiple languages for the interface when viewing your output. This is possible because the freely distributable MadCap Help Viewer lets users select English, French, German, or Japanese for the interface.
• You do not want users to be burdened by the security warnings and limitations that are often encountered with HTML Help and WebHelp.
• You need to include features that are not available with HTML Help.
• You want to create embedded context-sensitive Help in a .NET application. This includes the ability to produce Dynamic Help.
• You want to include search functionality that supports wildcard searches.

Flare's online Help uses DotNet Help.

HTML Help is an HTML-based Help format that runs on Windows 32-bit platforms and requires Internet Explorer on the end users' systems. Use HTML Help to create Help for Windows desktop applications. 

The HTML Help output consists of a single CHM file that you will distribute to users.

HTML Help is a good choice if:

• You are writing Help for a 32-bit Windows application.
• Your users will have Internet Explorer on their system.
• Your users don't have a network connection.
• You want to create output that has just one file.

Note: Your users need Internet Explorer (4.0 or later) installed and a 32-bit Windows operating system (Windows 95 or later).

WebHelp is a Web-based Help format that can run on almost any browser or platform. Use WebHelp to create online documentation for the Internet or an intranet, as well as for desktop applications. 

The WebHelp output consists of a collection of files that you will distribute to users. The output will be displayed in the user's Internet browser window. The main entry file has an .htm extension.

WebHelp is a good choice if:

• You are writing online documentation for distribution on the Internet or an intranet.
• You want to be able to produce an output interface in various languages. This is possible through the use of language skins.
• You want the flexibility to include the online documentation in a desktop application.
• Your users have different Internet browsers on their systems.
• Your users are working on different platforms.

WebHelp Plus is a Web-based Help format that is identical to the regular WebHelp output in most ways. However, WebHelp Plus is designed to work on a Web server running Windows XP or Windows Server 2003, as well as Microsoft Internet Information Services (IIS), ASP.NET, and Microsoft Indexing Service. The benefit of publishing WebHelp Plus output is that you and your users can take advantage of some advanced features, including searching of non-XHTML content, faster server-side search, and automatic runtime merging. See About Advanced Server Features in WebHelp Plus. 

The WebHelp Plus output consists of a collection of files that you will distribute to users by publishing output to a Microsoft IIS Web server. The output will be displayed in the user's Internet browser window. The main entry file has an .htm extension.

WebHelp Plus is a good choice if:

• You want all of the features and benefits available with WebHelp.
• You want users to experience faster searches in your output.
• You want non-XHTML files (e.g., PDFs, Excel spreadsheets) to be included in searches that users perform in your output (even if those non-XHTML files are not part of your project).
• You want to automatically merge the output for multiple Flare projects so that they appear as one large Help system to end users.
• You publish your output to a machine running Windows XP or Windows Server 2003.

WebHelp AIR is a Web-based Help format that is identical to the regular WebHelp output in most ways. However, WebHelp AIR uses direct integration with Adobe AIR, which is designed to bring Web-related content to a desktop environment by taking Web files and incorporating them into a single file to be opened locally, rather than from a server.  

The WebHelp AIR output that you generate consists of a single file with an .air extension, which you distribute to users. When users access this file, they are taken through an installation process, and as a result an executable file with an .exe extension is created on their local drive and saved in their C:\Program Files directory. In other words, the output becomes its own application. The output will be displayed in the application window that is part of the AIR installation.

WebHelp AIR is a good choice if:

• You want all of the features and benefits available with WebHelp.
• You want to be able to distribute a single file, as opposed to multiple output files.
• You want users to store and open the output locally, rather than from a server, such as a website.
• You want to create output that has just one file.

In order for you and your end users to take advantage of this output, both you and they must perform additional installations.

• Java Runtime Environment installation (you) As the individual compiling the output, you need to install the Java Runtime Environment (JRE) before generating output. You can download the JRE from http://java.sun.com/javase/downloads/index.jsp.
• Adobe AIR installation (you and end users) Anyone who wants to view the generated WebHelp AIR output needs to install Adobe AIR first. This means that both you and your end users must run this installation. You can download Adobe AIR from http://get.adobe.com/air/.

Short for "Portable Document Format," PDF is an open file format created by Adobe. PDF files represent two-dimensional documents in a device-independent and resolution-independent fixed-layout document format.

You can generate PDF output from your project directly, or you can generate a PDF while simultaneously building FrameMaker or Word output.

The output appears as one long book, even if the project consists of hundreds of topics. After you generate the output directly (without going through another application, such as Word), you can view and print the output.

PDF is a good choice if:

• You want to use a format with which most end users are familiar.
• You want users to be able to view the book online, as well as print it.

PDF output consists of a collection of files that you can print or distribute to users. This includes:

• A file with a .pdf extension. This is the file that contains the consolidated topic content from your project. This is the main file and the only one that is essential. This is the file that you would provide to a printer or distribute to end users.
• A file with an .mcbook extension. This is the main file that allows you to view the document with additional navigation in MadCap's built-in Book Viewer. It is necessary only for viewing the document in the MadCap Book Viewer. Otherwise, you do not need this file.
• A file with an .fltoc extension. This is the file that is generated if you have incorporated a table of contents into the book. It is necessary only for viewing the document in the MadCap Book Viewer. Otherwise, you do not need this file.
• A Resources folder with various ancillary files, such as style sheets and images. They are necessary only for viewing the document in the MadCap Book Viewer. Otherwise, you do not need these files.

XHTML is a browser-based output type that consolidates project content in an XML file. It can be viewed online or printed. The output appears as one long book, even if the project consists of hundreds of topics. You can view the XHTML output in MadCap's Book Viewer and print the output from there.

XHTML consists of a collection of XHTML files that you can print or distribute to users. This includes:

• A file with an .htm extension. This is the XHTML file that contains the consolidated topic content from your project.
• A file with an .mcbook extension. This file is used to display the chapters in the MadCap Book Viewer.
• A file with an .fltoc extension. This is the file that is generated if you have incorporated a table of contents into the book.
• A Resources folder with various ancillary files, such as style sheets and images.

If you want to make XHTML output accessible for others, you need to include all of the files in the output mentioned in this list. Otherwise, when they view the output, certain elements (e.g., images) might be missing from the pages.

Microsoft's XML Paper Specification (XPS) is a document format with a markup language that is a subset of XAML for Windows Presentation Foundation. XPS is an alternative to Adobe's Portable Document Format (PDF). You can generate XPS output from your project directly (as long as you have Microsoft .NET Framework 3.0 installed on your computer, which is a free download from microsoft.com).

Alternatively, you can generate XPS output while simultaneously building Word 2007 output (by installing a free add-in download from Microsoft).

The output appears as one long book, even if the project consists of hundreds of topics. After you generate the output directly (without going through another application, such as Word), you can view and print the output.

XPS is a good choice if:

• You want to create output in a smaller file size than you would get from Adobe PDF.
• You want users to be able to view the book online, as well as print it.
• You want to take advantage of the benefits provided by XPS, such as better print quality, easy file sharing, and enhanced security.

XPS output consists of a collection of XPS files that you can print or distribute to users. This includes:

• A file with an .xps extension. This is the file that contains the consolidated topic content from your project. This is the main file and the only one that is essential. This is the file that you would provide to a printer or distribute to end users.
• A file with an .mcbook extension. This is the main file that allows you to view the document with additional navigation in MadCap's built-in Book Viewer. It is necessary only for viewing the document in the MadCap Book Viewer. Otherwise, you do not need this file.
• A file with an .fltoc extension. This is the file that is generated if you have incorporated a table of contents into the book. It is necessary only for viewing the document in the MadCap Book Viewer. Otherwise, you do not need this file.
• A Resources folder with various ancillary files, such as style sheets and images. They are necessary only for viewing the document in the MadCap Book Viewer. Otherwise, you do not need these files.

If you want users to download an XPS document from a server (e.g., from a website), you need to enable the server to do this by registering the MIME types and file extensions. See Registering MIME Types and File Extensions for XPS Output.

Word is an output type where the generated project is exported to Microsoft Word in one of the following formats: XML (default), DOC, DOCX, XPS, PDF. However, you can also create PDF or XPS output directly, without going through Word.

Note: Unless you specify otherwise, the Word target will create files with an .xml extension only. If you want to use one of the other formats, see Specifying DOCX Output Via Microsoft Word, Specifying XPS Output Via Microsoft Word, and Specifying PDF Output Via Word or FrameMaker.

Note: Flare supports Microsoft Word 2003 and newer versions.

Note: To create output in DOCX or XPS format, you need to have Microsoft Word 2007 installed. Also, Word 2007 allows you to create PDF files from Word without needing to have the Adobe Distiller installed.

FrameMaker is an output type where the generated project is exported to Adobe FrameMaker in one of the following formats: BOOK, FM, PDF. However, you can also create PDF output directly, without going through FrameMaker.

Note: Unless you specify otherwise, the FrameMaker target will create BOOK or FM files only. If you want to create a PDF file from your Flare project, see Specifying PDF Output Via Word or FrameMaker.

Note: Flare supports FrameMaker 7.0 and newer versions.