Перетворення документа в HTML, MHTML або EPUB

У форматах HTML і MHTML є дуже популярними і можуть бути використані на будь-якій веб-платформі. З цієї причини, перетворення документів в HTML і MHTML є важливою особливістю Aspose.Wordsй

EPUB (коротко для “Електронної публічності”) - формат HTML, який використовується для розподілу електронних книг. Цей формат повністю підтримується Aspose.Words для експорту електронних книг, які сумісні з найчистішими пристроями.

Конвертувати документ

Для простого перетворення в HTML, MHTML, або EPUB, один з Save використовується метод перевантаження. Ви можете зберегти документ на файл або потік і явно встановити вихідний документ, зберегти формат або визначити його з розширення імені файлу.

Наступний приклад показує, як перетворити DOCX в HTML з визначенням формату збереження:

.NET

// Load the document from disk.
Document doc = new Document(dataDir + "Test File.docx");

// Save the document into HTML.
doc.Save(dataDir + "Document", SaveFormat.Html);

Для перетворення документа в MHTML або EPUB, використовуйте SaveFormat.Mhtml або SaveFormat.Epub відповідно.

Конвертувати документацію з круглою кнопкою

Формат HTML не підтримує багато Microsoft Word Ми можемо самі зателефонувати одержувачу і узгодити зручний час і місце вручення квітів, а якщо необхідно, то збережемо сюрприз. Така інформація також називається “круглою інформацією”. Для цього Aspose.Words дає можливість експортувати інформацію про круглі смуги при збереженні HTML, MHTML або EPUB за допомогою ExportRoundtripInformation майно. Збереження інформації про круглий план дозволяє відновити такі властивості, як вкладки, коментарі, заголовки та нижній колонтитули під час завантаження документів, зазначених форматів, що зберігаються у вигляді вкладок Document об’єкт.

Значення за замовчуванням true для HTML false для MHTML та EPUB:

• Коли true, Інформація про круглий рядок експортується як - aw - * CSS властивості відповідних елементів HTML
• Коли false, немає інформації про круглі смуги, щоб бути виведеними у виготовлені файли

Приклад коду показує, як експортувати інформацію про круглі смуги при перетворенні документа з DOCX в HTML:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir_LoadingAndSaving();

// Load the document from disk.
Document doc = new Document(dataDir + "Test File (doc).docx");

HtmlSaveOptions options = new 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.ExportRoundtripInformation = true;
            
doc.Save(dataDir + "ExportRoundtripInformation_out.html", options);

Ви можете завантажити файл шаблону цього прикладу з Aspose.Words GitHubй

Вказати параметри збереження при переході в HTML

Aspose.Words дозволяє конвертувати документ Word в HTML за допомогою параметра за замовчуванням або користувацького збереження. Нижче описано приклади користувацьких варіантів збереження.

Вкажіть папку для економії ресурсів

Використання Aspose.Words Ми можемо вказати фізичну папку, де всі ресурси, такі як зображення, шрифти та зовнішній CSS, зберігаються при перетворенні документа в HTML. За замовчуванням, це порожній рядок.

Визначення ResourceFolder майно є найпростішим способом встановити папку, де всі ресурси повинні бути написані. Ми можемо використовувати індивідуальні властивості, такі як FontsFolder що зберігає шрифти до вказаної папки та ImagesFolder що зберігає зображення до вказаної папки. Коли вказано відносний шлях, FontsFolder і ImagesFolder в папку, де знаходиться збір коду, ResourceFolder і CssStyleSheetFileName вкажіть папку виходу, де знаходиться HTML-документ.

У цьому прикладі ResourceFolder визначає відносний шлях. Цей шлях відноситься до папки виходу, де зберігаються HTML-документ. Значення значення ResourceFolderAlias використовується для створення URL-адрес для всіх ресурсів.

