try again from first principles

erdos · May 14, 2024 · 88f5bea · 88f5bea
1 parent 9246967
commit 88f5bea
Show file tree

Hide file tree

Showing 2 changed files with 47 additions and 3 deletions.
diff --git a/docs/DeveloperTroubleshooting.md b/docs/DeveloperTroubleshooting.md
@@ -80,5 +80,39 @@ Problem: The zip entry paths mut not contain a `../` part.
                                         +-----------------+
                                         | word/styles.xml | > shared across all
                                         +-----------------+
-
 ```
+
+## OOXML Presentation Model
+
+- Entry point is the same `.rels` file and main document is usually `ppt/_rels/presentation.xml`
+- Main document references both `slide` and `slideMaster` and `theme`
+  - SlideMaster references `slideLayout` (and `theme`) pages
+  - Slide references `slideLayout` pages
+  - Theme page has no references
+- SlideLayout references SlideMaster pages
+  - circular reference there!
+
+```                                                                                                         
++-------------+                                                                                             
+| _rels/.rels | < this is the entry point                                                                   
++-------------+                                                                                             
+       |                                         ┌───────────────► /ppt/presProps.xml                       
+       v                                         │                                                          
+┌─────────────────────┐                          │                                                          
+│/ppt/presentation.xml├─────┬────────┬────────┬──┴───────────────► /ppt/theme/theme1.xml                    
+└─────────────────────┘     │        │        │                         ▲                                   
+                            │        │        ▼                         │                                   
+                            │        │     ┌────────────────────────────┴─────┐                             
+                            │        │     │/ppt/slideMasters/slideMaster1.xml├────────┐                    
+                            │        │     └──────────────────────────────────┘        │                    
+                            │        ▼                                ▲                │                    
+                            │   ┌──────────────────────────────────┐  │                ▼                    
+                            │   │/ppt/slideMasters/slideMaster2.xml│  │ ┌──────────────────────────────────┐
+                            │   └──────────────────────────────────┘  └─┤/ppt/slideLayouts/slideLayout1.xml│
+                            ▼                                           └──────────────────────────────────┘
+                       ┌──────────────────────┐                                        ▲                    
+                       │/ppt/slides/slide1.xml├────────────────────────────────────────┘                    
+                       ├──────────────────────┤                                                             
+                       │/ppt/slides/slide2.xml│                                                             
+                       └──────────────────────┘                                                             
+```
diff --git a/src/stencil/model/relations.clj b/src/stencil/model/relations.clj
@@ -31,12 +31,22 @@
 (def rel-type-header
   "http://schemas.openxmlformats.org/officeDocument/2006/relationships/header")
 
+;; PPTX
+
 (def rel-type-slide
   "http://schemas.openxmlformats.org/officeDocument/2006/relationships/slide")
 
-(def extra-relations
-  #{rel-type-footer rel-type-header rel-type-slide})
+(def rel-type-slide-master
+  "http://schemas.openxmlformats.org/officeDocument/2006/relationships/slideMaster")
+
+(def rel-type-slide-layout
+  "http://schemas.openxmlformats.org/officeDocument/2006/relationships/slideLayout")
 
+(def rel-type-theme
+  "http://schemas.openxmlformats.org/officeDocument/2006/relationships/theme")
+
+(def extra-relations
+  #{rel-type-footer rel-type-header rel-type-slide rel-type-slide-master})
 
 (defn- parse [rel-file]
   (with-open [reader (io/input-stream (file rel-file))]