Converter um documento em HTML, MHTML ou EPUB
Documentos nos formatos de layout de fluxo HTML e MHTML também são muito populares e podem ser usados em qualquer plataforma da web. Por esse motivo, a conversão de documentos para HTML e MHTML é uma característica importante de Aspose.Words.
EPUB (abreviação de" publicação eletrônica") é um formato baseado em HTML comumente usado para distribuição de livros eletrônicos. Este formato é totalmente suportado em Aspose.Words para a exportação de livros electrónicos compatíveis com a maioria dos dispositivos de leitura.
Converter um documento
Para uma conversão simples para HTML, MHTML ou EPUB, é utilizada uma das sobrecargas do método Save. Você pode salvar o documento em um arquivo ou fluxo e definir explicitamente o formato de salvamento do documento de saída ou defini-lo a partir da extensão de nome de arquivo.
O exemplo a seguir mostra como converter DOCX para HTML especificando um formato de salvamento:
Para converter um documento em MHTML ou EPUB, use SaveFormat.Mhtml ou SaveFormat.Epub respectivamente.
Converter um documento com informações de ida e volta
O formato HTML não suporta muitos recursos Microsoft Word e, se precisarmos restaurar um modelo de documento o mais próximo possível do original, precisamos salvar algumas informações extras no arquivo HTML. Essas informações são também chamadas de"informações de ida e volta". Para esse fim, Aspose.Words fornece a capacidade de exportar informações de ida e volta ao salvar em HTML, MHTML ou EPUB Usando a propriedade ExportRoundtripInformation. Salvar as informações de ida e volta permite restaurar as propriedades do documento, como guias, comentários, cabeçalhos e rodapés, durante o carregamento de documentos dos formatos listados de volta em um objeto Document.
O valor predefinido é true para HTML e false para MHTML e EPUB:
- Quando true, as informações de ida e volta são exportadas como - aw - * CSS propriedades dos elementos HTML correspondentes
- Quando false, não há informações de ida e volta a serem enviadas para os arquivos produzidos
O exemplo de código a seguir mostra como exportar informações de ida e volta ao converter um documento de DOCX para HTML:
Especifique as opções de salvamento ao converter para HTML
Aspose.Words permite converter um documento do Word para HTML usando opções de salvamento padrão ou personalizadas. Alguns exemplos de opções de salvamento personalizadas são descritos abaixo.
Especifique uma pasta para salvar recursos
Usando Aspose.Words podemos especificar uma pasta física onde todos os recursos, como imagens, fontes e externo CSS, são salvos quando um documento é convertido em HTML. Por padrão, esta é uma string vazia.
Especificar a propriedade ResourceFolder é a maneira mais simples de definir a pasta onde todos os recursos devem ser gravados. Podemos usar propriedades individuais, como FontsFolder que salva fontes na pasta especificada e ImagesFolder que salva imagens em uma pasta especificada. Quando um caminho relativo é especificado, FontsFolder e ImagesFolder referem-se à pasta onde o conjunto de código está localizado, ResourceFolder e CssStyleSheetFileName referem-se à pasta de saída onde o documento HTML está localizado.
Neste exemplo, ResourceFolder especifica o caminho relativo. Este caminho refere-se à pasta de saída onde o documento HTML é guardado. O valor da propriedade ResourceFolderAlias é usado para criar URLs para todos os recursos.
O exemplo de código a seguir mostra como trabalhar com essas propriedades:
Usando a propriedade ResourceFolderAlias, também podemos especificar o nome da pasta usada para construir URIs de todos os recursos gravados em um documento HTML. Esta é a maneira mais simples de especificar como URIs deve ser gerado para todos os arquivos de recursos. As mesmas informações podem ser especificadas para imagens e fontes separadamente através das propriedades ImagesFolderAlias e FontsFolderAlias, respectivamente.
No entanto, não existe propriedade individual para CSS. O comportamento do FontsFolder, FontsFolderAlias, ImagesFolder, ImagesFolderAlias e CssStyleSheetFileName as propriedades não são alteradas. Observe que a propriedade CssStyleSheetFileName é usada para especificar o nome da pasta e o nome do arquivo.
- ResourceFolder tem prioridade mais baixa do que as pastas especificadas via FontsFolder, ImagesFolder e CssStyleSheetFileName. Se a pasta especificada no ResourceFolder não existir, ela será criada automaticamente.
- ResourceFolderAlias tem uma prioridade inferior a FontsFolderAlias e ImagesFolderAlias. Se ResourceFolderAlias estiver vazio, o valor da propriedade ResourceFolder será usado para criar o recurso URIs. Se ResourceFolderAlias estiver definido como “.” (ponto), o recurso URIs conterá apenas nomes de arquivo sem especificar um caminho.
Exportar Fontes De Codificação Base64 Recursos
Aspose.Words fornece a capacidade de especificar se os recursos de fonte devem ser incorporados em HTML em codificações Base64. Para fazer isso, use a propriedade ExportFontsAsBase64 – esta é uma extensão da propriedade ExportFontResources. Por padrão, seu valor é false e as fontes são gravadas em arquivos separados. Mas se esta opção estiver definida como true, as fontes serão incorporadas na codificação CSS do documento em base64. A propriedade ExportFontsAsBase64 afeta apenas o formato HTML e não afeta EPUB e MHTML.
O exemplo de código a seguir mostra como exportar fontes codificadas em base64 para HTML:
Especifique as opções de salvamento ao converter para EPUB
Aspose.Words permite converter um documento do Word para o formato EPUB usando as opções de salvamento padrão ou personalizadas. Você pode especificar várias opções passando uma instância de HtmlSaveOptions para o método Save.
O exemplo de código a seguir mostra como converter um documento do Word em EPUB com a especificação de algumas opções de salvamento personalizadas: