Skip to content

Commit

Permalink
describe Notes slides
Browse files Browse the repository at this point in the history
  • Loading branch information
@erdos
erdos committed May 16, 2024
1 parent 80a19e5 commit 3affec0
Showing 1 changed file with 31 additions and 25 deletions.
56 changes: 31 additions & 25 deletions docs/DeveloperTroubleshooting.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -85,11 +85,13 @@ Problem: The zip entry paths mut not contain a `../` part.
## 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`
- Main document references both `slide` and `slideMaster` and `theme` and `notesMaster`
- SlideMaster references `slideLayout` (and `theme`) pages
- Slide references `slideLayout` pages
- Slide references `slideLayout` pages and `notesSlide`
- Theme page has no references
- SlideLayout references `slideMaster` pages. Note, there is a circular reference there!
- NotesSlide references `NotesMaster`
- NotesMaster references back to Theme.

### SlideMaster

Expand All @@ -100,27 +102,31 @@ Problem: The zip entry paths mut not contain a `../` part.
> A slide layout is essentially a template design which can be applied to one or more slides, defining the default appearance and positioning of objects on the slide. It "sits" on top of the master slide, acting as an override to alter or supplement information provided on the master slide. When applied to a slide, all corresponding content within objects on the slide is mapped to the slide layout placeholders. [Source](http://officeopenxml.com/prSlideLayout.php)

```
+-------------+
| _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│
└──────────────────────┘
```
+-------------+ ┌──────────────────────────────┐
| _rels/.rels | < this is the entry point ▼ │
+-------------+ ┌──────────────────────────────────┐ │
| ┌──────────────────► │/ppt/notesMasters/notesMaster1.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│ │ │ ┌───────────────┐ │
│ └──────────────────────┘ │ └────────────►│notesSlide1.xml├───────┘
▼ │ └──────┬────────┘
│ │
► /ppt/presProps.xml │ │
└────────────────────────────────────────────┘
```

0 comments on commit 3affec0

Please sign in to comment.