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