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
+39
View File
@@ -0,0 +1,39 @@
# Нормативная документация бинарного .xls (Excel 97–2003)
Справочный комплект формата бинарного .xls: [MS-XLS] — источник истины по структуре `Workbook`-потока и BIFF8-записям (BOF/EOF, SST, XF, формулы, листы). В конвертере поддержки .xls нет — комплект справочный (вход конвертера: `.docx`/`.doc`). Общее OLE2-окружение (CFB-контейнер, property sets, OfficeArt, шифрование, VBA, метафайлы, общие типы MS-OSHARED) — `../binary/README.md`; документация OOXML — `../ooxml/README.md`, SpreadsheetML-расширения Excel — `../xlsx/README.md`.
SHA-256 `.md`-файлов — справочные: они производные от инструментов извлечения (pandoc), при регенерации другим инструментом могут измениться; первичен docx в таблице «Источники».
Метка `[TABLE]` в `.md` — таблицы битовых макетов (packet diagram) со span-ячейками: конверсионная команда `-t gfm-raw_html` отключает HTML-fallback pandoc, и такие таблицы не выразимы в GFM; все поля описаны текстом сразу за плейсхолдером (одинаково в обоих файлах, включая `ms-xls.md`).
### Источники
|Файл|Документ|Редакция/дата|URL|SHA-256|
|---|---|---|---|---|
|`ms-xls.md`|[MS-XLS] «Excel (.xls) Binary File Format» — бинарный формат .xls Excel 97–2003 (BIFF8-записи: BOF/EOF, SST, XF,_formulae_, листы)|12.2 (250819, август 2025)|https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-XLS/%5bMS-XLS%5d-250819.docx|`37cec6eebd7ec85e002b7d46af76e1da15a5b664448902126d1dfe4f0444f011`|
|`ms-xls-full.md`|Тот же [MS-XLS] 12.2, полный конверт **с** HTML-packet-diagram'ами (`-t gfm`, raw_html включён): битовые макеты записей §2.4 и структур §2.5 — то, что в `ms-xls.md` свёрнуто в `[TABLE]`|12.2 (250819, август 2025)|тот же dated-.docx, что `ms-xls.md`|`c2ac10623879e8ea73ccbdb75e0889ad18425ac7172d0087835f3e94b38937ab`|
|`ms-xls.docx`|Оригинальный dated-.docx [MS-XLS] 12.2 (первичный источник двух `.md`-конвертов)|12.2 (250819)|тот же URL, что `ms-xls.md`|`66800e9bdfae1eec8e462c2e2d6411f56f2592f79a0b980de00df1e7bf2210b2`|
### Что где искать
- **Структура файла** — `ms-xls.md`: §2.1 File Structure (контейнер CFB §2.1.1, потоки/подпотоки/записи §2.1.2–2.1.5, хранилища и потоки §2.1.7: `Workbook`-поток §2.1.7.20, `encryption` §2.1.7.6, VBA-хранилище §2.1.7.18, `\_VBA`/`Ctls`/`CompObj`…); концептуальный обзор — §2.2 Conceptual Overview (грамматики `WORKBOOK = BOF WORKBOOKCONTENT …`).
- **Записи BIFF8** — `ms-xls.md`: §2.3 Record Enumeration (номер записи → секция) и §2.4 Records (каждая запись — своя секция: BOF §2.4.21, EOF §2.4.103, SST §2.4.265, …); битовые макеты — packet diagram'ы (в `ms-xls.md` свёрнуты в `[TABLE]`, живые — в `ms-xls-full.md`).
- **Вспомогательные структуры** — §2.5 Structures (XLNAME, XLOPERTABLE, SORTDATA…), §2.6 XCB Structures, §2.7 Algorithms.
- **Примеры байтовых раскладок** — §3 Structure Examples (например §3.9 Workbook: BOF 1… — реальные дампы Workbook-потока).
- **Поиск по номерам секций** — по строкам оглавления вида `[2.4.21 BOF …]` (заголовки в теле без номеров — автонумерация Word потерялась при извлечении): `grep -n "^\[2\.4\.21 " ms-xls.md`.
- **Контейнер, метаданные, шифрование, картинки, макросы** — общие документы в `../binary/` (CFB, MS-OLEPS, MS-OFFCRYPTO §2.3.5, MS-ODRAW, MS-OVBA, MS-WMF/MS-EMF); общие типы цитируемые MS-XLS — MS-OSHARED там же.
### Регенерация
```bash
# ms-xls.md — свежий dated-.docx [MS-XLS] с лендинга
# https://learn.microsoft.com/en-us/openspecs/office_file_formats/ms-xls/cd03cb5f-ca02-4934-a391-bb674cb8aa06
curl -sSL -o /tmp/msxls.docx "https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-XLS/%5bMS-XLS%5d-250819.docx"
pandoc /tmp/msxls.docx -t gfm-raw_html --wrap=none -o docs/standards/xls/ms-xls.md
# ms-xls-full.md — тот же dated-.docx, но raw_html ВКЛЮЧЁН: packet diagram'ы
# записей (§2.4) остаются HTML-таблицами вместо [TABLE]-плейсхолдеров.
pandoc /tmp/msxls.docx -t gfm --wrap=none -o docs/standards/xls/ms-xls-full.md
# Обновлённый dated-.docx при этом перекладывается в ms-xls.docx (первичный источник).
```
File diff suppressed because it is too large Load Diff
Binary file not shown.
File diff suppressed because it is too large Load Diff