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.xml
slide
and slideMaster
and theme
and notesMaster
slideLayout
(and theme
) pagesslideLayout
pages and notesSlide
slideMaster
pages. Note, there is a circular reference there!NotesMaster
The 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│◄─┘
└────────────────────────────────────┘
Can you improve this documentation?Edit on GitHub
cljdoc is a website building & hosting documentation for Clojure/Script libraries
× close