Стандарты OOXML в docs/standards: ECMA-376 Part 1 md, MS-OI29500/ODRAWXML, XSD + правило ECMA в AGENTS.md
This commit is contained in:
File diff suppressed because one or more lines are too long
@@ -0,0 +1,48 @@
|
||||
# Нормативная документация OOXML
|
||||
|
||||
Источник истины для chart-движка (`wordpdf-core/.../internal/chart/`) и нормализаторов: любые правки диаграмм/SmartArt/представления docx — по документам ниже, а не по догадкам. Правило закреплено в `AGENTS.md` (секция «Chart-движок»).
|
||||
|
||||
## Источники
|
||||
|
||||
|Файл|Документ|Редакция/дата|URL|SHA-256|
|
||||
|---|---|---|---|---|
|
||||
|`ECMA-376-1_5th_edition_december_2016.pdf`|ECMA-376 Part 1 «Fundamentals and Markup Language Reference»|5-е изд., декабрь 2016|https://ecma-international.org/wp-content/uploads/ECMA-376-1_5th_edition_december_2016.pdf|`7cccfd0ad0e2ef89316acece15e44a8a088d0603ce4bba4e7b0361b50d13a37d`|
|
||||
|`ecma376-part1-5th.md`|Тот же текст, извлечённый из PDF (поиск по номерам секций)|5-е изд.|производный (см. регенерацию)|`86af445c080d9a481eaa426fc1721d50a1c4eff875535f9d03fe93d2b95b21b6`|
|
||||
|`ms-oi29500.md`|[MS-OI29500] «Office Implementation Information for ISO/IEC-29500 Standards» — как Word реально пишет docx (§2.1 — комментарий к Part 1, §3.1 — к Part 4)|260818 (август 2026)|https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-OI29500/%5bMS-OI29500%5d-260818.docx|`3e3eabb060a3772d096f001e7fee682fc4be12a2dd55ea360430fff14dd5845d`|
|
||||
|`ms-odrawxml.md`|[MS-ODRAWXML] «Office Drawing Extensions to Office Open XML» — расширения Word/Excel для чартов (ChartEx, стили/цвета)|261006 (октябрь 2026)|https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-ODRAWXML/%5bMS-ODRAWXML%5d-261006.docx|`f5a2517c4984b2ba2f0ade504bd0c9660c74f619290910a9b491c0f2ca9db64a`|
|
||||
|`schema/dml-chart.xsd`|XSD DrawingML Charts (`c:`-пространство имён)|5-е изд.|вложенный `OfficeOpenXML-XMLSchema-Strict.zip` в ECMA-архиве выше|`189b9631129a7d6c9f971b42b94c8942d260f11f81615f427db059bbf442cdc3`|
|
||||
|`schema/dml-diagram.xsd`|XSD DrawingML Diagrams (`dgm:`)|5-е изд.|там же|`179cd2fa4b981e1e2faa9ce99bb18c5d4d896dc1edb144af50f5cc8c52eb8569`|
|
||||
|`schema/dml-main.xsd`|XSD DrawingML Main (`a:`, пресет-геометрия — типы)|5-е изд.|там же|`078871240cff323ddd22a395281421b737fa61508fd39ffaa2947ba2bc01175e`|
|
||||
|
||||
SHA-256 `.md`-файлов — справочные: они производные от инструментов извлечения (poppler/pandoc), при регенерации другим инструментом могут измениться; первичен PDF/docx выше.
|
||||
|
||||
## Что где искать
|
||||
|
||||
- **Диаграммы (`c:chart`)** — ECMA-376 §21.2 (`grep -n "^21.2" ecma376-part1-5th.md`; каждый элемент — секция вида `21.2.2.132 overlay (Overlay)`) + `schema/dml-chart.xsd`; расширения Word — `ms-odrawxml.md`.
|
||||
- **Диаграммы-схемы SmartArt (`dgm:`)** — ECMA-376 §21.4 + `schema/dml-diagram.xsd`. Кэш разложенной схемы (`word/diagrams/drawing1.xml`, relationship `…/office/2007/relationships/diagramDrawing`) — проприетарный MS-формат, нормативного XSD нет; authoritative источник фактической геометрии — сам `dsp:drawing`.
|
||||
- **Пресет-геометрия (`a:prstGeom`)** — ECMA-376 Annex D; машинная копия таблицы пресетов — `wordpdf-core/src/test/resources/geom/presetShapeDefinitions.xml` (синхрон пинит `PresetGeometryTest#tableMatchesEcmaXml`).
|
||||
- **Chart Drawings (`c:drawing`)** — ECMA-376 §21.3.
|
||||
- **Поведение Word (что он реально пишет в `w:r`/`w:t`/`lastRenderedPageBreak`, текстбоксы, чарты)** — `ms-oi29500.md` (указатели на секции Part 1, напр. §2.17.3.3.13 → Part 1 §17.3.3.13).
|
||||
|
||||
## Регенерация
|
||||
|
||||
```bash
|
||||
# ecma376-part1-5th.md — из PDF в репозитории (постобработка: выбросить строки
|
||||
# `^\s*\d{1,4}\s*$` (номера страниц), `^ECMA-376 Part 1\s*$` (колонтитул),
|
||||
# строки с `.....` (точки оглавления); остальной текст — как есть)
|
||||
pdftotext -layout docs/standards/ECMA-376-1_5th_edition_december_2016.pdf /tmp/p1.txt
|
||||
|
||||
# ms-oi29500.md / ms-odrawxml.md — свежие dated-.docx с learn.microsoft.com
|
||||
# (при 404 — самый свежий .docx со страниц лендингов:
|
||||
# https://learn.microsoft.com/en-us/openspecs/office_standards/ms-oi29500/1fd4a662-8623-49c0-82f0-18fa91b413b8
|
||||
# https://learn.microsoft.com/en-us/openspecs/office_standards/ms-odrawxml/06cff208-c6e1-4db7-bb68-665135e5f0de)
|
||||
curl -sSL -o /tmp/oi29500.docx "https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-OI29500/%5bMS-OI29500%5d-260818.docx"
|
||||
curl -sSL -o /tmp/odrawxml.docx "https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-ODRAWXML/%5bMS-ODRAWXML%5d-261006.docx"
|
||||
pandoc /tmp/oi29500.docx -t gfm-raw_html --wrap=none -o docs/standards/ms-oi29500.md
|
||||
pandoc /tmp/odrawxml.docx -t gfm-raw_html --wrap=none -o docs/standards/ms-odrawxml.md
|
||||
|
||||
# schema/*.xsd — из официального ECMA-архива
|
||||
curl -sSL -o /tmp/p1.zip "https://ecma-international.org/wp-content/uploads/ECMA-376-1_5th_edition_december_2016.zip"
|
||||
unzip -o /tmp/p1.zip "OfficeOpenXML-XMLSchema-Strict.zip" -d /tmp/
|
||||
unzip -o /tmp/OfficeOpenXML-XMLSchema-Strict.zip dml-chart.xsd dml-diagram.xsd dml-main.xsd -d docs/standards/schema/
|
||||
```
|
||||
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
File diff suppressed because one or more lines are too long
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
Reference in New Issue
Block a user