Aspose.Words Procesador de archivos CHM para .NET

Siguiente.Words CHM El procesador de archivos para .NET permite a los desarrolladores crear, cargar, editar y gestionar los ficheros de CHM (Compiled HTML Help) directamente dentro de las aplicaciones de .Net. Con un rico modelo de objetos para el manejo de temas de ayuda, tablas de contenidos, índices y recursos incorporados, este plugin es esencial para los flujos de trabajo de ChM. Debido a que Aspose.Words no se salva nativamente a Chm, el processador se utiliza junto con el plugin de Converter y los plugins específicos de formato (por ejemplo, PDF, DOCX, HTML) para la exportación.

Instalación y configuración

  • Instalar el paquete NuGet Aspose.Words CHM File Processor en su proyecto.
  • Aplicar la licencia de medida en la aplicación startup ( Guía de Licencia Metrada ).).
  • Para la creación y exportación completa de CHM, consulte tanto este plugin como el plugin Converter Guía de instalación .

Las plataformas apoyadas:

  • Windows, Linux y MacOS
  • Frameworks: .NET Framework (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

Inicio rápido: Cargar y leer archivos 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 procesador de archivos de CHM soporta leer y editar el fichero de ChM , mientras que el ahorro requiere la combinación con los plugins de Converter y Exportación.

Características y funciones

Cargar y descargar archivos CHM

  • Leer los archivos de CHM desde los flujos o los caminos de disco.
  • El acceso ayuda a temas como fragmentos HTML con estilos y escritos incorporados.
  • Extracto de recursos (imágenes, CSS, JS) para reutilización.
  • Conserva una tabla de contenidos, índices y metadatos.

Creación de proyectos CHM

  • Inicio de un CHM blanco con metadatos (título, tema estándar).
  • Configura las propiedades de salida: tamaño de la ventana, lenguaje, ventanas de ayuda por defecto.
  • Iniciar colecciones para temas, recursos y entradas de índice.

Temas y gestión de contenidos HTML

  • Adicionar, reordenar o eliminar temas de forma programática.
  • Insertar/editar HTML con estilos personalizados, scripts o manipulación DOM.
  • Soporte de codificación completa (UTF-8, UTF-16, páginas de código).

Tabla de Contenidos (TOC) Autorización

  • Construye las entradas TOC hierárquicas mapeadas a los temas.
  • Gestión de capciones, nidificación y visibilidad.
  • Mantenga TOC sincronizado con la colección de temas.

5 - Gestión de índices

  • Crea entradas de índice vinculadas a temas o anchores.
  • Define las palabras clave primarias/secundarias y las órdenes de tipo.
  • Definiciones de índices de importación/exportación para los flujos de trabajo de equipo.

6.Manejo de recursos

  • Incluye CSS, imágenes, JavaScript y binarios personalizados.
  • Gestión de referencias de recursos dentro de HTML.
  • Substituir o extraer recursos sin reconstrucción completa.

Hiperlinks y Bookmarks

  • Insertar enlaces internos/exteriores a temas, anchores o URLs.
  • Gestión de marcadores para la navegación detallada.
  • Asegurar la coherencia de la conexión cross-topic.

Ayuda a la adaptación de ventanas

  • Configure la ventana de ayuda (tamaño, barra de herramientas, menú).
  • Configure el tema principal, la tabla de navegación por defecto, las fuentes y los esquemas de colores.
  • Personalizar los paneles de navegación y las iconas de la barra de herramientas.

Integración con Converter Plugin

  • Pasar los proyectos de CHM en memoria a Aspose.Words Document Converter para el embalaje.
  • Exporta contenido CHM a DOCX, PDF, EPUB, HTML, y más.
  • Permite flujos de trabajo híbridos como CHM ➝ DOCX ➝ Es el PDF.

Mejores Prácticas

  • Disponer recursos rápidamente para evitar bloqueos de archivos.
  • Utilice flujos en memoria en CI/CD para la eficiencia.
  • Batch actualizaciones antes de ahorrar para mejorar el rendimiento.
  • Mantenga el contenido HTML suave para los tamaños CHM más pequeños.
  • Testar el contenido múltiples entre los espectadores.
  • Utilice nombres consistentes para temas/libros.
  • Errores de registro para diagnosticar archivos de CHM malformados.
  • Compartir proyectos de CHM muy grandes para optimizar el uso de la memoria.

Abordar Desafíos Comunes

Las bajas cargas de grandes CHM✔ Utilice la programación asíncrona en .NET para mejorar los tiempos de carga.

Dificultad de extraer imágenes / tablas✔ Uso Document.GetChildNodes o DOM APIs para manipular estructuras.

Preguntas frecuentes

**Q: ¿Qué es el procesador de archivos Aspose.Words CHM para .NET?**Un plugin para importar, crear y editar los archivos CHM de forma programática, con la exportación activada a través de los plugins de Converter.

**Q: ¿Qué formatos de archivo se pueden convertir en CHM?**Con el plugin Converter, CHM se puede salvar a DOCX, PDF, HTML, EPUB, y más.

**Q: ¿Suporta los flujos de trabajo de automatización?**Sí, el procesador de archivos de CHM se integra con los plugins Aspose.Words y Converter para los tubos automatizados.

**Q: ¿Puedo gestionar los índices CHM y TOC?**Sí, proporciona APIs para la construcción y edición de las entradas de TOC y índice jerárquicos.

**Q: ¿Cuáles son los beneficios de este plugin?**Se simplifica la edición de CHM, reduce la dependencia de las herramientas manuales y se integra con los flujos de trabajo .NET existentes.

 Español