Major Changes
What has changed, what's new, where can I find it?
What used to be referred to as "compiling" is now known generically as "publishing". This is more accurate because not all output formats are really run through compilers. We still sometimes talk about compiling when referring specifically to the Microsoft help compilers. "Browser-based Help" is now known as "Webhelp", which has established itself as the standard term for help viewed in a normal web browser. The old term was always a bit of a mouthful and it was annoying to have to write the entire term whenever we wanted to discuss it. |
If you have the Professional version you can now save in two different formats: A single-file compressed format with the extension .hmxz and an uncompressed XML format that saves your project in a directory of uncompressed XML files with a project file with the extension .hmxp. The Standard version of Help & Manual can only read and write the single-file compressed format. Uncompressed XML is required for multi-user editing. |
The ePub eBook format is an open, universal eBook standard that is rapidly being adopted all over the world. It is supported by many software readers on all computer platforms and a growing number of hardware devices, including the Sony Reader and the Apple iPhone and iPod Touch. Please check the eBook sections in Configuring Your Output and Help Formats before getting started with ePub eBooks. You will also need to install the free |
You can load and edit multiple projects in the new Project Explorer, which supports Copy & Paste and Drag & Drop between projects. You can also display split views of projects or parts of projects with Explore > Split Explorer in Project > Manage Topics. If you have the Professional version multiple users can work on the same project at the same time. All users must be using the Professional version and the project must be saved in the uncompressed XML (HMXP) format. |
Table styles are available in Write > Styles > Edit Styles. To apply them to a table click in the table and then select Properties in the Table tab. Table styles are dynamic, just like text styles – updating the style automatically updates all the tables formatted with the styles. |
Embedded topics are now called snippets and are much more powerful. In addition to topics in the current project you can also insert snippets from external XML files and topics in other projects (provided they are saved in uncompressed XML). You can save both selected text and entire topics to snippet files to create libraries of reusable content. See Re-using content with snippets for more information and instructions. |
When you are working with modular projects you now set the merge method (runtime or compile-time) separately for each child module. This means that you can mix runtime and compile-time (now referred to as "publish-time") merging. In addition to this, child modules inserted in publish-time mode can be edited directly inside the master project. However, this also means that child modules inserted in runtime mode are only exported to CHM and HLP because only these formats support runtime merging. If you want to export the same modules to other formats you must now insert them a second time and apply suitable build conditions to ensure that they are not exported when you publish to CHM or HLP. See Exporting runtime modules to other formats in Merge methods for CHM & HLP for details on how to do this. |
Help windows are now only relevant for HTML Help (CHM) and Winhelp (HLP). They no longer define background colors for any format except the obsolete Winhelp. Background colors for all other formats are defined in the HTML Page Templates (these colors are also displayed in the editor). It is no longer possible or necessary to associate a help window definition with individual topics. Help window definitions are now only used for defining the appearance and behavior of the HTML Help and Winhelp help viewers and for displaying topics in external windows with hyperlinks. To configure the help viewers you just need to edit the definition of the Main help window in Configuration > Common Properties > Help Windows. Displaying topics in external windows is now achieved exclusively with hyperlinks. You define an additional help window type and then select the help window type in the Insert Hyperlink dialog when you create the hyperlink. It is no longer possible to define a topic that automatically opens in an external window when it is selected in the TOC (this never made sense anyway). |
Displaying topics in external windows is now achieved exclusively with hyperlinks. You define an additional help window type and then select the help window type in the Insert Hyperlink dialog when you create the hyperlink. It is no longer possible to define a topic that automatically opens in an external window when it is selected in the TOC (this never made sense anyway). |
HTML page templates are now defined separately in the Project Explorer, in Configuration > HTML Page Templates. They can be assigned to topics when you create new topics and in . Background colors for topics and headers are now defined in the HTML page templates and displayed in the Help & Manual editor. The only exception is the obsolete Winhelp format – the background colors for Winhelp are still set in the help window definition in Configuration > Common Properties > Help Windows. |
In the new Project Synchronizer tool you open the updated original project and then select Synchronize in the Project tab to perform the conversion. |
Popup topics are now defined with the Topic Class attribute in or when you are creating the topic file. Popup topics can only be created in the Topic Files section of the Project Explorer. You cannot create a popup topic in the Table of Contents section and you cannot switch the Topic Class to Popup in the Table of Contents section. (The Topic Class attribute is currently only used for popups but it may be used for other new features in later updates.) |
In Help & Manual 4 bookmarks and comments were the same thing. In Help & Manual 5 they are now two separate functions. Bookmarks are set and used with the Bookmark tool in the Project tab. You can only set one bookmark per topic and they always link to the top of the topic. They are also managed and accessed with the Bookmark tool. Bookmarked topics are identified in the TOC by red "pin" icons. Comments are inserted with the |
The print manual designer for PDF templates has been updated with some major new functions:
|