def truncate_xhtml(string, size, _strip_xhtml=False, _decode_entities=False): """Truncate a XHTML string to roughly a given size (full words). :param string: XHTML :type string: unicode :param size: Max length :param _strip_xhtml: Flag to strip out all XHTML :param _decode_entities: Flag to convert XHTML entities to unicode chars :rtype: unicode """ if not string: return u'' if _strip_xhtml: # Insert whitespace after block elements. # So they are separated when we strip the xhtml. string = block_spaces.sub(u"\\1 ", string) string = strip_xhtml(string) string = decode_entities(string) if len(string) > size: string = text.truncate(string, length=size, whole_word=True) if _strip_xhtml: if not _decode_entities: # re-encode the entities, if we have to. string = encode_entities(string) else: if _decode_entities: string = Cleaner(string, *truncate_filters, **cleaner_settings)() else: # re-encode the entities, if we have to. string = Cleaner(string, 'encode_xml_specials', *truncate_filters, **cleaner_settings)() return string.strip()