Quick Start Tutorials > Converting old projects

Help & Manual 6 automatically converts old project files from older versions (H&M 3 and H&M 4) when you open them. Alternatively, you can also use the stand-alone converter program to convert old projects manually.

Help & Manual 4 projects are converted 1:1 and do not require any post-processing after conversion. Older Help & Manual 3 projects did not have the styles and other features introduced in the modern versions of the program and may require some reformatting after importing.

Backward compatibility with Help & Manual 5:

The Help & Manual 5 project format is almost identical with the HM6 format and requires no conversion. You can also edit projects saved with Help & Manual 6 in Help & Manual 5. However, some exclusive Help & Manual 6 features will not be supported when editing in version 5. An alert will be displayed informing you of this when you open a HM6 project using such features in version 5.

Help & Manual 5 projects

Just open the project normally. No conversion is required.

Help & Manual 3 and 4 projects

1.Select the File menu and click on Open, then select the format of the project you want to open in the Files of Type: field (or the drop-down menu next to the File Name: field in newer versions of Windows).

2.Select the file you want to convert and click on Open to display the following dialog:

DLG_AutoConvert

3.Select Convert and open to convert the old project.The new project file will be saved in the same directory as the old project you are converting.

This method automatically converts the old project into a single compressed file with the extension .hmxz containing all the project components except the graphics files. If you are using the Basic version of Help & Manual this is the only project format you can use.

Using the external converter:

If you use the external converter you can also convert old projects to the uncompressed XML format (HMXP, Professional and Server versions only) and select additional conversion options for Help & Manual 3 projects.

Follow the instructions above and select Start external converter. For full details see The Project Converter.

If your old HMX or HM3 project contains "invisible topics" (topics without TOC entries) they will be moved to a sub-folder called Topics\Invisible in the Topic Files section in the Project Explorer.

Automatic Converter:

exp_movedinvisibles

When you use the automatic converter a chapter called (Former Invisible Topics) will also be created at the bottom of the converted project's Table of Contents (TOC) section.

These TOC entries are linked to the topic files of the former invisible topics but they will still not be included in your published output because their include options are automatically set to "None".

You can delete the (Former Invisible Topics) chapter by selecting it and pressing DELETE. Before confirming, deselect the option Also delete referred topic files to keep the actual topic files.

dlg_deleteinvisibles

External Converter:

When you use the external converter program you can decide what you want to do with your old invisible topics:

dlg_importinvisibles

Add invisible topics to TOC creates the (Former Invisible Topics) chapter described above. We recommend deselecting this option.

Keep organization structure creates sub-folders in the Topic Files section to match your folder structure in your old project. You can create a maximum of 10 levels but the converter will not create more levels than the original project contained.

When you convert old projects the images they use are left in their original locations. The images are accessed by adding links to the old locations to the Project Search Path in the converted project. If you want to store the images with your new project you must manually copy them to a new folder in your new project folder and then update the Project Search Path of your new project so that it only references the new folder(s) location.

See Managing your graphics for more details on these subjects.