feat(docx): Process drawingml objects in docx

[rateixei]

This PR implements a way to import Docx DrawingML objects as PNG images into DoclingDocument objects. This includes diagrams, hand-drawn shapes, and Word/Excel charts.

This is performed with the following steps:

• Once a DrawingML object is found, an empty copy of the docx file is created (this is needed to keep the formatting styles there are defined in the file). One file is created for each paragraph that contains a DrawingML object.
• The file is populated with the DrawingML object of that paragraph
• The docx file is temporarily saved, and is exported to a temporary PDF ONLY with LibreOffice (if available, either on PATH, or as a Docling specific environment variable DOCLING_LIBREOFFICE_CMD). If not available is available, a warning is displayed.
• The temporary PDF is read as PNG, which is then cropped to avoid the page rectangle, and stored as a pillow image.

An example docx file containing diagrams, figures and charts is attached, along with the DoclingDocument export.

Checklist:

• Documentation has been updated, if necessary.
• Examples have been added, if necessary.
• Tests have been added, if necessary.

drawingml_example.docx
drawingml_example.json

[github-actions]

✅ DCO Check Passed

Thanks @rateixei, all your commits are properly signed off. 🎉

[mergify]

Merge Protections

Your pull request matches the following merge protections and will not be merged until they are valid.

🟢 Enforce conventional commit

Wonderful, this rule succeeded.

Make sure that we follow https://www.conventionalcommits.org/en/v1.0.0/

• title ~= ^(fix|feat|docs|style|refactor|perf|test|build|ci|chore|revert)(?:\(.+\))?(!)?:

🟢 Require two reviewer for test updates

Wonderful, this rule succeeded.

When test data is updated, we require two reviewers

• #approved-reviews-by >= 2

[codecov]

Codecov Report

❌ Patch coverage is 84.46602% with 16 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
docling/backend/msword_backend.py	75.00%	12 Missing ⚠️
docling/backend/docx/drawingml/utils.py	92.72%	4 Missing ⚠️

📢 Thoughts on this report? Let us know!

[dosubot]

Related Documentation

Checked 3 published document(s). No updates required.

^{How did I do? Any feedback?}  

[dolfim-ibm]

lgtm

[ceberam]

• IMHO, LibreOffice should be an optional dependency in Docling. However, if a user does not have LibreOffice the backend test fails.

  FAILED tests/test_backend_msword.py::test_e2e_docx_conversions - AssertionError: export to markdown failed on tests/data/docx/drawingml.docx
  

  We could first check if LibreOffice is installed and compare the output accordingly
• Just FYI for later: instead of an environment variable we could use backend options to set the path to LibreOffice, since it is more transparent and easier to document. On the PR #2011 that I am preparing, I introduce backend options
• Could we extend this feature to the xlsx and pptx backends?

[ceberam]

🏆

[dosubot]

Documentation Updates

Checked 3 published document(s). No updates required.

^{How did I do? Any feedback?}