Files
docling-core/test/data/doc/content_all.gt.dclg.xml
Panos Vagenas 3704874312 feat(doclang): add support for .dclx archive, <description>, <summary> (#658)
* feat(doclang): add .dclx archive save and load support

- Add `DoclingDocument.save_as_doclang_archive()` and `load_from_doclang_archive()` for DocLang OPC archives (`.dclx`)
- Store markup in `document.xml` with page rasters under `pages/` and picture assets under `assets/`
- Resolve relative `<src uri="..."/>` paths when loading from an extracted archive
- Bump DocLang serialization to version `0.7` and update namespace/version golden fixtures
- Restore picture images from archive-relative URIs via `DocLangDocDeserializer` (`media_root`)
- Add safe zip extraction and archive path helpers in `docling_core.types.doc.utils`
- Promote `doclang` to a runtime dependency (`>=0.7,<0.8`) on PyPI 0.7.0
- Remove `doclang` from dev dependency group and refresh `uv.lock`
- Add `test/test_doclang_archive.py` with save, load, and roundtrip coverage
- Add two-page archive fixtures under `test/data/doc/doclang_archive/`

Signed-off-by: Panos Vagenas <pva@zurich.ibm.com>

* feat(doclang): add support for `<description>` and `<summary>`

Signed-off-by: Panos Vagenas <pva@zurich.ibm.com>

---------

Signed-off-by: Panos Vagenas <pva@zurich.ibm.com>
2026-06-25 18:06:10 +02:00

225 lines
4.7 KiB
XML
Vendored

<doclang>
<list>
<ldiv>
<marker>■</marker>
</ldiv>
item of leading list
</list>
<heading>Title of the Document</heading>
<text>
<content>Author 1
Affiliation 1</content>
</text>
<text>
<content>Author 2
Affiliation 2</content>
</text>
<heading level="2">1. Introduction</heading>
<text>This paper introduces the biggest invention ever made. ...</text>
<list>
<ldiv>
<marker>■</marker>
</ldiv>
list item 1
<ldiv>
<marker>■</marker>
</ldiv>
list item 2
<ldiv>
<marker>■</marker>
</ldiv>
<text>list item 3</text>
<list class="ordered">
<ldiv/>
list item 3.a
<ldiv/>
list item 3.b
<ldiv/>
<text>list item 3.c</text>
<list class="ordered">
<ldiv/>
list item 3.c.i
</list>
</list>
<ldiv>
<marker>■</marker>
</ldiv>
list item 4
</list>
<table>
<caption>This is the caption of table 1.</caption>
<fcel/>
Product
<fcel/>
Years
<lcel/>
<nl/>
<ucel/>
<fcel/>
2016
<fcel/>
2017
<nl/>
<fcel/>
Apple
<fcel/>
49823
<fcel/>
695944
<nl/>
</table>
<picture>
<caption>This is the caption of figure 1.</caption>
</picture>
<picture>
<caption>This is the caption of figure 2.</caption>
<src uri="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAIAAAAlC+aJAAAAdElEQVRoBdXBAQEAAABAIP6ftkPJnMzJnMzJnMzJnMzJnMzJnMzJnMzJnMzJnMzJnMzJnMzJnMzJnMzJnMzJnMzJnMzJnMzJnMzJnMzJnMzJnMzJnMzJnMzJnMzJnMzJnMzJnMzJnMzJnMzJnMzJnMzJnMwFULoAQbykEYoAAAAASUVORK5CYII="/>
</picture>
<list>
<ldiv>
<marker>■</marker>
</ldiv>
item 1 of list
</list>
<list>
<ldiv>
<marker>*</marker>
</ldiv>
item 1 of list after empty list
<ldiv/>
item 2 of list after empty list
</list>
<list>
<ldiv>
<marker>■</marker>
</ldiv>
item 1 of neighboring list
<ldiv>
<marker>■</marker>
</ldiv>
<text>item 2 of neighboring list</text>
<list>
<ldiv>
<marker>□</marker>
</ldiv>
item 1 of sub list
<ldiv>
<marker>□</marker>
</ldiv>
Here a code snippet:
<code>
<label value="Python"/>
<![CDATA[print("Hello world")]]> </code>
(to be displayed inline)
<ldiv>
<marker>□</marker>
</ldiv>
Here a formula:
<formula>E=mc^2</formula>
(to be displayed inline)
</list>
</list>
<text>Here a code block:</text>
<code>
<label value="Python"/>
<![CDATA[print("Hello world")]]> </code>
<text>Here a formula block:</text>
<formula>E=mc^2</formula>
<text>
Some formatting chops:
<bold>bold</bold>
<italic>italic</italic>
<underline>underline</underline>
<strikethrough>strikethrough</strikethrough>
<subscript>subscript</subscript>
<superscript>superscript</superscript>
hyperlink
<![CDATA[&]]>
<strikethrough>
<underline>
<italic>
<bold>everything at the same time.</bold>
</italic>
</underline>
</strikethrough>
</text>
<list class="ordered">
<ldiv>
<marker>(i)</marker>
</ldiv>
Item 1 in A
<ldiv>
<marker>(ii)</marker>
</ldiv>
Item 2 in A
<ldiv>
<marker>(iii)</marker>
</ldiv>
<text>Item 3 in A</text>
<list class="ordered">
<ldiv/>
Item 1 in B
<ldiv>
<marker>42.</marker>
</ldiv>
<text>Item 2 in B</text>
<list class="ordered">
<ldiv/>
Item 1 in C
<ldiv/>
Item 2 in C
</list>
<ldiv/>
Item 3 in B
</list>
<ldiv>
<marker>(iv)</marker>
</ldiv>
Item 4 in A
</list>
<list>
<ldiv/>
List item without parent list group
</list>
<text>The end.</text>
<picture>
<location value="5"/>
<location value="492"/>
<location value="15"/>
<location value="502"/>
<caption>Picture Caption</caption>
<description>Picture Description</description>
<summary>Picture Summary</summary>
</picture>
<picture class="chart">
<label value="pie_chart"/>
<location value="5"/>
<location value="492"/>
<location value="15"/>
<location value="502"/>
<caption>Picture Caption</caption>
<description>Picture Description</description>
<summary>Picture Summary</summary>
<tabular>
<fcel/>
Foo
<fcel/>
Bar
<nl/>
<fcel/>
One
<fcel/>
Two
<nl/>
</tabular>
</picture>
<code>0 == 0</code>
<code>
<location value="5"/>
<location value="492"/>
<location value="15"/>
<location value="502"/>
with location
</code>
</doclang>