docs(standards): restructure into ooxml/binary, add MS-XLS/MS-XLSX for .xls/.xlsx
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

This commit was merged in pull request #89.
This commit is contained in:
Pjandro
2026-11-02 22:21:23 +00:00
parent de9995bba3
commit eabc2b0e0d
76 changed files with 196584 additions and 93 deletions
+32
View File
@@ -0,0 +1,32 @@
# Нормативная документация формата .xlsx (Excel OOXML)
Справочный комплект формата .xlsx: база — ECMA-376 Part 1 §18 SpreadsheetML (лежит в `../ooxml/`), расширения Excel — [MS-XLSX] (здесь). В конвертере поддержки .xlsx нет — комплект справочный (вход конвертера: `.docx`/`.doc`). Документация OOXML и XSD — `../ooxml/README.md`, бинарный .xls — `../xls/README.md`, общее OLE2-окружение — `../binary/README.md`.
SHA-256 `.md`-файлов — справочные: они производные от инструментов извлечения (pandoc), при регенерации другим инструментом могут измениться; первичен docx в таблице «Источники».
### Источники
|Файл|Документ|Редакция/дата|URL|SHA-256|
|---|---|---|---|---|
|`ms-xlsx.md`|[MS-XLSX] «Excel (.xlsx) Extensions to the Office Open XML SpreadsheetML File Format» — расширения Excel к SpreadsheetML (Excel-namespace `…/office/excel/2006/main`, slicers/timelines/data model, metadata)|30.0 (261016, октябрь 2026)|https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-XLSX/%5bMS-XLSX%5d-261016.docx|`98542cb9a3037734cede02dcc1f333061297eaf85e7fa8f6f01f51b21f50d226`|
|`ms-xlsx.docx`|Оригинальный dated-.docx [MS-XLSX] 30.0 (первичный источник `.md`-конверта)|30.0 (261016)|тот же URL, что `ms-xlsx.md`|`239652cea96fbae721fbbdedf2758b0a13b797136b41731241d023e848b7867c`|
Конверт сделан `-t gfm` (raw_html включён): packet diagram'ов в документе нет (XML-расширения), все таблицы сохранены без `[TABLE]`-плейсхолдеров — отдельный «full»-файл не нужен.
### Что где искать
- **Разметка .xlsx (база)** — ECMA-376 §18 в `../ooxml/ecma376-part1-5th.md`: §18.2 Workbook (`workbook.xml`), §18.3 Worksheet (`xl/worksheets/sheet*.xml`, ран-ячейки `is` §18.3.1.53), §18.4 Styles, §18.5 Shared String Table, §18.6 Drawings; схемы — `../ooxml/schema/transitional/sml.xsd`, `dml-spreadsheetDrawing.xsd`. Поиск: `grep -n "^18\.3\.1" ../ooxml/ecma376-part1-5th.md`.
- **Расширения Excel ([MS-XLSX])** — `ms-xlsx.md`: §2.1 Part Enumerations (какие части бывают: slicers, timelines, customXml, metadata…), §2.2 Extensions (элементы/атрибуты Excel-namespace по частям), §2.3 Conceptual Overview (slicer/data model/timeline-семантика), §2.4 Global Elements / §2.5 Global Attributes / §2.6 Complex Types / §2.7 Simple Types (полные определения), §3 Structure Examples (например Slicer); полные XSD расширений — Appendix A («Full XML Schema» — по namespace: `…/excel/2006/main`, `…/drawing/2010/slicer`, `…/spreadsheetml/2010/11/main`…).
- **Поведение Excel (что он реально пишет)** — `../ooxml/ms-oi29500.md` (комментарии и к SpreadsheetML в т.ч.); расширения чартов/рисунков — `../ooxml/ms-odrawxml.md`.
- **Поиск по номерам секций** — по строкам оглавления вида `[2.2 Extensions …]`: `grep -n "^\[2\.2 " ms-xlsx.md`.
### Регенерация
```bash
# ms-xlsx.md — свежий dated-.docx [MS-XLSX] с лендинга
# https://learn.microsoft.com/en-us/openspecs/office_standards/ms-xlsx/2c5dee00-eff2-4b22-92b6-0738acd4475e
curl -sSL -o /tmp/msxlsx.docx "https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-XLSX/%5bMS-XLSX%5d-261016.docx"
pandoc /tmp/msxlsx.docx -t gfm --wrap=none -o docs/standards/xlsx/ms-xlsx.md
# Обновлённый dated-.docx при этом перекладывается в ms-xlsx.docx (первичный источник).
```