pptx-slide-specification

PPTX スライド仕様

最終的な座標は layout_tree に直接記述してください。監査後に、レンダラーが配置を決定したり、テキストを縮小したり、レイアウトを推測したりしてはなりません。

必須のコントラクト

• ルート JSON には summary と slides が含まれます。
• すべてのスライドには、安定した id、メッセージを主導する title、アクセシビリティの読み上げ順序、および完全な layout_tree があります。
• レイアウトツリーは、スライドサイズ、ルートグループ、ID をキーとするグループとオブジェクト、最終的なインチ単位の bbox、スタイル、z-index、および分類を宣言します。
• 意味のあるすべてのオブジェクトには、id、kind、role、classification、content、style、bbox、および z_index があります。
• 本番の summary には、明示的な layout_policy(安全マージン、コンテンツ下端、フッター上端、最小間隔)とアクセシビリティメタデータが含まれます。

作成ルール

1. 安定した読みやすい ID、絶対グループ、正のインチ寸法を使用してください。
2. 通常のコンテンツは安全マージン内かつフッターレールより上に保ってください。背景の layout_design オブジェクトのみがフルブリードを許可されます。
3. ネイティブの text、shape、line、table、image オブジェクトを使用してください。補助的なビジュアルからのラベルや値は、ネイティブオブジェクトとして再作成してください。
4. 意味のある画像には代替テキストを付けてください。出典のある主張には source_ref を記録してください。密なコンテンツは、文字サイズを小さくする前に、切り詰める、サイズを変更する、または分割してください。
5. 共有グリッド、一貫した間隔、明示的な色、明示的なフォントサイズ、意図的な z オーダーを使用してください。

ビルドコントラクト

タスクローカルのビルダーは、空白のスライドレイアウトから開始し、すべての bbox を Inches(...) でマッピングします。折り返し、自動サイズ変更の無効化、テキストインセット、アンカー、配置、フォント、色、線の設定、画像のアスペクト比、および非表示スライドの状態を明示的に設定してください。オブジェクトを追加する前に、ゼロまたは負のジオメトリを拒否してください。

コンパクトなスキーマと修正のガイダンスについては、references/layout-contract.md を参照してください。