wehub-resource-sync
8cb1f9f479
Publish SDK (PyPI) / publish (push) Has been cancelled
Publish SDK (npm) / publish (@aionui/officecli-sdk) (push) Has been cancelled
SDK smoke / smoke (windows-latest) (push) Has been cancelled
Publish SDK (npm) / publish (@officecli/officecli-sdk) (push) Has been cancelled
Publish SDK (npm) / publish (@officecli/sdk) (push) Has been cancelled
Publish SDK (npm) / publish (officecli-sdk) (push) Has been cancelled
SDK smoke / smoke (macos-latest) (push) Has been cancelled
SDK smoke / smoke (ubuntu-latest) (push) Has been cancelled
Skill parity / diff (push) Has been cancelled
130 lines
4.4 KiB
Markdown
130 lines
4.4 KiB
Markdown
# Presentation Settings Showcase
|
|
|
|
Exercises the pptx `presentation` property surface — the deck-level settings with
|
|
no per-slide or per-shape equivalent. Four files work together:
|
|
|
|
- **presentation-settings.sh** — builds the deck via the `officecli` CLI (this file walks through it).
|
|
- **presentation-settings.py** — the same build via the **officecli Python SDK** (one `doc.send()` per command, mirroring the `.sh` line for line).
|
|
- **presentation-settings.pptx** — the generated deck (either script produces it).
|
|
- **presentation-settings.md** — this file.
|
|
|
|
The CLI commands shown below are exactly what `presentation-settings.sh` runs;
|
|
the `.py` issues the identical sequence over the SDK pipe.
|
|
|
|
## The `presentation` container
|
|
|
|
`presentation` is a read-only container addressed at path `/` — you never `add`
|
|
or `remove` it, only `set`/`get`:
|
|
|
|
```bash
|
|
officecli set file.pptx / --prop title="Q4 Review" --prop slideSize=widescreen
|
|
officecli get file.pptx /
|
|
```
|
|
|
|
> A blank pptx has a master + layouts but **no slides**. The script adds one
|
|
> (`add / --type slide`) before placing the title shape — `add /slide[1] …` on a
|
|
> deck with zero slides is a no-op.
|
|
|
|
## Regenerate
|
|
|
|
```bash
|
|
cd examples/ppt
|
|
bash presentation-settings.sh # via the CLI
|
|
# — or —
|
|
pip install officecli-sdk # the SDK (officecli binary still required)
|
|
python3 presentation-settings.py # via the SDK, same result
|
|
# → presentation-settings.pptx
|
|
```
|
|
|
|
## Property groups
|
|
|
|
### 1. Metadata (core + extended properties)
|
|
|
|
```bash
|
|
officecli set file.pptx / --prop author="Jane Author" --prop title="Q4 Business Review" \
|
|
--prop subject=Strategy --prop keywords="q4,review,strategy" \
|
|
--prop description="Quarterly business review deck." --prop category=Marketing \
|
|
--prop lastModifiedBy=Editorial --prop revisionNumber=3
|
|
officecli set file.pptx / --prop extended.company="Acme Corp" \
|
|
--prop extended.manager="Dana Lead" --prop extended.template="Widescreen.potx"
|
|
```
|
|
|
|
### 2. Slide setup
|
|
|
|
```bash
|
|
officecli set file.pptx / --prop slideSize=widescreen \ # 4:3 | widescreen | onscreen16x10 | a4 | letter
|
|
--prop firstSlideNum=1 --prop rtl=false --prop compatMode=false
|
|
```
|
|
|
|
`slideSize` is a named preset. Setting explicit `slideWidth`/`slideHeight`
|
|
instead makes the deck a **custom** size (the two are mutually exclusive):
|
|
|
|
```bash
|
|
officecli set file.pptx / --prop slideWidth=25.4cm --prop slideHeight=19.05cm # custom 4:3
|
|
```
|
|
|
|
### 3. Print setup
|
|
|
|
```bash
|
|
officecli set file.pptx / \
|
|
--prop print.what=slides \ # slides | handouts | notes | outline
|
|
--prop print.colorMode=color \ # color | gray | bw
|
|
--prop print.frameSlides=true \
|
|
--prop print.hiddenSlides=false \
|
|
--prop print.scaleToFitPaper=true
|
|
```
|
|
|
|
### 4. Slideshow behaviour
|
|
|
|
```bash
|
|
officecli set file.pptx / \
|
|
--prop show.loop=false --prop show.narration=true \
|
|
--prop show.animation=true --prop show.useTimings=true
|
|
```
|
|
|
|
### 5. Privacy
|
|
|
|
```bash
|
|
officecli set file.pptx / --prop removePersonalInfo=false
|
|
```
|
|
|
|
### 6. Theme — palette accents and major/minor fonts
|
|
|
|
A blank pptx ships a theme part, so theme edits resolve. The title shape uses
|
|
`fill=accent1`, so remapping `theme.color.accent1` recolours it — the rendered
|
|
deck shows the title bar in the new accent, not the Office default:
|
|
|
|
```bash
|
|
officecli set file.pptx / \
|
|
--prop theme.color.accent1=1F6FEB --prop theme.color.accent2=E3572A \
|
|
--prop theme.color.hlink=0969DA
|
|
officecli set file.pptx / \
|
|
--prop theme.font.major.latin=Georgia --prop theme.font.minor.latin=Calibri
|
|
```
|
|
|
|
## Complete feature coverage
|
|
|
|
| Group | Keys |
|
|
|---|---|
|
|
| Metadata | `author`, `title`, `subject`, `keywords`, `description`, `category`, `lastModifiedBy`, `revisionNumber`, `extended.*` |
|
|
| Slide setup | `slideSize`, `slideWidth`, `slideHeight`, `firstSlideNum`, `rtl`, `compatMode` |
|
|
| Print | `print.what`, `print.colorMode`, `print.frameSlides`, `print.hiddenSlides`, `print.scaleToFitPaper` |
|
|
| Slideshow | `show.loop`, `show.narration`, `show.animation`, `show.useTimings` |
|
|
| Privacy | `removePersonalInfo` |
|
|
| Theme | `theme.color.accent1..6/dk/lt/hlink/folHlink`, `theme.font.major/minor.latin/eastAsia` |
|
|
|
|
Full list: `officecli help pptx presentation`. (A separate `/theme` element —
|
|
`officecli help pptx theme` — exposes the same palette under shorter keys.)
|
|
|
|
## Set → Get round-trip
|
|
|
|
```
|
|
author = Jane Author
|
|
title = Q4 Business Review
|
|
slideSize = widescreen
|
|
print.what = slides
|
|
show.useTimings = True
|
|
theme.color.accent1 = #1F6FEB
|
|
theme.font.major.latin = Georgia
|
|
```
|