API облака Aspose.Words

Aspose.Words Cloud позволяет вам преобразовывать документы Word, включая DOC и DOCX, в формат файла HTML. Преобразование Word в HTML полезно в ситуациях, когда вы хотите показать содержимое документа Word в Интернете и сделать его удобным для поисковых систем. Дополнительным преимуществом является то, что для просмотра файлов HTML не требуется специального просмотрщика или стороннего приложения. Aspose.Words Cloud предоставляет следующие API для преобразования документа Word в HTML:

| Имя | Описание |

| ——- | ———— |

| GetDocumentWithFormat | Преобразует документ в облачном хранилище в указанный формат. |

| ConvertDocument | Преобразует документ на локальном диске в указанный формат. |

| SaveAs | Преобразует документ в целевой формат с подробными настройками и сохраняет результат в хранилище. |

Преобразование Word в HTML

Прежде чем вызывать указанные выше API, вам необходимо зарегистрировать учетную запись в Aspose Cloud и получить свой App Key и SID в Cloud Dashboard. Как только вы зарегистрируетесь, вам будет предоставлена щедрая бесплатная пробная версия, чтобы вы могли тестировать API без каких-либо ограничений оценки.

Следующий пример cURL показывает, как преобразовать DOCX в HTML:

// Сначала получите JSON Web Token для аутентификации
// Получите ключ приложения и идентификатор SID приложения с https://dashboard.aspose.cloud/
curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=[APP_SID]&client_secret=[APP_KEY]" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

// Пример cURL для преобразования документа DOCX в HTML в локальном хранилище
curl -v "https://api.aspose.cloud/v4.0/words/convert?format=html" \
-X PUT \
-T DOCXtoHTML.docx \
-H "Content-Type: application/json" \
-H "accept: application/json" \
-H "authorization: Bearer <jwt token>" \
-o DOCXtoHTML.html

Этот фрагмент кода эффективно преобразует файлы DOCX в HTML. Он не создает никаких дополнительных изображений или таблиц стилей. Например, он преобразует изображение в файле DOCX в изображение base64, чтобы вы могли получить вывод с наивысшей точностью. Ниже приведены скриншоты файлов:

Входной файл DOCX

DOCX в HTML

Выходной HTML-файл (предварительный просмотр Google Chrome)

Word в HTML

На скриншотах выше вы можете оценить качество HTML-рендеринга.

Преобразование Word в HTML с подробными настройками

PUT /words/{name}/saveAs API позволяет преобразовывать документы Microsoft Word в HTML с подробными настройками. Следующий пример cURL генерирует ZIP-файл в качестве выходных данных, поскольку мы установили ‘ZipOutput’ на ’true’ в HtmlSaveOptions. Полный список HtmlSaveOptions см. в документации.

// Сначала получите JSON Web Token для аутентификации
// Получите ключ приложения и идентификатор SID приложения с https://dashboard.aspose.cloud/
curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=[APP_SID]&client_secret=[APP_KEY]" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

// Пример cURL для преобразования документа DOCX в HTML и сохранения выходных файлов в формате ZIP
curl -v "https://api.aspose.cloud/v4.0/words/DOCXtoHTML.docx/saveAs" \
-X PUT \
-d "{'SaveFormat': 'html', 'FileName': 'DOCXtoHTML.html', 'ZipOutput': true}" \
-H "accept: application/json" \
-H "Content-Type: application/json" \
-H "authorization: Bearer "<jwt token>

Сгенерированный ZIP-файл будет включать HTML-файл и изображения в формате PNG, JPG и т. д. вместо их преобразования в изображения base64. Давайте взглянем на сравнительный снимок экрана, показывающий источник HTML-файлов, сгенерированных этими фрагментами кода.

Отмеченные разделы на этом изображении поясняют, как работают оба подхода. Левая сторона отображает тег изображения, содержащий данные, как изображение base64. В то время как правая сторона, захваченная из DOCXtoHTML.zip, отображает изображение как локальный файл PNG.

Преобразование HTML в Word

Мы подробно рассмотрели преобразование Word в HTML. Давайте рассмотрим преобразование HTML в Word, которое является еще одной заслуживающей упоминания функцией Aspose.Words Cloud. Оно позволяет преобразовывать веб-страницу в DOCX, просто указав URL. Пример cURL довольно прост, как показано ниже:

// Сначала получите JSON Web Token для аутентификации
// Получите ключ приложения и идентификатор SID приложения с https://dashboard.aspose.cloud/
curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=[APP_SID]&client_secret=[APP_KEY]" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

// Пример cURL для загрузки веб-страницы и сохранения ее в формате docx
curl -v "https://api.aspose.cloud/v4.0/words/loadWebDocument" \
-X PUT \
-d "{ 'LoadingDocumentUrl': 'https://www.le.ac.uk/oerresources/bdra/html/page_09.htm', 'SaveOptions': { 'SaveFormat': 'docx', 'FileName': 'HTMLDocument.docx', 'SaveRoutingSlip': true } }" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>"

Механизм рендеринга достаточно эффективен для создания WYSIWYG-вывода в файле DOCX. Ниже приведен скриншот выходного файла DOCX.

Уровни заголовков, списки, отступы, форматирование — все на месте, что красноречиво говорит о возможностях движка рендеринга. Мы надеемся, что вам понравится использовать эти простые, но мощные функции. В случае возникновения вопросов или проблем обращайтесь к нам через Бесплатный форум поддержки. Мы будем рады вам помочь!

Предложенные статьи

Мы настоятельно рекомендуем вам ознакомиться со следующими статьями, чтобы узнать больше о: