Konwertuj dokument na HTML, MHTML lub EPUB

Dokumenty w formatach układu przepływu HTML i MHTML są również bardzo popularne i mogą być używane na dowolnej platformie internetowej. Z tego powodu Konwersja dokumentów do HTML i MHTML jest ważną cechą Aspose.Words.

EPUB (skrót od “publikacja elektroniczna”) to format oparty na HTML, powszechnie używany do dystrybucji książek elektronicznych. Ten format jest w pełni obsługiwany w Aspose.Words do eksportowania książek elektronicznych, które są kompatybilne z większością urządzeń do czytania.

Konwertuj dokument

Do prostej konwersji na HTML, MHTML lub EPUB używany jest jeden z przeciążeń metody Save. Możesz zapisać dokument do pliku lub strumienia i jawnie ustawić format zapisu dokumentu wyjściowego lub zdefiniować go z rozszerzenia nazwy pliku.

Poniższy przykład pokazuje, jak przekonwertować DOCX na HTML z określeniem formatu zapisu:

For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
// Load the document from disk.
System::SharedPtr<Document> doc = System::MakeObject<Document>(inputDataDir + u"Test File (docx).docx");

// Save the document into HTML.
doc->Save(outputDataDir + u"Document_out.html", SaveFormat::Html);

Aby przekonwertować dokument na MHTML lub EPUB, Użyj odpowiednio SaveFormat.Mhtml LUB SaveFormat.Epub.

Konwertuj dokument z informacjami w obie strony

Format HTML nie obsługuje wielu funkcji Microsoft Word, a jeśli musimy przywrócić model dokumentu jak najbliżej oryginału, musimy zapisać dodatkowe informacje w pliku HTML. Takie informacje są również nazywane “informacjami w obie strony”. W tym celu Aspose.Words zapewnia możliwość eksportowania informacji w obie strony podczas zapisywania do HTML, MHTML lub EPUB przy użyciu właściwości ExportRoundtripInformation. Zapisywanie informacji w obie strony umożliwia przywrócenie właściwości dokumentu, takich jak zakładki, komentarze, nagłówki i stopki podczas ładowania dokumentów wymienionych formatów z powrotem do obiektu Document.

Wartość domyślna to true dla HTML i false dla MHTML i EPUB:

• Gdy true, informacje o podróży w obie strony są eksportowane jako - aw - * CSS właściwości odpowiednich elementów HTML
• Gdy false, nie ma informacji w obie strony, które można by wyprowadzić do utworzonych plików

Poniższy przykład kodu pokazuje, jak wyeksportować informacje w obie strony podczas konwersji dokumentu z DOCX na HTML:

For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
// Load the document from disk.
System::SharedPtr<Document> doc = System::MakeObject<Document>(inputDataDir + u"Test File (doc).doc");

System::SharedPtr<HtmlSaveOptions> options = System::MakeObject<HtmlSaveOptions>();
// HtmlSaveOptions.ExportRoundtripInformation property specifies
// Whether to write the roundtrip information when saving to HTML, MHTML or EPUB.
// Default value is true for HTML and false for MHTML and EPUB.
options->set_ExportRoundtripInformation(true);

doc->Save(outputDataDir + u"ConvertDocumentToHtmlWithRoundtrip.html", options);

Możesz pobrać plik szablonu tego przykładu z Aspose.Words GitHub.

Określ opcje zapisu podczas konwersji na HTML

Aspose.Words umożliwia konwersję dokumentu Word na HTML przy użyciu domyślnych lub niestandardowych opcji zapisywania. Poniżej opisano kilka przykładów niestandardowych opcji zapisywania.

Określ Folder do zapisywania zasobów

Za pomocą Aspose.Words możemy określić folder fizyczny, w którym wszystkie zasoby, takie jak obrazy, czcionki i zewnętrzne CSS, są zapisywane, gdy dokument jest konwertowany na HTML. Domyślnie jest to pusty ciąg.

Określenie właściwości ResourceFolder jest najprostszym sposobem ustawienia folderu, w którym powinny być zapisane wszystkie zasoby. Możemy użyć indywidualnych właściwości, takich jak FontsFolder, który zapisuje czcionki w określonym folderze i ImagesFolder, który zapisuje obrazy w określonym folderze. Po określeniu ścieżki względnej FontsFolder i ImagesFolder odnoszą się do folderu, w którym znajduje się zespół kodu, ResourceFolder i CssStyleSheetFileName odnoszą się do folderu wyjściowego, w którym znajduje się dokument HTML.

W tym przykładzie ResourceFolder określa ścieżkę względną. Ta ścieżka odnosi się do folderu wyjściowego, w którym zapisany jest dokument HTML. Wartość właściwości ResourceFolderAlias jest używana do tworzenia URLs dla wszystkich zasobów.

Poniższy przykład kodu pokazuje, jak pracować z tymi właściwościami:

