use_target_machine_fonts property

HtmlFixedSaveOptions.use_target_machine_fonts property

Flag indicates whether fonts from target machine must be used to display the document. If this flag is set to True, HtmlFixedSaveOptions.font_format and HtmlFixedSaveOptions.export_embedded_fonts properties do not have effect, also HtmlFixedSaveOptions.resource_saving_callback is not fired for fonts. Default is False.

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

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

Examples

Shows how use fonts only from the target machine when saving a document to HTML.

doc = aw.Document(MY_DIR + 'Bullet points with alternative font.docx')
save_options = aw.saving.HtmlFixedSaveOptions()
save_options.export_embedded_css = True
save_options.use_target_machine_fonts = use_target_machine_fonts
save_options.font_format = aw.saving.ExportFontFormat.TTF
save_options.export_embedded_fonts = False
doc.save(ARTIFACTS_DIR + 'HtmlFixedSaveOptions.using_machine_fonts.html', save_options)
with open(ARTIFACTS_DIR + 'HtmlFixedSaveOptions.using_machine_fonts.html', 'rt', encoding='utf-8') as file:
    out_doc_contents = file.read()
if use_target_machine_fonts:
    self.assertNotRegex(out_doc_contents, '@font-face')
else:
    self.assertIn("@font-face { font-family:'Arial'; font-style:normal; font-weight:normal; src:local('☺'), " + "url('HtmlFixedSaveOptions.using_machine_fonts/font001.ttf') format('truetype'); }", out_doc_contents)

See Also

HtmlFixedSaveOptions.show_page_border property