# Документация формата .docx в этом репозитории Здесь — только специфика WordprocessingML-пайплайна этого репозитория: нормативная база OOXML (ECMA-376 Part 1 §17, XSD `wml.xsd`, комментарии Word [MS-OI29500], расширения [MS-ODRAWXML]) живёт в `../ooxml/README.md` — там же таблицы «Источники» с SHA и команды регенерации. Нормативная база моста .doc — `../doc/README.md` + `../binary/README.md`. ### Источники |Файл|Документ|Редакция/дата|URL|SHA-256| |---|---|---|---|---| |`validate-fixtures.py`|Валидатор `.docx`-фикстур (lxml + переходные XSD из `../ooxml/schema/transitional/`)|—|—|—| ### Что где искать - **Нормативная разметка .docx** (`w:r`/`w:t`, таблицы §17.4, `w:position` §17.3.2.24, `mc:AlternateContent` §15.2.15, `xml:space` §5.1.2) — `../ooxml/ecma376-part1-5th.md` и `../ooxml/schema/transitional/wml.xsd`; поведение Word — `../ooxml/ms-oi29500.md`. - **Диаграммы/SmartArt/пресет-геометрия** — `../ooxml/README.md` (§21.2/§21.3/§21.4, Annex D). - **Валидация фикстур** — см. ниже. ### Валидация фикстур `samples/*.docx` обязаны быть ECMA-conformant (фикстуры — источник истины по входу, код под них не подгоняется). Проверка — `docx/validate-fixtures.py` (lxml + схемы `../ooxml/schema/transitional/`): ```bash python3 docs/standards/docx/validate-fixtures.py wordpdf-core/src/test/resources/samples/*.docx ``` Допущения валидатора (оба по Part 1): `xml:space` — предопределённый атрибут §5.1.2, схемам подмешивается импорт XML-namespace; `mc:AlternateContent`/ `mc:Ignorable` (§15.2.15) — валидируется Fallback-ветка, атрибуты и элементы ignorable-namespace'ов снимаются. Не маппятся (вне ECMA, осознанно): `word/charts/style*.xml`/`colors*.xml` (c14/chartStyle, MS-расширение), `word/diagrams/drawing*.xml` (`dsp:`, [MS-ODRAWXML]).