pretty_format property
SaveOptions.pretty_format property
When True
, pretty formats output where applicable.
Default value is False
.
@property
def pretty_format(self) -> bool:
...
@pretty_format.setter
def pretty_format(self, value: bool):
...
Remarks
Set to True
to make HTML, MHTML, EPUB, WordML, RTF, DOCX and ODT output human readable.
Useful for testing or debugging.
Examples
Shows how to enhance the readability of the raw code of a saved .html document.
doc = aw.Document()
builder = aw.DocumentBuilder(doc=doc)
builder.writeln('Hello world!')
html_options = aw.saving.HtmlSaveOptions(aw.SaveFormat.HTML)
html_options.pretty_format = use_pretty_format
doc.save(file_name=ARTIFACTS_DIR + 'HtmlSaveOptions.PrettyFormat.html', save_options=html_options)
# Enabling pretty format makes the raw html code more readable by adding tab stop and new line characters.
html = system_helper.io.File.read_all_text(ARTIFACTS_DIR + 'HtmlSaveOptions.PrettyFormat.html')
if use_pretty_format:
self.assertEqual('<html>\r\n' + '\t<head>\r\n' + '\t\t<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />\r\n' + '\t\t<meta http-equiv="Content-Style-Type" content="text/css" />\r\n' + f'\t\t<meta name="generator" content="{aw.BuildVersionInfo.product} {aw.BuildVersionInfo.version}" />\r\n' + '\t\t<title>\r\n' + '\t\t</title>\r\n' + '\t</head>\r\n' + '\t<body style="font-family:\'Times New Roman\'; font-size:12pt">\r\n' + '\t\t<div>\r\n' + '\t\t\t<p style="margin-top:0pt; margin-bottom:0pt">\r\n' + '\t\t\t\t<span>Hello world!</span>\r\n' + '\t\t\t</p>\r\n' + '\t\t\t<p style="margin-top:0pt; margin-bottom:0pt">\r\n' + '\t\t\t\t<span style="-aw-import:ignore"> </span>\r\n' + '\t\t\t</p>\r\n' + '\t\t</div>\r\n' + '\t</body>\r\n</html>', html)
else:
self.assertEqual('<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8" />' + '<meta http-equiv="Content-Style-Type" content="text/css" />' + f'<meta name="generator" content="{aw.BuildVersionInfo.product} {aw.BuildVersionInfo.version}" /><title></title></head>' + '<body style="font-family:\'Times New Roman\'; font-size:12pt">' + '<div><p style="margin-top:0pt; margin-bottom:0pt"><span>Hello world!</span></p>' + '<p style="margin-top:0pt; margin-bottom:0pt"><span style="-aw-import:ignore"> </span></p></div></body></html>', html)
See Also
- module aspose.words.saving
- class SaveOptions