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
108 lines
4.5 KiB
Python
108 lines
4.5 KiB
Python
#!/usr/bin/env python3
|
|
"""
|
|
Presentation Settings Showcase — generates presentation-settings.pptx exercising
|
|
the full pptx `presentation` property surface
|
|
(schemas/help/pptx/presentation.json): the deck-level settings with no per-slide
|
|
or per-shape equivalent.
|
|
|
|
`presentation` is a read-only container at path "/"; you only set/get it. Six
|
|
groups: metadata, slide setup, print, slideshow, privacy, theme.
|
|
|
|
SDK twin of presentation-settings.sh, mapped one-for-one:
|
|
|
|
officecli.create(...) ≈ officecli create + open
|
|
doc.send({...}) ≈ one officecli set/add (one call each, no batch)
|
|
doc.close() ≈ officecli close
|
|
|
|
Usage:
|
|
pip install officecli-sdk
|
|
python3 presentation-settings.py
|
|
"""
|
|
|
|
import os
|
|
import officecli # pip install officecli-sdk
|
|
|
|
FILE = os.path.join(os.path.dirname(os.path.abspath(__file__)), "presentation-settings.pptx")
|
|
|
|
print("\n==========================================")
|
|
print(f"Generating presentation-settings showcase: {FILE}")
|
|
print("==========================================")
|
|
|
|
doc = officecli.create(FILE, "--force") # create the .pptx + start its resident
|
|
|
|
|
|
def pres(**props): # one presentation-container `set`
|
|
doc.send({"command": "set", "path": "/", "props": props})
|
|
|
|
|
|
def add(parent, type_, **props): # one `officecli add`
|
|
doc.send({"command": "add", "parent": parent, "type": type_, "props": props})
|
|
|
|
|
|
# --- A title slide (blank pptx has master + layouts but no slides) ---
|
|
print("\n--- Title slide ---")
|
|
add("/", "slide") # add the first slide
|
|
add("/slide[1]", "shape", geometry="rect", left="2cm", top="3cm",
|
|
width="26cm", height="4cm", fill="accent1", # fill references theme accent1
|
|
text="Presentation Settings", fontSize="40", color="FFFFFF", bold="true")
|
|
|
|
# --- 1. Metadata (core + extended) ---
|
|
print("--- Metadata ---")
|
|
pres(author="Jane Author", title="Q4 Business Review", subject="Strategy",
|
|
keywords="q4,review,strategy", description="Quarterly business review deck.",
|
|
category="Marketing", lastModifiedBy="Editorial", revisionNumber="3")
|
|
pres(**{"extended.company": "Acme Corp", "extended.manager": "Dana Lead",
|
|
"extended.template": "Widescreen.potx"})
|
|
|
|
# --- 2. Slide setup (slideSize preset; explicit slideWidth/Height = custom) ---
|
|
print("--- Slide setup ---")
|
|
pres(slideSize="widescreen", # 4:3 | widescreen | onscreen16x10 | a4 | letter
|
|
firstSlideNum="1", rtl="false", compatMode="false")
|
|
|
|
# --- 3. Print ---
|
|
print("--- Print ---")
|
|
pres(**{"print.what": "slides", # slides | handouts | notes | outline
|
|
"print.colorMode": "color", # color | gray | bw
|
|
"print.frameSlides": "true",
|
|
"print.hiddenSlides": "false",
|
|
"print.scaleToFitPaper": "true"})
|
|
|
|
# --- 4. Slideshow behaviour ---
|
|
print("--- Slideshow ---")
|
|
pres(**{"show.loop": "false", "show.narration": "true",
|
|
"show.animation": "true", "show.useTimings": "true"})
|
|
|
|
# --- 5. Privacy ---
|
|
print("--- Privacy ---")
|
|
pres(removePersonalInfo="false") # keep document properties on save
|
|
|
|
# --- 6. Theme — palette (dk/lt + accent1..6) and major/minor fonts ---
|
|
print("--- Theme ---")
|
|
pres(**{"theme.color.dk1": "1A1A1A", "theme.color.lt1": "FFFFFF",
|
|
"theme.color.dk2": "2F3640", "theme.color.lt2": "EEF1F5",
|
|
"theme.color.accent1": "1F6FEB", "theme.color.accent2": "E3572A",
|
|
"theme.color.accent3": "2DA44E", "theme.color.accent4": "BF8700",
|
|
"theme.color.accent5": "8250DF", "theme.color.accent6": "1B7C83",
|
|
"theme.color.hlink": "0969DA", "theme.color.folHlink": "8250DF"})
|
|
pres(**{"theme.font.major.latin": "Georgia", "theme.font.minor.latin": "Calibri",
|
|
"theme.font.major.eastAsia": "SimHei", "theme.font.minor.eastAsia": "SimSun"})
|
|
|
|
# --- Get round-trip: confirm canonical keys read back ---
|
|
print("\n--- Round-trip readback (get / ) ---")
|
|
node = doc.send({"command": "get", "path": "/"})
|
|
fmt = node.get("data", {}).get("results", [{}])[0].get("format", {})
|
|
for k in ["author", "title", "category", "slideSize", "firstSlideNum",
|
|
"print.what", "show.useTimings", "theme.color.accent1",
|
|
"theme.font.major.latin"]:
|
|
if k in fmt:
|
|
print(f" {k} = {fmt[k]}")
|
|
|
|
# --- Validate over the pipe (in-session, no extra process) ---
|
|
print("\n--- Validate ---")
|
|
v = doc.send({"command": "validate"})
|
|
print(" Validation passed: no errors found." if v.get("success")
|
|
else f" {v.get('warnings')}")
|
|
|
|
doc.close() # stop the resident (flushes to disk)
|
|
print(f"\nCreated: {FILE}")
|