Приклад коду показує, як працювати з цими властивостями:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir_LoadingAndSaving();
string fileName = "Document.docx";
Document doc = new Document(dataDir + fileName);
HtmlSaveOptions saveOptions = new HtmlSaveOptions();
saveOptions.CssStyleSheetType = CssStyleSheetType.External;
saveOptions.ExportFontResources = true;
saveOptions.ResourceFolder = dataDir + @"\Resources";
saveOptions.ResourceFolderAlias = "http://example.com/resources";
doc.Save(dataDir + "ExportResourcesUsingHtmlSaveOptions.html", saveOptions);

Використання ResourceFolderAlias майно, ми також можемо вказати ім’я папки, що використовується для побудови URIs всіх ресурсів, записаних в HTML документ. Цей простий спосіб вказати, як URI повинні бути створені для всіх файлів ресурсів. Те ж інформацію можна вказати на зображення і шрифти окремо за допомогою ImagesFolderAlias і FontsFolderAlias властивості, відповідно.

Не існує індивідуальних властивостей для CSS. Поведінка поведінки FontsFolder, FontsFolderAlias, ImagesFolder, ImagesFolderAlias і CssStyleSheetFileName не змінюються властивості. Зверніть увагу, що CssStyleSheetFileName майно використовується як для позначення назви папки, так і назви файлів.

• до ResourceFolder має більш низький пріоритет, ніж папки, вказані через FontsFolder, ImagesFolder, і CssStyleSheetFileNameй Якщо папка вказана в папці ResourceFolder не існує, він буде створений автоматично.
• до ResourceFolderAlias має менший пріоритет, ніж FontsFolderAlias і ImagesFolderAliasй Якщо ResourceFolderAlias порожній, значення значення ResourceFolder Для створення ресурсу URIS використовуються власні властивості. Якщо ResourceFolderAlias Встановлюється до “.” (dot), ресурс URIs міститиме лише імена файлів, які не вказують на шлях.

Експорт base64 кодування ресурсів

Aspose.Words надає можливість вказати, чи повинні бути вбудованими в HTML в кодуваннях Base64. Для виконання цього використовуйте ExportFontsAsBase64 властивість – це розширення ExportFontResources майно. За замовчуванням, його значення false, і шрифти записані в окремі файли. Але якщо цей варіант встановлюється true, шрифти будуть вбудовані в CSS документа в кодуванні Base64. Про нас ЕкспортФонтсАсБаза64 лише в HTML форматі і не впливає на EPUB і MHTML.

Приклад коду показує, як експортувати шрифти Base64-encoded до HTML:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir_LoadingAndSaving();
string fileName = "Document.docx";
Document doc = new Document(dataDir + fileName);
HtmlSaveOptions saveOptions = new HtmlSaveOptions();
saveOptions.ExportFontResources = true;
saveOptions.ExportFontsAsBase64 = true;           
dataDir = dataDir + "ExportFontsAsBase64_out.html";
doc.Save(dataDir, saveOptions);

Вкажіть параметри збереження при переході в EPUB

Aspose.Words дозволяє конвертувати документ Word у формат EPUB за замовчуванням або користувацькі параметри збереження. Ви можете вказати кількість варіантів, пройшовши екземпляр HtmlSaveOptions до Save метод.

Приклад наступного коду показує, як перетворити документ Word в EPUB з вказуванням деяких варіантів користувацького збереження:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir_LoadingAndSaving();

// Load the document from disk.
Document doc = new Document(dataDir + "Document.EpubConversion.docx");

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

// Specify the desired encoding.
saveOptions.Encoding = System.Text.Encoding.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.DocumentSplitCriteria = DocumentSplitCriteria.HeadingParagraph;

// Specify that we want to export document properties.
saveOptions.ExportDocumentProperties = true;

// Specify that we want to save in EPUB format.
saveOptions.SaveFormat = SaveFormat.Epub;

// Export the document as an EPUB file.
doc.Save(dataDir + "Document.EpubConversion_out.epub", saveOptions);

Ви можете завантажити файл шаблону цього прикладу з Aspose.Words GitHubй

Дивитися ще

• Як експортувати інформацію про круглі смуги при збереженні HTML