Converter HPJ para MSHI

Entendendo os formatos de arquivo hpj e mshi

HPJ files são arquivos Help Project utilizados pelo Microsoft Help Workshop. Eles contêm configurações de projeto, referências de arquivos e dados de configuração para compilar arquivos Windows Help (.HLP). Os arquivos HPJ são de texto simples e servem como base para criar documentação de ajuda em aplicações Windows mais antigas.

MSHI files são arquivos Microsoft Help Index, parte do sistema Microsoft Help Viewer utilizado no Visual Studio e outras plataformas modernas de documentação da Microsoft. Os arquivos MSHI são baseados em XML e auxiliam na organização e indexação do conteúdo de ajuda para buscas e navegação eficientes.

Como converter hpj para mshi

A conversão direta de HPJ para MSHI não é suportada nativamente, pois esses formatos pertencem a gerações diferentes dos sistemas de ajuda da Microsoft. No entanto, é possível realizar essa conversão através de um processo em duas etapas:

1. Compilar o arquivo HPJ usando Microsoft Help Workshop para gerar um arquivo HLP.
2. Converter o arquivo HLP para um formato de ajuda moderno (como HTML Help ou MSHC), e então usar o Microsoft Help Content Manager para criar um arquivo de índice MSHI.

Softwares recomendados para conversão

• Microsoft Help Workshop – Compilar arquivos HPJ para HLP: File → Compile
• Help & Manual ou Doc-To-Help – Importar HLP ou HPJ e exportar para HTML Help ou MSHC
• Microsoft Help Content Manager – Criar arquivos MSHI a partir de projetos MSHC: File → New → Index

Processo passo a passo para a conversão

1. Abra seu arquivo HPJ no Microsoft Help Workshop e compile para gerar um arquivo HLP.
2. Importe o arquivo HLP ou HPJ no Help & Manual ou Doc-To-Help.
3. Exporte seu projeto como arquivo MSHC (Microsoft Help Container).
4. Abra o Microsoft Help Content Manager e crie um novo índice MSHI: File → New → Index.
5. Adicione seu arquivo MSHC ao índice e salve o projeto para gerar o arquivo MSHI.

Dicas e considerações

• Revise seu conteúdo de ajuda após cada etapa de conversão para garantir que a formatação e os links sejam preservados.
• Alguma edição manual do XML no arquivo MSHI pode ser necessária para uma indexação otimizada.
• Sempre faça backup dos seus arquivos originais HPJ e HLP antes de iniciar o processo de conversão.