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
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:
@@ -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
Reference in New Issue
Block a user