For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
// The path to the documents directory.
System::SharedPtr<Document> doc = System::MakeObject<Document>(inputDataDir + u"Document.doc");

System::SharedPtr<HtmlSaveOptions> saveOptions = System::MakeObject<HtmlSaveOptions>();
saveOptions->set_CssStyleSheetType(CssStyleSheetType::External);
saveOptions->set_ExportFontResources(true);
saveOptions->set_ResourceFolder(outputDataDir + u"Resources");
        
doc->Save(outputDataDir + u"ExportResourcesUsingHtmlSaveOptions.html", saveOptions);

Korzystając z właściwości ResourceFolderAlias, możemy również określić nazwę folderu używanego do konstruowania URIs wszystkich zasobów zapisanych w dokumencie HTML. Jest to najprostszy sposób określenia sposobu generowania URIs dla wszystkich plików zasobów. Te same informacje można określić osobno dla obrazów i czcionek za pomocą odpowiednio właściwości ImagesFolderAlias i FontsFolderAlias.

Jednak nie ma indywidualnej właściwości dla CSS. Zachowanie FontsFolder, FontsFolderAlias, ImagesFolder, ImagesFolderAlias A właściwości CssStyleSheetFileName nie są zmieniane. Zauważ, że właściwość CssStyleSheetFileName jest używana zarówno do określania nazwy folderu, jak i nazwy pliku.

• ResourceFolder ma niższy priorytet niż foldery określone przez FontsFolder, ImagesFolder i CssStyleSheetFileName. Jeśli folder określony w ResourceFolder nie istnieje, zostanie utworzony automatycznie.
• ResourceFolderAlias ma niższy priorytet niż FontsFolderAlias i ImagesFolderAlias. Jeśli ResourceFolderAlias jest pusty, wartość właściwości ResourceFolder zostanie użyta do utworzenia zasobu URIs. Jeśli ResourceFolderAlias jest ustawiona na “.” (kropka), zasób URIs będzie zawierał tylko nazwy plików bez określania ścieżki.

Eksportuj Zasoby Czcionek Kodujących Base64

Aspose.Words umożliwia określenie, czy zasoby czcionek powinny być osadzone w HTML w kodowaniu Base64. Aby to zrobić, użyj właściwości ExportFontsAsBase64 - jest to rozszerzenie właściwości ExportFontResources. Domyślnie jego wartość to false, A czcionki są zapisywane w osobnych plikach. Ale jeśli ta opcja jest ustawiona na true, czcionki zostaną osadzone w dokumencie CSS w kodowaniu Base64. Właściwość ExportFontsAsBase64 wpływa tylko na format HTML i nie wpływa na EPUB i MHTML.

Poniższy przykład kodu pokazuje, jak wyeksportować czcionki zakodowane w Base64 do HTML:

For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
System::SharedPtr<Document> doc = System::MakeObject<Document>(inputDataDir + u"Document.doc");

System::SharedPtr<HtmlSaveOptions> saveOptions = System::MakeObject<HtmlSaveOptions>();
saveOptions->set_ExportFontResources(true);
saveOptions->set_ExportFontsAsBase64(true);
        
System::String outputPath = outputDataDir + u"ExportFontsAsBase64.html";
doc->Save(outputPath, saveOptions);

Określ opcje zapisu podczas konwersji na EPUB

Aspose.Words umożliwia konwersję dokumentu Word do formatu EPUB przy użyciu domyślnych lub niestandardowych opcji zapisywania. Możesz określić liczbę opcji, przekazując instancję HtmlSaveOptions do metody Save.

Poniższy przykład kodu pokazuje, jak przekonwertować dokument Word na EPUB z określeniem niektórych niestandardowych opcji zapisywania:

For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
// Load the document from disk.
System::SharedPtr<Document> doc = System::MakeObject<Document>(inputDataDir + u"Document.EpubConversion.doc");

// Create a new instance of HtmlSaveOptions. This object allows us to set options that control
// How the output document is saved.
System::SharedPtr<HtmlSaveOptions> saveOptions = System::MakeObject<HtmlSaveOptions>();

// Specify the desired encoding.
saveOptions->set_Encoding(System::Text::Encoding::get_UTF8());

// Specify at what elements to split the internal HTML at. This creates a new HTML within the EPUB 
// which allows you to limit the size of each HTML part. This is useful for readers which cannot read 
// HTML files greater than a certain size e.g 300kb.
saveOptions->set_DocumentSplitCriteria(DocumentSplitCriteria::HeadingParagraph);

// Specify that we want to export document properties.
saveOptions->set_ExportDocumentProperties(true);

// Specify that we want to save in EPUB format.
saveOptions->set_SaveFormat(SaveFormat::Epub);

// Export the document as an EPUB file.
doc->Save(outputDataDir + u"ConvertDocumentToEPUB.ConvertDocumentToEPUB.epub", saveOptions);

Możesz pobrać plik szablonu tego przykładu z Aspose.Words GitHub.