Skip to content

Commit d0f862e

Browse files
committed
doc: clarify image format attribute in extraction guides
- Add format field examples - Note format normalization rules - Explain when format is omitted - Update both EN and ZH guides
1 parent aebb260 commit d0f862e

2 files changed

Lines changed: 6 additions & 0 deletions

File tree

doc/doc-extraction-guide.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -54,6 +54,9 @@ The resulting `_blocks.jsonl` is the foundational input for the auditing system.
5454
- **Images**: `<drawing id="..." name="..." path="..." format="..." />`
5555
- Embedded image (`r:embed`): exported to `<blocks_stem>.image/`, `path` stores relative file path
5656
- Linked image (`r:link`): not downloaded, `path` stores original external URL
57+
- `format`: normalized image format derived from content-type/file extension, common values include
58+
`png`, `jpeg`, `emf`, `wmf`, `gif`, `bmp`, `tiff`, `webp`, `svg`
59+
- `format` is omitted when format cannot be determined or when drawing has no image blip (e.g., chart shape)
5760
- **Formulas**: OMML → LaTeX, wrapped in `<equation>...</equation>`
5861
- **Super/Subscripts**: `<sup>...</sup>` / `<sub>...</sub>`
5962

doc/docx-extraction-guide-zh.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -54,6 +54,9 @@
5454
- **图片**`<drawing id="..." name="..." path="..." format="..." />`
5555
- 内嵌图片(`r:embed`):导出到 `<blocks_stem>.image/``path` 写相对路径
5656
- 外链图片(`r:link`):不下载,`path` 写原始外链 URL
57+
- `format`:由 content-type/文件扩展名归一化得到,常见取值包括
58+
`png``jpeg``emf``wmf``gif``bmp``tiff``webp``svg`
59+
- 若无法判定格式,或该 drawing 不包含图片 blip(如图表形状),则省略 `format` 属性
5760
- **公式**:OMML → LaTeX,包裹 `<equation>...</equation>`
5861
- **上下标**`<sup>...</sup>` / `<sub>...</sub>`
5962

0 commit comments

Comments
 (0)