Processador de Arquivo CHM Aspose.Words para .NET

Palavras - Words CHM Processador de arquivos para .NET permite que os desenvolvedores crie, carregue, edite e gerencie ficheiros CHM (Compiled HTML Help) diretamente dentro de aplicações. com um rico modelo de objetos para lidar com temas de ajuda, tabelas de conteúdo, índices e recursos incorporados, este plugin é essencial para fluxos de trabalho de ChM. Uma vez que Aspose.Words não salva nativamente para Chm, o processador é usado juntamente com o plugin Converter e plugins específicos de formato (por exemplo, PDF, DOCX, HTML) para exportação.

Instalação e Setup

  • Instale o pacote NuGet Aspose.Words CHM File Processor em seu projeto.
  • Aplicar a licença métrica no aplicativo startup ( Guia de Licença Metrada ).
  • Para a criação e exportação completa do CHM, consulte este plugin e o plugin Converter Guia de instalação .

As plataformas suportadas:

  • OS: Windows, Linux e MacOS
  • Frameworks: .NET Frames (2.0 a 4.8), .Net Standard, .NET Core ( 2.0 a 3.1), .net 5/6+, Mono
  • IDEs: Visual Studio (2010–2022), Xamarin, MonoDevelop

Início rápido: carregar e ler arquivos CHM 

using Aspose.Words;

// Load CHM file
doc = new Document(MyDir + "HTML help.chm");

// Save to DOCX (requires Converter plugin)
doc.Save(ArtifactsDir + "ProcessorChmPlugin.ReadChm.docx");

i️ O processador de arquivos da CHM suporta reading e editing da ChM , enquanto a poupança requer parceria com os plugins do Converter e da Exportação.

Características e Funções

1. carregar e parcelar arquivos CHM

  • Leia os arquivos do CHM a partir de fluxos ou caminhos de disco.
  • Acesso ajuda tópicos como fragmentos HTML com estilos e scripts incorporados.
  • Extrair recursos (imagens, CSS, JS) para reutilização.
  • Preserve uma tabela de conteúdos, índices e metadados.

Criação de Projetos CHM

  • Comece um CHM branco com metadados (título, tópico padrão).
  • Configure as propriedades de saída: tamanho da janela, idioma, janelo de ajuda padrão.
  • Iniciar coleções para tópicos, recursos e entradas de índice.

Tópico e Gestão de Conteúdo HTML

  • Adicionar, reordenar ou remover tópicos de forma programática.
  • Insira/edita o HTML com estilos personalizados, scripts ou manipulação DOM.
  • Suporte completo para codificação (UTF-8, UTF-16, páginas de código).

Tabela de Conteúdo (TOC) Autorização

  • Construa entradas TOC hierárquicas mapeadas para tópicos.
  • Gerencie capções, nesting e visibilidade.
  • Mantenha o TOC sincronizado com a coleção de tópicos.

5 – Gestão do Índice

  • Crie entradas de índice ligadas a tópicos ou ancoros.
  • Defina palavras-chave primárias/secundárias e ordens de tipo.
  • Definições de índice de importação/exportação para fluxos de trabalho em equipe.

6 – Gestão de Recursos

  • Inclui CSS, imagens, JavaScript e binários personalizados.
  • Gerenciar referências de recursos dentro do HTML.
  • Substituir ou extrair recursos sem reconstrução completa.

Hiperlinks e Bookmarks

  • Insira links internos / externos para tópicos, ancoros ou URLs.
  • Manutenção de marcadores para navegação detalhada.
  • Assegurar a coerência de ligação cross-topic.

8 – Ajudar a personalização da janela

  • Configure a janela de ajuda (size, barra de ferramentas, menu).
  • Configurar tópico inicial, guia de navegação padrão, letras e esquemas de cores.
  • Personalize o painel de navegação e os ícones da barra de ferramentas.

Integração com o Converter Plugin

  • Passar projetos CHM em memória para Aspose.Words Document Converter para embalagem.
  • Exportar conteúdo CHM para DOCX, PDF, EPUB, HTML e muito mais.
  • Permite fluxos de trabalho híbridos como CHM ➝ O DOCX ➝ É o PDF.

Melhores Práticas

  • Disponha recursos rapidamente para evitar bloqueio de arquivos.
  • Use fluxos ** em memória** em CI/CD para eficiência.
  • Batch atualizações antes de poupar para melhorar o desempenho.
  • Mantenha o conteúdo HTML suave para tamanhos CHM menores.
  • Teste ** Conteúdo multilingüe** entre os espectadores.
  • Use nomes consistentes para tópicos/bookmarks.
  • Erros de registro para o diagnóstico de arquivos CHM malformados.
  • Divida projetos CHM muito grandes para otimizar o uso da memória.

Abordando Desafios Comuns

Carregamento lento de grandes CHMs✔ Use a programação não sincronizada em .NET para melhorar os tempos de carga.

Dificuldade em extrair imagens / tabelas✔ Utilização Document.GetChildNodes ou APIs DOM para manipular estruturas.

Perguntas frequentes

**Q: O que é o processador de arquivos Aspose.Words CHM para .NET?**Um plugin para importar, criar e editar arquivos CHM de forma programática, com exportação ativada através de plugins Converter.

**Q: Quais formatos de arquivo podem ser convertidos em CHM?**Com o plugin Converter, o CHM pode ser salvo para DOCX, PDF, HTML, EPUB e muito mais.

**Q: Ele suporta fluxos de trabalho de automação?**Sim, o processador de arquivos CHM integra com os plugins Aspose.Words e Converter para tubos automatizados.

**Q: Posso gerenciar os índices CHM e TOC?**Sim, ele fornece APIs para a construção e edição de entradas de TOC e índice hierárquicos.

**Q: Quais são os benefícios deste plugin?**Ele simplifica a edição do CHM, reduz a dependência de ferramentas manuais e integra com os fluxos de trabalho .NET existentes.

 Português