Convert HPJ to MSHC

Understanding HPJ and MSHC file formats

HPJ (Help Project) files are project files used by Microsoft Help Workshop to create compiled help files (CHM). They contain references to help topics, contents, and configuration settings for building Windows help documentation.

MSHC (Microsoft Help Container) files are used for Microsoft Help Viewer, primarily for Visual Studio documentation. MSHC is a modern help format that supports advanced features like search, indexing, and integration with Visual Studio.

Why convert HPJ to MSHC?

Converting HPJ to MSHC is essential for updating legacy help documentation to be compatible with newer Microsoft platforms, especially for integration with Visual Studio and modern Windows applications.

How to convert HPJ to MSHC

There is no direct one-step converter from HPJ to MSHC. The process involves two main steps:

1. Compile the HPJ file to a CHM file using Microsoft HTML Help Workshop.
2. Convert the CHM file to MSHC using Helpware's FAR HTML or MSHCMigrate tool.

Step-by-step conversion process

1. Open your HPJ file in Microsoft HTML Help Workshop.
2. Use File → Compile to generate a CHM file.
3. Download and install FAR HTML from Helpware (helpwaregroup.com).
4. Open FAR HTML and use the Tools → MSHC Converter to import your CHM file.
5. Follow the prompts to export your documentation as an MSHC file.

Recommended software for HPJ to MSHC conversion

• Microsoft HTML Help Workshop – for compiling HPJ to CHM.
• FAR HTML – for converting CHM to MSHC.
• MSHCMigrate – an alternative command-line tool for CHM to MSHC conversion.

Tips for a successful conversion

• Ensure all source files referenced in the HPJ are available and error-free.
• Review the output at each stage to catch formatting or linking issues early.
• Consult the documentation for FAR HTML or MSHCMigrate for advanced options and troubleshooting.