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