API para mesclar HTML, MHTML, EPUB e Markdown

Mesclar arquivos HTML, MHTML, EPUB e Markdown em C#

O Aspose.HTML for .NET combina vários arquivos de origem do mesmo tipo em um único documento renderizado. Para HTML, passe objetos HTMLDocument ao HtmlRenderer . Para arquivos MHTML ou MHT, passe fluxos ao MhtmlRenderer ; para publicações EPUB, use o EpubRenderer . Os arquivos Markdown são primeiro convertidos em objetos HTMLDocument com Converter.ConvertMarkdown() e depois processados pelo HtmlRenderer. Em cada fluxo de trabalho, a ordem das fontes determina a ordem do conteúdo, enquanto o dispositivo de saída determina o formato de destino.

Escolher um fluxo de trabalho de mesclagem

Mesclagem de HTML em C# com exemplo interativo

O exemplo deste hub demonstra o fluxo de trabalho para HTML. Adicione arquivos HTML locais ou URLs na ordem necessária e selecione PDF, XPS, DOCX, TIFF ou MHTML. Para saídas baseadas em renderizador, o painel C# atualiza as declarações dos documentos, o dispositivo de saída e a extensão conforme a seleção atual. Execute a mesclagem configurada online para verificar o resultado ou copie o código gerado para um projeto .NET. Consulte o guia de mesclagem de HTML para conhecer o tratamento de recursos e as limitações específicas de HTML.

Escolher um dispositivo de saída

• Use PdfDevice para criar um PDF destinado à distribuição, ao arquivamento ou à impressão.
• Use XpsDevice para gravar as fontes renderizadas em um documento XPS.
• Use DocDevice para criar um documento DOCX que possa ser aberto no Microsoft Word ou em outro editor compatível.
• Use ImageDevice com ImageRenderingOptions para gerar TIFF ou outro formato raster compatível.

Cada dispositivo possui uma classe de opções de renderização para definir o tamanho da página, as margens, a resolução e outras configurações específicas do formato de destino. Consulte Dispositivos de renderização em C# para conhecer os dispositivos e construtores disponíveis.

A ferramenta interativa de mesclagem de HTML também permite criar um arquivo Web MHTML.

Instalar o Aspose.HTML for .NET

Instale o Aspose.HTML for .NET pelo NuGet usando a CLI do .NET:

dotnet add package Aspose.HTML

Você também pode usar a interface do Gerenciador de Pacotes NuGet ou executar Install-Package Aspose.HTML no Console do Gerenciador de Pacotes. Consulte o guia de instalação para configurar a biblioteca ou solicite uma licença temporária para avaliar a API sem limitações.

Perguntas frequentes sobre a API de mesclagem

1. Um único renderizador é compatível com todos os formatos de origem?

Não. Use HtmlRenderer para objetos HTMLDocument, MhtmlRenderer para fluxos MHTML ou MHT e EpubRenderer para fluxos EPUB. O Markdown é primeiro convertido em HTMLDocument com Converter.ConvertMarkdown() e depois processado pelo HtmlRenderer.

2. A mesclagem cria um arquivo editável no formato de origem?

Não. O renderizador envia várias fontes a um dispositivo e cria uma saída PDF, XPS, DOCX ou raster. Ele não reúne árvores DOM de HTML, estruturas MIME de MHTML, pacotes EPUB ou texto Markdown em um novo arquivo de origem.

3. Posso passar diferentes formatos de origem na mesma chamada de renderização?

Não. Um renderizador espera uma única representação de origem, como objetos HTMLDocument ou fluxos de arquivo. Use o fluxo de trabalho correspondente às fontes ou normalize primeiro as entradas em um processo separado.

4. O que determina a ordem do conteúdo no resultado mesclado?

A ordem das fontes passadas a Render() determina a posição delas na saída. Reordene os documentos ou fluxos antes da chamada se o PDF, XPS, DOCX ou TIFF final precisar seguir outra sequência.

5. Posso gravar a saída mesclada em um fluxo?

Sim. Dispositivos de saída como PdfDevice aceitam destinos baseados em fluxo. ICreateStreamProvider permite controlar a criação e a liberação dos fluxos de saída. Mantenha o destino disponível até a renderização terminar.