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
..

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