Files
java-word-pdf/docs/standards/docx/README.md
T
Pjandro eabc2b0e0d
PR checks / web (pull_request) Successful in 38s
PR checks / java (pull_request) Successful in 1m31s
Main: tests, deploy, autotests / web (push) Successful in 33s
Main: tests, deploy, autotests / java (push) Successful in 1m7s
Main: tests, deploy, autotests / images-web (push) Successful in 32s
Main: tests, deploy, autotests / images-app (push) Successful in 43s
Main: tests, deploy, autotests / deploy (push) Failing after 2m55s
Main: tests, deploy, autotests / autotests (push) Has been skipped
Main: tests, deploy, autotests / rollback (push) Failing after 3m4s
docs(standards): restructure into ooxml/binary, add MS-XLS/MS-XLSX for .xls/.xlsx
2026-11-02 22:21:23 +00:00

2.3 KiB

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