Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 4 additions & 1 deletion content/command-line/theme.md
Original file line number Diff line number Diff line change
Expand Up @@ -83,6 +83,9 @@ read is a failure here rather than a theme nobody can use.
from the deck's slides where it is not. A deck made in a tool that does not do themes carries
Office's palette without ever drawing in it, and that palette describes nothing on the page.

**The page** is the deck's master — the page behind every slide that does not paint itself — and
where the master names no colour of its own, the slides answer for it.

**The type scale** is read off the deck's text, because a deck records a size for every
paragraph rather than a scale. The title is the size most slides are headed in, the cover the
largest type on the first slide, the body the size the prose is written at, and the heading
Expand Down Expand Up @@ -113,7 +116,7 @@ mdoffice theme: wrote the theme for "probe.pptx" into "/tmp/probe-theme".
template.pptx the deck's 3 layouts, without its 2 slides

colours
dk1 #0D1B2A the background of the slides
dk1 #0D1B2A the deck's master
lt1 #F8FAFC the type
accent1 #00B4D8 the colour the deck draws with
hlink #00B4D8 the accent, as a link is drawn
Expand Down
8 changes: 5 additions & 3 deletions content/presentation/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -230,7 +230,7 @@ echo (new PowerPointToMarkdown('deck.pptx', new Options(mediaDirectory: null)))-

```text
---
title: "Untitled Presentation"
title: "One"
author: "markdown-office"
---

Expand All @@ -240,8 +240,10 @@ Text.
```

The frontmatter carries what the deck said about itself — its title, its theme, its author and
its description — because a deck's own properties are the only thing about it that is not on a
slide. `save()` writes it to a file instead, and `read()` gives the slides back as a list.
its description. The title is the deck's own where it has one, and the first slide's where it
has not: PHPPresentation gives every deck the title `Untitled Presentation`, and that is its
own default rather than a title somebody wrote. `save()` writes it to a file instead, and
`read()` gives the slides back as a list.

**The theme's name comes back; the theme does not.** The name travels into the `.pptx` and comes
back out of it, so a deck read back into Markdown is drawn again in the theme it was drawn in.
Expand Down
1 change: 1 addition & 0 deletions tools/check-command-line.php
Original file line number Diff line number Diff line change
Expand Up @@ -86,6 +86,7 @@
'the themes page counted the colour aliases wrongly in capitals' => 'Four read-friendly aliases are accepted',
'the themes page counted the style keys wrongly' => 'the thirteen style keys',
'the themes page found a theme under the working directory' => '`<workingDirectory>/themes/<name>`',
'the theme page said the page of a deck came from its slides' => '#0D1B2A the background of the slides',
'the presentation page listed the layout roles twice' => 'The eight layout roles:',
'the frontmatter table named a number of roles' => 'one of eight roles',
'the presentation page said one exception sat beside InvalidInput' => 'One sits beside those two rather than under `InvalidInput`',
Expand Down
Loading