Files
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

33 lines
4.0 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Нормативная документация формата .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 (первичный источник).
```