Processador de fitxers Aspose.Words CHM per a .NET

Títol: Words CHM El processador de fitxers per a .NET permet als desenvolupadors crear, carregar, editar i gestionar els arxius de CHM (Ajuda HTML compilada) directament dins de les aplicacions de .Net. Amb un model d’objectes rics per tractar temes de suport, taules de continguts, index, i recursos embedded, aquest plugin és essencial per als fluxos de treball de ChM. Com que Aspose.Words no s’emmagatzema de manera nativa a la XM, el procesador es fa servir juntament amb el plugin de convertidors i els plugins específics de format (per exemple, PDF, DOCX, HTML) per exportar.

Instal·lació i configuració

  • Instal·la el paquet NuGet Aspose.Words CHM File Processor en el seu projecte.
  • L’aplicació de l’autorització per a la presentació d’accions ( Guia de llicència ).
  • Per a la creació i l’exportació completa de CHM, feu referència tant a aquest plugin com al plugin Converter Guia d’instal·lació .

Les plataformes de suport:

  • Operació: Windows, Linux i MacOS
  • Frameworks: .NET Frames (2.0–4.8), .NET Standard, .NET Core (2.0–3.1) i Mono 5/6
  • IDEs: Visual Studio (2010–2022), Xamarin, MonoDevelop

Inici ràpid: Carregar i llegir els arxius 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️ El processador de fitxers de CHM dóna suport a la lectura i l’editació de la CSM, mentre que l’estalvi requereix la paralització amb els plugins de Converter i Exportació.

Característiques i funcionalitats

1.Càrrega i parssió de fitxers CHM

  • Llegeix els arxius CHM des de fluxos o pistes de disc.
  • Accés ajuda temes com fragments HTML amb estils i escripts incorporats.
  • Extreure recursos (images, CSS, JS) per a reutilitzar.
  • Conserva la taula de continguts, index i metadades.

Creació de projectes CHM

  • Iniciar un CHM blanc amb metadades (títol, tema estàndard).
  • Configura les propietats de sortida: la mida de la finestra, el llenguatge, les finestres d’ajuda de default.
  • Iniciar les col·leccions per a temes, recursos i entrades d’índex.

Temes i gestió de continguts HTML

  • Afegir, reordenar o eliminar temes programàticament.
  • Introdueix/edita HTML amb estils personalitzats, escripts o manipulació DOM.
  • Suport a la codificació completa (UTF-8, UTF-16, pàgines de codi).

Taula de continguts (TOC

  • Construir les entrades TOC jeràrquics mapades a temes.
  • Gestió de capcions, nesting i visibilitat.
  • Mantenir TOC sincronitzat amb la col·lecció de temes.

Gestió de l’índex

  • Crea entrades indexades vinculades a temes o ancors.
  • Defineix paraules clau primàries/secundàries i ordres de tipus.
  • Definicions de l’índex d’import/exportació per a fluxos de treball en equip.

Gestió de recursos

  • Inclou CSS, imatges, JavaScript i binaris personalitzats.
  • Gestió de referències de recursos dins de HTML.
  • Substituir o extreure recursos sense reconstrucció completa.

Hiperenllaços i Bookmarks

  • Insereix enllaços interns / externs a temes, ancors o URLs.
  • Gestió de marcadors per a navegació detallada.
  • Assegurar la coherència de l’enllaç cross-topic.

Ajuda a la personalització de finestres

  • Configureu la finestra d’ajuda (size, barres de eines, menús).
  • Configura el tema principal, la taula de navegació de default, les fonts i els esquemes de colors.
  • Personalitza el panell de navegació i les icones de barra d’eines.

Integració amb Converter Plugin

  • Passar en memòria els projectes de CHM a Aspose.Words Document Converter per a l’embalatge.
  • Exportar continguts CHM a DOCX, PDF, EPUB, HTML, i més.
  • Permeten fluxos de treball híbrids com CHM ➝ DOCX ➝ És el PDF.

Les millors pràctiques

  • Disposar ràpidament els recursos per evitar bloquejos de fitxers.
  • Utilitza els fluxos ** en memòria** en CI/CD per a l’eficiència.
  • Batx actualitzacions abans d’estalviar per millorar el rendiment.
  • Mantenir el contingut HTML lleu per a dimensions més petites de CHM.
  • Testar el contingut multilingüe entre els espectadors.
  • Utilitza nomenament coherent per a temes/bookmarks.
  • Errors de registre per diagnosticar arxius de CHM malformats.
  • Compartir projectes molt grans de CHM per optimitzar l’ús de la memòria.

Resoldre els reptes comuns

Càrrega baixa de grans CHMs✔ Utilitza la programació asíncrona en .NET per millorar els temps de càrrega.

Dificultat de l’extracció d’imatges / taules✔ Utilització Document.GetChildNodes o DOM APIs per manipular estructures.

Preguntes freqüents

**Q: Què és el processador de fitxers Aspose.Words CHM per a .NET?**Un plug-in per importar, crear i editar els arxius CHM programàticament, amb l’exportació habilitat a través de plugins Converter.

**Q: Quins formats de fitxers es poden convertir en CHM?**Amb el plugin Converter, CHM es pot salvar a DOCX, PDF, HTML, EPUB, i més.

**Q: És compatible amb els fluxos de treball d’automatització?**Sí, el processador de fitxers de CHM s’integra amb els plugins d’Aspose.Words i Converter per a tubs automatitzats.

**Q: Puc gestionar els índexs de CHM i TOC?**Sí, proporciona APIs per a la construcció i l’edició de les entrades de TOC i Índex jeràrquics.

**Q: Quins són els beneficis d’aquest plugin?**Simplifica l’edició de CHM, redueix la dependència de les eines manuals i s’integra amb els fluxos de treball .NET existents.

 Català