Aspose.Words CHM-Datei-Prozessor für .NET

Aspose.Wörter CHM File Processor für .NET ermöglicht es Entwicklern, die CHM-Dateien (Compiled HTML Help) direkt innerhalb der .Net-Anwendungen zu erstellen, zu laden, bearbeiten und zu verwalten. Mit einem reichen Objektmodell für die Handhabung von Hilfsmitteln, Inhaltstabels, Indizes und eingebetteten Ressourcen ist dieser Plugin unerlässlich für ChM Workflows. Da Aspose.Words nicht natürlich auf CHm speichert, wird der Prozessor zusammen mit dem Converter-Plugin und Format-spezifischen Plugs (z. B. PDF, DOCX, HTML) für den Export verwendet.

Installation und Setup

  • Installieren Sie das NuGet-Paket Aspose.Words CHM File Processor in Ihrem Projekt.
  • Bewerben Sie die Anwendung auf dem Startup ( Metralisierter Lizenzführer ).).
  • Für die vollständige Erstellung und Ausfuhr von CHM beziehen Sie sich sowohl auf dieses Plugin als auch auf das Converter-Plugin Installationsguide .

unterstützte Plattformen:

  • OS: Windows, Linux und macOS
  • Frameworks: .NET Framework (2.0 bis 4.8), .NET Standard, .net Core (2.0 bis 3.1) und Mono 5/6
  • IDEs: Visual Studio (2010–2022), Xamarin, MonoDevelop

Schnelle Start: Laden und Lesen von CHM-Dateien 

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️ Der CHM-Dateiprozessor unterstützt Lesen und Bearbeiten des ChM , während Einsparungen mit Converter und Export-Plugins kombiniert werden müssen.

Eigenschaften und Funktionen

1. Laden und Parsing CHM-Dateien

  • Lesen Sie CHM-Archive aus Streams oder Diskwege.
  • Access hilft Themen wie HTML-Fragmente mit eingebetteten Stilen und Skripten.
  • Ressourcen (Bilder, CSS, JS) für Wiederverwendung zu extrahieren.
  • Speichern Sie eine Tabelle von Inhalten, Index und Metadaten.

2. Schaffung von CHM-Projekten

  • Beginnen Sie eine schwarze CHM mit Metadaten (Titel, Standard-Theme).
  • Konfigurieren Sie Ausgangseigenschaften: Fenstergröße, Sprache, Standardhilfefenster.
  • Initialisieren Sie Sammlungen für Themen, Ressourcen und Index-Einträge.

Thema & HTML Content Management

  • Add, reorder, or remove themes programmatisch.
  • HTML mit benutzerdefinierten Stilen, Skripten oder DOM-Manipulation eingeben/bearbeiten.
  • Vollständige Kodungsunterstützung (UTF-8, UTF-16, Code-Seiten).

Tabelle der Inhalte (TOC) Autorisierung

  • Erstellen Sie hierarchische TOC-Einträge, die auf Themen gezeichnet sind.
  • Managen Sie Captions, Nesting und Sichtbarkeit.
  • Halten Sie TOC synchronisiert mit Topic-Kollektion.

5. Indexmanagement

  • Erstellen Sie Index-Einträge, die mit Themen oder Anker verbunden sind.
  • Definieren Sie primäre / sekundäre Schlüsselwörter und Sortierungsordnungen.
  • Einfuhr/Exportindexdefinitionen für Teamarbeitströme.

6. Ressourcenbehandlung

  • Inbegriffen CSS, Bilder, JavaScript und benutzerdefinierte Binäre.
  • Verwalten Sie Ressourcenreferenzen innerhalb von HTML.
  • Ersatz oder Ausbau von Ressourcen ohne vollständige Rekonstruktion.

Hyperlinks & Buchmarken

  • Geben Sie interne / externe Links zu Themen, Anchoren oder URLs ein.
  • Verwaltung von Buchmarken für detaillierte Navigation.
  • Gewährleistet cross-topic linking konsistenz.

8. Hilfe für die Anpassung von Fenstern

  • Konfigurieren Sie das Hilfsfenster (Size, Toolbar, Menü).
  • Set home topic, default navigation tab, fonts und farbigen schemes.
  • Personalisieren Sie die Navigationspane und die Toolbar-Ikonen.

Integration mit Converter Plugin

  • Pass in-memory CHM-Projekte auf Aspose.Words Document Converter für die Verpackung.
  • Exportieren Sie CHM-Inhalte in DOCX, PDF, EPUB, HTML und mehr.
  • Aktivieren Sie hybride Workflows wie CHM ➝ DOCX ➝ Das ist PDF.

Beste Praktiken

  • Verfügen Sie Ressourcen schnell, um Dateien zu verhindern.
  • Verwenden Sie in-Memory Streams in CI/CD für Effizienz.
  • Batch-Updates vor Sparen, um die Leistung zu verbessern.
  • Halten Sie HTML-Inhalte leichte für kleinere CHM-Größe.
  • Mehrsprachige Inhalte unter den Zuschauern testen.
  • Verwenden Sie konsequent Name für Themen / Buchmarken.
  • Logfehler für die Diagnose von verformten CHM-Archiven.
  • Teilen Sie sehr große CHM-Projekte, um die Speicheranwendung zu optimieren.

Herausforderungen Ansprechen

Low Loading von großen CHMs✔ Verwenden Sie asynchrone Programmierung in .NET, um Ladezeiten zu verbessern.

Schwierigkeiten bei der Entfernung von Bildern/Tabellen✔ Gebrauch Document.GetChildNodes oder DOM APIs, um Strukturen zu manipulieren.

Häufige Fragen

**Q: Was ist Aspose.Words CHM File Processor für .NET?**Ein Plugin, um CHM-Dateien programmatisch zu importieren, zu erstellen und zu bearbeiten, mit dem Export über Converter-Plugins aktiviert wird.

**Q: Welche Dateiformate kann CHM konvertiert werden?**Mit dem Converter-Plugin kann CHM auf DOCX, PDF, HTML, EPUB und mehr gespeichert werden.

**Q: Unterstützt es automatisierte Workflows?**Ja, CHM File Processor integriert sich mit Aspose.Words und Converter Plugins für automatisierte Pipelines.

**Q: Kann ich CHM-Indizes und TOC verwalten?**Ja, es bietet APIs für die Erstellung und Bearbeitung hierarchischer TOC und Index-Einträge.

**Q: Was sind die Vorteile dieses Plugins?**Es verbessert CHM-Editing, reduziert die Abhängigkeit von manuellen Tools und integriert mit bestehenden .NET-Workflows.

 Deutsch