Files
Pjandro c920cac7bf
PR checks / web (pull_request) Successful in 40s
PR checks / java (pull_request) Successful in 1m35s
Main: tests, deploy, autotests / web (push) Successful in 32s
Main: tests, deploy, autotests / java (push) Successful in 1m9s
Main: tests, deploy, autotests / images-web (push) Successful in 30s
Main: tests, deploy, autotests / images-app (push) Successful in 48s
Main: tests, deploy, autotests / deploy (push) Failing after 2m42s
Main: tests, deploy, autotests / autotests (push) Has been skipped
Main: tests, deploy, autotests / rollback (push) Failing after 2m37s
docs(standards): [MS-PPT] для .ppt + навигатор PresentationML для .pptx
2026-11-02 22:48:21 +00:00

36 lines
7.1 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.
# Нормативная документация бинарного .ppt (PowerPoint 97–2003)
Справочный комплект формата бинарного .ppt: [MS-PPT] — источник истины по потокам CFB-файла и записям `PowerPoint Document`-потока (RecordHeader, persist-объекты, документ/слайды/шейпы/анимация/текст). В конвертере поддержки .ppt нет — комплект справочный (вход конвертера: `.docx`/`.doc`). Общее OLE2-окружение (CFB-контейнер, property sets, OfficeArt, шифрование, VBA, метафайлы, общие типы MS-OSHARED) — `../binary/README.md`; документация OOXML — `../ooxml/README.md`; PresentationML (.pptx) — `../pptx/README.md`.
SHA-256 `.md`-файлов — справочные: они производные от инструментов извлечения (pandoc), при регенерации другим инструментом могут измениться; первичен docx в таблице «Источники».
Конверт сделан `-t gfm` (**raw_html включён**): битовые макеты записей (packet diagram'ы — RecordHeader §2.3.1 и т. п.) в [MS-PPT] есть, но здесь они сохранены инлайновыми HTML-таблицами (425 штук), которые GitHub рендерит; при `-t gfm-raw_html` те же 425 таблиц сворачиваются в плейсхолдеры `[TABLE]`, поэтому вариант с выключенным raw_html не используется. Отдельный «full»-файл, как у [MS-DOC]/[MS-XLS], не нужен — поля всех макетов уже в `ms-ppt.md`.
### Источники
|Файл|Документ|Редакция/дата|URL|SHA-256|
|---|---|---|---|---|
|`ms-ppt.md`|[MS-PPT] «PowerPoint (.ppt) Binary File Format» — бинарный формат .ppt PowerPoint 97–2003 (потоки Current User / PowerPoint Document / Pictures; записи: DocumentContainer, persist-объекты, слайды, шейпы, анимация, текст)|10.1 (241112, ноябрь 2024)|https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-PPT/%5bMS-PPT%5d-241112.docx|`32c90b18077b345b8554928290b7d853c05db605c8950e12403afd1f3d5d835d`|
|`ms-ppt.docx`|Оригинальный dated-.docx [MS-PPT] 10.1 (первичный источник `.md`-конверта)|10.1 (241112)|тот же URL, что `ms-ppt.md`|`776798ab869049330e625a39a15e2e5cad036149c1bc813673b86be0f5fd7f6c`|
Недейтед `[MS-PPT].docx` на CDN отсутствует (404, есть только недейтед-PDF на 26 МБ) — брать только dated-.docx из таблицы «Published Version» лендинга. `[MS-PPTSB]` (слайд-деки старых PowerPoint) Microsoft сняла с публикации — лендинг и CDN отдают 404, в комплект не входит.
### Что где искать
- **Структура файла** — `ms-ppt.md`: §2.1 File Streams and Storages — потоки и хранилища CFB: §2.1.1 Current User Stream (имя `Current User`, обязательный, единственная запись CurrentUserAtom), §2.1.2 PowerPoint Document Stream (имя `PowerPoint Document`, обязательный — основной поток записей), §2.1.3 Pictures Stream (имя `Pictures`, опциональный — содержимое задаётся записью OfficeArtBStoreDelay, [MS-ODRAW]), §2.1.4 Summary Information Stream (имя `\005SummaryInformation`) и §2.1.5 Document Summary Information Stream (имя `\005DocumentSummaryInformation`) — property sets по [MS-OSHARED] §2.3.3.2.1/§2.3.3.2.2, §2.1.6 Encrypted Summary Information Stream (имя `EncryptedSummary`, только шифрованный документ — [MS-OFFCRYPTO] §2.3.5.4), §2.1.7 Digital Signature Storage. Контейнер — тот же OLE2/CFB, что у .doc/.xls (`../binary/ms-cfb.md` §2.2).
- **Типы записей по назначению** — `ms-ppt.md`: §2.2 Basic Types (BlipRef §2.2.1, bool1/char2, PersistIdRef §2.2.21, SlideId/SlideIdRef §2.2.24/.25, PrintableAnsiString/PrintableUnicodeString §2.2.22/.23…), §2.3 File Structure Types (RecordHeader §2.3.1 — `rh.recType`/`rh.recInstance`/`rh.recLen`, CurrentUserAtom §2.3.2, UserEditAtom §2.3.3, persist-таблица PersistDirectoryAtom §2.3.4 с PersistDirectoryEntry §2.3.5 и PersistOffsetEntry §2.3.6, CryptSession10Container §2.3.7), §2.4 Document Types (корень дерева — DocumentContainer §2.4.1), §2.5 Slide Types (SlideContainer §2.5.1, MainMasterContainer §2.5.3, RoundTrip*-записи), §2.6 Slide Show Types, §2.7 Shape Types (шейпы, группы, таблицы), §2.8 Animation Types, §2.9 Text Types (TextHeaderAtom §2.9.41, TextCharsAtom §2.9.42 / TextBytesAtom §2.9.43, StyleTextPropAtom §2.9.44 с TextPFRun §2.9.45 и TextCFRun §2.9.46), §2.10 External Object Types (OLE-объекты, ссылки на картинки), §2.11 Other Types, §2.12 Common Structures, §2.13 Enumerations (в т.ч. §2.13.24 RecordType — полная таблица `RT_*` → имя записи; на неё ссылается каждое поле `rh.recType`).
- **Как читается файл на практике** — §3 Structure Examples: §3.2 File Structure (CFB + потоки + persist-разрешение offset'ов), §3.3 Persist Objects, §3.5 Slides, §3.9 Text; §4 Security Considerations; §5 Appendix A: Product Behavior (что пишет PowerPoint разных версий); §6 Change Tracking (история редакций).
- **Поиск по номеру секции** — заголовки в теле без номеров, но названы именем типа, а оглавление даёт пару «номер → якорь»: `grep -n "^\[2\.9\.42 " ms-ppt.md` → `[2.9.42 TextCharsAtom [373](#textcharsatom)]`, дальше тело — `grep -n "^#\+ TextCharsAtom" ms-ppt.md` (якорь = lowercase имя типа). По имени записи можно сразу в тело: `grep -n "^#\+ StyleTextPropAtom" ms-ppt.md`. Поля записей — таблицы вида `| **rh.recType** | MUST be an [RT_TextCharsAtom](#recordtype). |`.
### Регенерация
```bash
# ms-ppt.md — свежий dated-.docx [MS-PPT] с лендинга
# https://learn.microsoft.com/en-us/openspecs/office_file_formats/ms-ppt/6be79dde-33c1-4c1b-8ccc-4b2301c08662
# (самый свежий dated-.docx — в таблице «Published Version»; недейтед .docx на CDN нет)
curl -sSL -o /tmp/ms-ppt.docx "https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-PPT/%5bMS-PPT%5d-241112.docx"
pandoc /tmp/ms-ppt.docx -t gfm --wrap=none -o docs/standards/ppt/ms-ppt.md
# Обновлённый dated-.docx при этом перекладывается в ms-ppt.docx (первичный источник).
```