Aspose.Words CHM Elaboratore di file per .NET

Parole e parole di CHM File Processor per .NET consente agli sviluppatori di creare, caricare, modificare e gestire i file CHM (Compiled HTML Help) direttamente all’interno delle applicazioni .Net. Con un ricco modello di oggetto per il trattamento di aiuto argomenti, tabelle di contenuti, indizi, e risorse incorporate, questo plugin è essenziale per i flussi di lavoro ChM. Dal momento che Aspose.Words non salva in modo nativo a Chm, il processore viene utilizzato insieme con il plugin Converter e i plugin specifici per formato (per esempio, PDF, DOCX, HTML) per l’esportazione.

Installazione e Setup

  • Installare il pacchetto NuGet Aspose.Words CHM File Processor nel tuo progetto.
  • L’applicazione di una licenza a base di applicazione startup ( Guida di Licenza Metrata ).
  • Per la creazione e l’esportazione completa di CHM, si riferisce sia a questo plugin che al plugin Converter Guida di installazione .

Piattaforme supportate:

  • Windows, Linux e macOS
  • Frameworks: .NET framework (2.0 – 4.8), .Net Standard, .NET Core ( 2.0 – 3.1), .net 5/6+, Mono
  • IDE: Visual Studio (2010-2022), Xamarin, MonoDevelop

Inizio rapido: Caricare e leggere i file 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️ Il processore di file CHM supporta leggere e modificare il file ChM , mentre il risparmio richiede la coppia con i plug-in di conversione e esportazione.

Caratteristiche e funzionalità

Caricamento e parsaggio dei file CHM

  • Leggi gli archivi CHM dai flussi o dai percorsi di disco.
  • Access aiuta i temi come fragmenti HTML con stili e script incorporati.
  • Estratto di risorse (immagini, CSS, JS) per riutilizzo.
  • Conservare tabella di contenuti, indice e metadati.

Creazione di progetti CHM

  • Inizia un CHM vuoto con i metadati (titolo, argomento predefinito).
  • Configurare le proprietà di uscita: dimensioni finestre, lingua, finestra di assistenza predefinita.
  • Initializza le collezioni per argomenti, risorse e indice.

Gestione dei contenuti e HTML

  • Aggiungere, riprendere o rimuovere i temi in modo programmatico.
  • Inserisci/editi HTML con stili personalizzati, script o manipolazione DOM.
  • Supporto completo per la codifica (UTF-8, UTF-16, pagine di codice).

Tabella dei Contenuti (TOC) Autorizzazione

  • Costruisci le entrate TOC gerarchiche mappate su argomenti.
  • Gestire capzioni, nesting e visibilità.
  • Mantenere TOC sincronizzato con la raccolta di argomenti.

5 - Gestione dell’indice

  • Crea le entrate di indice collegate a temi o anchori.
  • Definire parole chiave primarie/secondarie e ordini di sorta.
  • Definizioni dell’indice di importazione/esportazione per i flussi di lavoro di squadra.

6 La gestione delle risorse

  • Incorporare CSS, immagini, JavaScript e binari personalizzati.
  • Gestire i riferimenti di risorse all’interno di HTML.
  • sostituire o estrarre le risorse senza ricostruzione completa.

Hyperlinks e Bookmarks

  • Inserisci collegamenti interni / esterni a temi, anchori o URL.
  • Gestione dei biglietti per una navigazione dettagliata.
  • Assicurare la coerenza di collegamento cross-topic.

8. aiutare la personalizzazione della finestra

  • Configurare la finestra di aiuto (grande dimensioni, barre di strumenti, menu).
  • Imposta il tema di casa, la scheda di navigazione predefinita, le font e i schemi di colore.
  • Personalizzare il pannello di navigazione e le icone della barra degli strumenti.

Integrazione con Converter Plugin

  • Passare i progetti CHM in-memory a Aspose.Words Document Converter per l’imballaggio.
  • Esporta il contenuto CHM in DOCX, PDF, EPUB, HTML e altro ancora.
  • Possibilità di flussi di lavoro ibridi come CHM ➝ Il DOCX ➝ Questo è PDF.

Migliori pratiche

  • Disporre rapidamente le risorse per evitare blocchi di file.
  • Utilizzare i flussi in-memory in CI/CD per l’efficienza.
  • Batch aggiornamenti prima di risparmiare per migliorare le prestazioni.
  • Mantenere il contenuto HTML sottile per dimensioni CHM più piccole.
  • Testare il contenuto multilingue tra gli spettatori.
  • Utilizzare nomi coerenti per argomenti/bookmarks.
  • errori di registrazione per la diagnosi di archivi CHM malformati.
  • Dividere progetti CHM molto grandi per ottimizzare l’uso della memoria.

Affrontare le Sfide Comuni

Basso carico di grandi CHM✔ Utilizzare la programmazione asincronica in .NET per migliorare i tempi di caricamento.

Difficoltà nell’estrazione di immagini/tabelle✔ Questo utilizzo Document.GetChildNodes o DOM APIs per manipolare le strutture.

Domande frequenti

**Q: Che cosa è Aspose.Words CHM File Processor per .NET?**Un plugin per importare, creare e modificare i file CHM in modo programmatico, con l’esportazione abilitata attraverso i plugin Converter.

**Q: Quali formati di file possono essere convertiti in CHM?**Con il plugin Converter, CHM può essere salvato a DOCX, PDF, HTML, EPUB, e altro ancora.

**Q: supporta i flussi di lavoro di automazione?**Sì, CHM File Processor si integra con Aspose.Words e Converter plug-ins per i tubi automatizzati.

**Q: Posso gestire gli indici CHM e TOC?**Sì, fornisce API per la costruzione e l’editing delle entrate TOC e indice ierarchiche.

**Q: Quali sono i vantaggi di questo plugin?**Rafforza l’editing CHM, riduce la dipendenza da strumenti manuali e si integra con i flussi di lavoro .NET esistenti.

 Italiano