---
title: "문서를 HTML로 변환"
---


HTML 및 MHTML 흐름 레이아웃 형식의 문서도 널리 사용되며 모든 웹 플랫폼에서 사용할 수 있습니다. 이러한 이유로 문서를 HTML 및 MHTML로 변환하는 것은 Aspose.Words의 중요한 기능입니다.

EPUB("Electronic Publication"의 약어)는 전자 서적 배포에 일반적으로 사용되는 HTML 기반 형식입니다. 이 형식은 대부분의 독서 장치와 호환되는 전자 서적을 내보내기 위해 Aspose.Words에서 완벽하게 지원됩니다.

## 문서 변환

HTML, MHTML 또는 EPUB로의 간단한 변환을 위해 [save](https://reference.aspose.com/words/python-net/aspose.words/document/save/) 메서드 오버로드 중 하나가 사용됩니다. 문서를 파일이나 스트림에 저장하고 출력 문서 저장 형식을 명시적으로 설정하거나 파일 이름 확장자에서 정의할 수 있습니다.

다음 예에서는 저장 형식을 지정하여 DOCX를 HTML로 변환하는 방법을 보여줍니다

{{< highlight python >}}
# Load the document from disk.
doc = aw.Document(dataDir + "Test File.docx")

# Save the document into HTML.
doc.save(dataDir + "Document", aw.SaveFormat.HTML)
{{< /highlight >}}

문서를 MHTML 또는 EPUB로 변환하려면 각각 [SaveFormat.MHTML](https://reference.aspose.com/words/python-net/aspose.words/saveformat/#mhtml) 또는 [SaveFormat.EPUB](https://reference.aspose.com/words/python-net/aspose.words/saveformat/#epub)를 사용하세요.

## 왕복 정보가 포함된 문서 변환

HTML 형식은 많은 Microsoft Word 기능을 지원하지 않으며 문서 모델을 원본에 최대한 가깝게 복원해야 하는 경우 HTML 파일 내에 몇 가지 추가 정보를 저장해야 합니다. 이러한 정보를 '왕복정보'라고도 합니다. 이를 위해 Aspose.Words는 **수출_왕복_정보** 속성을 사용하여 HTML, MHTML 또는 EPUB에 저장할 때 왕복 정보를 내보내는 기능을 제공합니다. 왕복 정보를 저장하면 나열된 형식의 문서를 [Document](https://reference.aspose.com/words/python-net/aspose.words/document/) 개체로 다시 로드하는 동안 탭, 설명, 머리글 및 바닥글과 같은 문서 속성을 복원할 수 있습니다.

기본값은 HTML의 경우 *True* 이고 MHTML 및 EPUB의 경우 *False*입니다

- *True* 시 왕복 정보는 -aw - * 해당 HTML 요소의 CSS 속성으로 내보내집니다
- *False* 시 제작된 파일에 출력되는 왕복 정보가 없습니다

다음 코드 예제에서는 문서를 DOCX에서 HTML로 변환할 때 왕복 정보를 내보내는 방법을 보여줍니다

{{< gist "aspose-words-gists" "e9d8f984dac599756ccb4a64b8c79768" "Examples-DocsExamples-DocsExamples-File Formats and Conversions-Save Options-working_with_html_save_options-ExportRoundtripInformation.py" >}}

{{% alert color="primary" %}}

[Aspose.Words GitHub](https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET/blob/master/Examples/Data/Rendering.docx)에서 이 예제의 템플릿 파일을 다운로드할 수 있습니다.

{{% /alert %}}

## HTML로 변환 시 저장 옵션 지정

Aspose.Words를 사용하면 기본 또는 사용자 정의 저장 옵션을 사용하여 Word 문서를 HTML로 변환할 수 있습니다. 사용자 정의 저장 옵션의 몇 가지 예가 아래에 설명되어 있습니다.

### 리소스 저장을 위한 폴더 지정

Aspose.Words를 사용하면 문서가 HTML로 변환될 때 이미지, 글꼴, 외부 CSS와 같은 모든 리소스가 저장되는 물리적 폴더를 지정할 수 있습니다. 기본적으로 이는 빈 문자열입니다.

[resource_folder](https://reference.aspose.com/words/python-net/aspose.words.saving/htmlsaveoptions/resource_folder/) 속성을 지정하는 것은 모든 리소스가 기록되어야 하는 폴더를 설정하는 가장 간단한 방법입니다. 지정된 폴더에 글꼴을 저장하는 [fonts_folder](https://reference.aspose.com/words/python-net/aspose.words.saving/htmlsaveoptions/fonts_folder/)와 지정된 폴더에 이미지를 저장하는 [images_folder](https://reference.aspose.com/words/python-net/aspose.words.saving/htmlsaveoptions/images_folder/)과 같은 개별 속성을 사용할 수 있습니다. 상대 경로가 지정되면 [fonts_folder](https://reference.aspose.com/words/python-net/aspose.words.saving/htmlsaveoptions/fonts_folder/) 및 [images_folder](https://reference.aspose.com/words/python-net/aspose.words.saving/htmlsaveoptions/images_folder/)은 코드 어셈블리가 있는 폴더를 참조하고, [resource_folder](https://reference.aspose.com/words/python-net/aspose.words.saving/htmlsaveoptions/resource_folder/) 및 [css_style_sheet_file_name](https://reference.aspose.com/words/python-net/aspose.words.saving/htmlsaveoptions/css_style_sheet_file_name/)는 HTML 문서가 있는 출력 폴더를 참조합니다.

이 예에서 [resource_folder](https://reference.aspose.com/words/python-net/aspose.words.saving/htmlsaveoptions/resource_folder/)는 상대 경로를 지정합니다. 이 경로는 HTML 문서가 저장되는 출력 폴더를 나타냅니다. [resource_folder_alias](https://reference.aspose.com/words/python-net/aspose.words.saving/htmlsaveoptions/resource_folder_alias/) 속성의 값은 모든 리소스에 대한 URL을 만드는 데 사용됩니다.

다음 코드 예제에서는 이러한 속성을 사용하는 방법을 보여줍니다

{{< gist "aspose-words-gists" "e9d8f984dac599756ccb4a64b8c79768" "Examples-DocsExamples-DocsExamples-File Formats and Conversions-Save Options-working_with_html_save_options-ExportResources.py" >}}

[resource_folder_alias](https://reference.aspose.com/words/python-net/aspose.words.saving/htmlsaveoptions/resource_folder_alias/) 속성을 사용하면 HTML 문서에 기록된 모든 리소스의 URI를 구성하는 데 사용되는 폴더의 이름을 지정할 수도 있습니다. 이는 모든 리소스 파일에 대해 URI를 생성하는 방법을 지정하는 가장 간단한 방법입니다. 각각 [images_folder_alias](https://reference.aspose.com/words/python-net/aspose.words.saving/htmlsaveoptions/images_folder_alias/) 및 [fonts_folder_alias](https://reference.aspose.com/words/python-net/aspose.words.saving/htmlsaveoptions/fonts_folder_alias/) 속성을 통해 이미지와 글꼴에 대해 동일한 정보를 별도로 지정할 수 있습니다.

그러나 CSS에는 개별 속성이 없습니다. [fonts_folder](https://reference.aspose.com/words/python-net/aspose.words.saving/htmlsaveoptions/fonts_folder/), [fonts_folder_alias](https://reference.aspose.com/words/python-net/aspose.words.saving/htmlsaveoptions/fonts_folder_alias/), [images_folder](https://reference.aspose.com/words/python-net/aspose.words.saving/htmlsaveoptions/images_folder/), [images_folder_alias](https://reference.aspose.com/words/python-net/aspose.words.saving/htmlsaveoptions/images_folder_alias/) 및 [css_style_sheet_file_name](https://reference.aspose.com/words/python-net/aspose.words.saving/htmlsaveoptions/css_style_sheet_file_name/) 속성의 동작은 변경되지 않습니다. [css_style_sheet_file_name](https://reference.aspose.com/words/python-net/aspose.words.saving/htmlsaveoptions/css_style_sheet_file_name/) 속성은 폴더 이름과 파일 이름을 지정하는 데 모두 사용됩니다.

- [resource_folder](https://reference.aspose.com/words/python-net/aspose.words.saving/htmlsaveoptions/resource_folder/)는 [fonts_folder](https://reference.aspose.com/words/python-net/aspose.words.saving/htmlsaveoptions/fonts_folder/), [images_folder](https://reference.aspose.com/words/python-net/aspose.words.saving/htmlsaveoptions/images_folder/), [css_style_sheet_file_name](https://reference.aspose.com/words/python-net/aspose.words.saving/htmlsaveoptions/css_style_sheet_file_name/)를 통해 지정된 폴더보다 우선순위가 낮습니다. [resource_folder](https://reference.aspose.com/words/python-net/aspose.words.saving/htmlsaveoptions/resource_folder/)에 지정된 폴더가 존재하지 않는 경우 자동으로 생성됩니다.
- [resource_folder_alias](https://reference.aspose.com/words/python-net/aspose.words.saving/htmlsaveoptions/resource_folder_alias/)는 [fonts_folder_alias](https://reference.aspose.com/words/python-net/aspose.words.saving/htmlsaveoptions/fonts_folder_alias/) 및 [images_folder_alias](https://reference.aspose.com/words/python-net/aspose.words.saving/htmlsaveoptions/images_folder_alias/)보다 우선순위가 낮습니다. [resource_folder_alias](https://reference.aspose.com/words/python-net/aspose.words.saving/htmlsaveoptions/resource_folder_alias/)가 비어 있으면 [resource_folder](https://reference.aspose.com/words/python-net/aspose.words.saving/htmlsaveoptions/resource_folder/) 속성 값이 리소스 URI를 만드는 데 사용됩니다. [resource_folder_alias](https://reference.aspose.com/words/python-net/aspose.words.saving/htmlsaveoptions/resource_folder_alias/)가 "."로 설정된 경우 (점)을 사용하면 리소스 URI에는 경로를 지정하지 않고 파일 이름만 포함됩니다.

### Base64 인코딩 글꼴 리소스 내보내기

Aspose.Words는 글꼴 리소스를 Base64 인코딩의 HTML에 포함해야 하는지 여부를 지정하는 기능을 제공합니다. 이를 수행하려면 [export_fonts_as_base64](https://reference.aspose.com/words/python-net/aspose.words.saving/htmlsaveoptions/export_fonts_as_base64/) 속성을 사용하십시오. 이는 [export_font_resources](https://reference.aspose.com/words/python-net/aspose.words.saving/htmlsaveoptions/export_font_resources/) 속성의 확장입니다. 기본적으로 해당 값은 *False*이며 글꼴은 별도의 파일에 기록됩니다. 하지만 이 옵션을 *True* 으로 설정하면 글꼴이 Base64 인코딩으로 문서의 CSS에 포함됩니다. [export_fonts_as_base64](https://reference.aspose.com/words/python-net/aspose.words.saving/htmlsaveoptions/export_fonts_as_base64/) 속성은 HTML 형식에만 영향을 미치며 EPUB 및 MHTML에는 영향을 주지 않습니다.

다음 코드 예제에서는 Base64로 인코딩된 글꼴을 HTML로 내보내는 방법을 보여줍니다

{{< gist "aspose-words-gists" "e9d8f984dac599756ccb4a64b8c79768" "Examples-DocsExamples-DocsExamples-File Formats and Conversions-Save Options-working_with_html_save_options-ExportFontsAsBase64.py" >}}

## EPUB로 변환 시 저장 옵션 지정

Aspose.Words를 사용하면 기본 또는 사용자 정의 저장 옵션을 사용하여 Word 문서를 EPUB 형식으로 변환할 수 있습니다. [HtmlSaveOptions](https://reference.aspose.com/words/python-net/aspose.words.saving/htmlsaveoptions/) 인스턴스를 [save](https://reference.aspose.com/words/python-net/aspose.words/document/save/) 메서드에 전달하여 다양한 옵션을 지정할 수 있습니다.

다음 코드 예제에서는 일부 사용자 지정 저장 옵션을 지정하여 Word 문서를 EPUB로 변환하는 방법을 보여줍니다

{{< highlight python >}}
# Load the document from disk.
doc = aw.Document(docs_base.my_dir + "Rendering.docx")

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

# Specify the desired encoding.
saveOptions.encoding = "utf-8"

# 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.document_split_criteria = aw.saving.DocumentSplitCriteria.HEADING_PARAGRAPH

# Specify that we want to export document properties.
saveOptions.export_document_properties = True

# Specify that we want to save in EPUB format.
saveOptions.save_format = aw.SaveFormat.EPUB

# Export the document as an EPUB file.
doc.save(docs_base.artifacts_dir + "Document.EpubConversion_out.epub", saveOptions)
{{< /highlight >}}

{{% alert color="primary" %}}

[Aspose.Words GitHub](https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET/blob/master/Examples/Data/Rendering.docx)에서 이 예제의 템플릿 파일을 다운로드할 수 있습니다.

{{% /alert %}}