Files
java-word-pdf/docs/standards/xls/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

40 lines
5.3 KiB
Markdown
Raw 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.
# Нормативная документация бинарного .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 (первичный источник).
```