This document contains a small list of know-how related to dealing with the OOXML format.
Problem: XML files must not contains xml namespace aliases starting with xml prefix.
Example: Bad alias: xml123, good alias: a123.
Solution: Use different alias names.
Problem: The Ignorable attribute must contain valid XML namespace aliases.
It is a problem because many XML processors hide the aliases after parsing the XML document.
Solution: keep track of and reuse the xml ns alias names.
See also: Requires attribute of the Choice tag.
The root node in the numbering definition must contain an Ignorable tag (which can be also empty). Needed for Word.
Problem: space symbols disappear from the document.
Solution: Use the xml:space="preserve" attribute consequently.
Problem: LibreOffice will not open an OOXML file if the relationships file contains an XML namespace alias.
Solution: Generate relationships files without XML namespace aliases (enforce the use of default XML namespace alias).
Problem: The zip entry paths mut not contain a ../ part.
+-------------+
| _rels/.rels | < this is the entry point
+-------------+
|
v
+-------------------+ +------------------------------+
| word/document.xml |===| word/_rels/document.xml.rels |
+-------------------+ +------------------------------+
| | |
v | v
+--------------------+ | +------------------+ +-----------------------------+
| word/numbering.xml | | | word/header1.xml |===| word/_rels/header1.xml.rels | * references images
+--------------------+ | +------------------+ +-----------------------------+
> shared across all v
+-----------------+
| word/styles.xml | > shared across all
+-----------------+
.rels file and main document is usually ppt/_rels/presentation.xmlslide and slideMaster and theme and notesMaster
slideLayout (and theme) pagesslideLayout pages and notesSlideslideMaster pages. Note, there is a circular reference there!NotesMasterThe master slide is the template upon which presentation slides are built. It specifies the shapes and objects as placeholders for content on presentation slides, as well as the formatting of the content within the placeholders. Of course the content and formatting specified on a master slide can be altered by layout slides and the presentation slides themselves, but absent such overrides, the master slide establishes the overall look and feel of the presentation. Source
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
┌─────────────┐
│ _rels/.rels │
└──────┬──────┘
│
▼
┌─────────────────────┐
┌───────────────────────────────┤/ppt/presentation.xml├───────────────────────────┐
│ └─────────┬───────────┘ │
│ │ │
│ ▼ │
│ ┌────────────────────────┐ │
│ │/ppt/slides/slide{N}.xml│ │
│ └─────┬──────────────────┘ │
│ │ ▲ │
│ │ │ │
│ ▼ ▼ │
│ ┌────────────────────────────────────┐ ┌─────────────────┐ │
│ │/ppt/slideLayouts/slideLayout{N}.xml│ │notesSlide{N}.xml│ │
│ └────────────────────────────────────┘ └─────┬───────────┘ │
│ ▲ │ │
│ │ │ │
│ ▼ ▼ │
│ ┌────────────────────────────────────┐ ┌──────────────────────────────────┐ │
└─►│/ppt/slideMasters/slideMaster{N}.xml│ │/ppt/notesMasters/notesMaster1.xml│◄─┤
└───────────────────────────────┬────┘ └─────┬────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌────────────┐ │
└──────►│theme{N}.xml│◄────────────────────────┤
└────────────┘ │
▲ │
│ │
┌───────┴────────────────────────────┐ │
│/handoutMasters/handoutMaster{N}.xml│◄─┘
└────────────────────────────────────┘