export_embedded_fonts property

HtmlFixedSaveOptions.export_embedded_fonts property

Specifies whether fonts should be embedded into Html document in Base64 format. Note setting this flag can significantly increase size of output Html file.

@property
def export_embedded_fonts(self) -> bool:
    ...

@export_embedded_fonts.setter
def export_embedded_fonts(self, value: bool):
    ...

Examples

Shows how to determine where to store embedded fonts when exporting a document to Html.

doc = aw.Document(MY_DIR + "Embedded font.docx")

# When we export a document with embedded fonts to .html,
# Aspose.Words can place the fonts in two possible locations.
# Setting the "export_embedded_fonts" flag to "True" will store the raw data for embedded fonts within the CSS stylesheet,
# in the "url" property of the "@font-face" rule. This may create a huge CSS stylesheet file
# and reduce the number of external files that this HTML conversion will create.
# Setting this flag to "False" will create a file for each font.
# The CSS stylesheet will link to each font file using the "url" property of the "@font-face" rule.
html_fixed_save_options = aw.saving.HtmlFixedSaveOptions()
html_fixed_save_options.export_embedded_fonts = export_embedded_fonts

doc.save(ARTIFACTS_DIR + "HtmlFixedSaveOptions.export_embedded_fonts.html", html_fixed_save_options)

with open(ARTIFACTS_DIR + "HtmlFixedSaveOptions.export_embedded_fonts/styles.css", "rt", encoding="utf-8") as file:
    out_doc_contents = file.read()

if export_embedded_fonts:
    self.assertRegex(out_doc_contents,
        "@font-face { font-family:'Arial'; font-style:normal; font-weight:normal; src:local[(]'☺'[)], url[(].+[)] format[(]'woff'[)]; }")
    self.assertEqual(0, len(glob.glob(ARTIFACTS_DIR + "HtmlFixedSaveOptions.export_embedded_fonts/*.woff")))
else:
    self.assertRegex(out_doc_contents,
        "@font-face { font-family:'Arial'; font-style:normal; font-weight:normal; src:local[(]'☺'[)], url[(]'font001[.]woff'[)] format[(]'woff'[)]; }")
    self.assertEqual(2, len(glob.glob(ARTIFACTS_DIR + "HtmlFixedSaveOptions.export_embedded_fonts/*.woff")))

See Also

HtmlFixedSaveOptions.export_embedded_css property HtmlFixedSaveOptions.export_embedded_images property