Limpar um documento

Às vezes, pode ser necessário remover informações não utilizadas ou duplicadas para reduzir o tamanho do documento de saída e o tempo de processamento.

Embora você possa localizar e remover dados não utilizados, como estilos ou listas, ou duplicar informações manualmente, será muito mais conveniente fazer isso usando os recursos e capacidades fornecidos pelo Aspose.Words.

A classe CleanupOptions permite especificar opções para limpeza de documentos. Para remover estilos duplicados ou apenas estilos ou listas não utilizados do documento, você pode usar o método cleanup.

Remover informações não utilizadas de um documento

Você pode usar as propriedades unused_styles e unused_builtin_styles para detectar e remover estilos marcados como “não utilizados”.

Você pode usar a propriedade unused_lists para detectar e remover listas e definições de lista marcadas como “não utilizadas”.

O exemplo de código a seguir mostra como remover apenas estilos não utilizados de um documento:

# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET
doc = aw.Document(docs_base.my_dir + "Unused styles.docx")

# Combined with the built-in styles, the document now has eight styles.
# A custom style is marked as "used" while there is any text within the document
# formatted in that style. This means that the 4 styles we added are currently unused.
print(f"Count of styles before Cleanup: {doc.styles.count}\n" +
                    f"Count of lists before Cleanup: {doc.lists.count}")

# Cleans unused styles and lists from the document depending on given CleanupOptions. 
cleanupOptions = aw.CleanupOptions()
cleanupOptions.unused_lists = False
cleanupOptions.unused_styles = True 
doc.cleanup(cleanupOptions)

print(f"Count of styles after Cleanup was decreased: {doc.styles.count}\n" +
                    f"Count of lists after Cleanup is the same: {doc.lists.count}")

doc.save(docs_base.artifacts_dir + "WorkingWithDocumentOptionsAndSettings.cleanup_unused_styles_and_lists.docx")

Remover informações duplicadas de um documento

Você também pode usar a propriedade duplicate_style para substituir todos os estilos duplicados pelo original e remover duplicatas de um documento.

O exemplo de código a seguir mostra como remover estilos duplicados de um documento:

# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET
doc = aw.Document(docs_base.my_dir + "Document.docx")

# Count of styles before Cleanup.
print(doc.styles.count)

# Cleans duplicate styles from the document.
options = aw.CleanupOptions()
options.duplicate_style = True 
doc.cleanup(options)

# Count of styles after Cleanup was decreased.
print(doc.styles.count)

doc.save(docs_base.artifacts_dir + "WorkingWithDocumentOptionsAndSettings.cleanup_duplicate_style.docx")