Документация формата .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/):
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]).