resolve_font_names property

HtmlSaveOptions.resolve_font_names property

Specifies whether font family names used in the document are resolved and substituted according to Document.font_settings when being written into HTML-based formats.

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

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

Remarks

By default, this option is set to False and font family names are written to HTML as specified in source documents. That is, Document.font_settings are ignored and no resolution or substitution of font family names is performed.

If this option is set to True, Aspose.Words uses Document.font_settings to resolve each font family name specified in a source document into the name of an available font family, performing font substitution as required.

Examples

Shows how to resolve all font names before writing them to HTML.

doc = aw.Document(MY_DIR + 'Missing font.docx')
# This document contains text that names a font that we do not have.
self.assertIsNotNone(doc.font_infos.get_by_name('28 Days Later'))
# If we have no way of getting this font, and we want to be able to display all the text
# in this document in an output HTML, we can substitute it with another font.
font_settings = aw.fonts.FontSettings()
font_settings.substitution_settings.default_font_substitution.default_font_name = 'Arial'
font_settings.substitution_settings.default_font_substitution.enabled = True
doc.font_settings = font_settings
save_options = aw.saving.HtmlSaveOptions(aw.SaveFormat.HTML)
# By default, this option is set to 'False' and Aspose.Words writes font names as specified in the source document
save_options.resolve_font_names = resolve_font_names
doc.save(ARTIFACTS_DIR + 'HtmlSaveOptions.resolve_font_names.html', save_options)
with open(ARTIFACTS_DIR + 'HtmlSaveOptions.resolve_font_names.html', 'rt', encoding='utf-8') as file:
    out_doc_contents = file.read()
if resolve_font_names:
    self.assertIn('<span style="font-family:Arial">', out_doc_contents)
else:
    self.assertIn('<span style="font-family:\'28 Days Later\'">', out_doc_contents)

resolve_font_names property

HtmlSaveOptions.resolve_font_names property

Remarks

Examples

See Also