Skip to content

AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He

fix: Latin runs in a non-Latin deck proof as English; bilingual roles and notes

hugohe3f76d1ecb4185
diff --git a/skills/ppt-master/references/executor-notes.md b/skills/ppt-master/references/executor-notes.md
index 5ae652b3..400db2d7 100644
--- a/skills/ppt-master/references/executor-notes.md
+++ b/skills/ppt-master/references/executor-notes.md
@@ -8,7 +8,7 @@ Conditional late-stage authority for generating or validating the complete speak
## 1. Complete Speaker-notes Document
-Write the whole deck to `notes/total.md` in one batch: `# <number>_<page_title>` per page, `---` between pages; only the heading is stripped before TTS. `notes_to_audio.py` reads the body verbatim, so write prose only — no list/bullet markup, stage markers, key-point labels, duration lines, or other metadata. Keep one language; spell out digits or symbols when literal TTS would sound wrong (Chinese "百分之六十八" rather than "68%").
+Write the whole deck to `notes/total.md` in one batch: `# <number>_<page_title>` per page, `---` between pages; only the heading is stripped before TTS. `notes_to_audio.py` reads the body verbatim, so write prose only — no list/bullet markup, stage markers, key-point labels, duration lines, or other metadata. Keep one language unless the confirmed contract is bilingual — then every page keeps the same segment order (first language, blank line, second language); spell out digits or symbols when literal TTS would sound wrong (Chinese "百分之六十八" rather than "68%").
**Pre-SVG narration branch**: when `notes/total.md` already exists from a final/literal script or Quick direct narrated video, validate it instead of regenerating. Retain every word and segment of a final/literal script; agent-authored Quick narration may be repaired only for final-SVG inconsistency and before audio. A `# Slide <number>` heading remains valid until Generate Step 7.1 resolves the roster.
diff --git a/skills/ppt-master/references/plan-core.md b/skills/ppt-master/references/plan-core.md
index 134d68e8..d8787278 100644
--- a/skills/ppt-master/references/plan-core.md
+++ b/skills/ppt-master/references/plan-core.md
@@ -163,7 +163,7 @@ python3 skills/ppt-master/scripts/visualization_recall.py validate \
**Family selection**: user/template typography is authoritative. Delivery target: an explicit user/template target first, otherwise Windows Microsoft PowerPoint (owner: [`shared-standards-core.md`](./shared-standards-core.md) §4.1) — the authoring host's installed fonts never select a face; name concrete faces installed or approved on that target; at most four families; a brand/web face leads only after user-confirmed installation, otherwise export a safe face and keep it as a Design Spec reference (fonts are not embedded; CSS tails are preview aids, not PowerPoint fallbacks). Avoid near-equivalent splits (YaHei↔PingFang, SimSun↔Songti, Arial↔Helvetica↔Segoe UI, Times↔Times New Roman). Fonts in one deck form contrast (different family, weight, or proportion) or concord (one family throughout); across the direction set include both a concord and a contrast pairing unless the user or template fixes the stack, and never default to title = body without a reason.
-**Reference — PPT-safe faces (recall, not a whitelist; one concrete named face per script — a stack carries at most one Latin face and one CJK face and never a fallback list of alternatives, because export takes the first named face of each script)**: CJK sans `Microsoft YaHei` / `SimHei`, CJK serif `SimSun` / `FangSong` / `KaiTi` (their macOS counterparts `PingFang SC` / `Heiti SC` / `Songti SC` are preview aliases, never the named face), Traditional Chinese sans `Microsoft JhengHei`, serif `PMingLiU` / `DFKai-SB`, Japanese sans `Yu Gothic` / `Meiryo`, serif `Yu Mincho`, Korean sans `Malgun Gothic`, serif `Batang` (text on another locale's CJK face takes that locale's glyph forms), Arabic `Segoe UI` / `Tahoma` / `Times New Roman` (one face carries both the Latin and Arabic text), Devanagari and other Indic scripts `Nirmala UI` / `Mangal`, Thai `Leelawadee UI` / `Tahoma`, Latin sans `Arial` / `Calibri` / `Segoe UI` / `Verdana` / `Trebuchet MS`, Latin serif `Times New Roman` / `Georgia` / `Cambria` / `Palatino` / `Garamond` (`Georgia` sets old-style figures whose digits sit at different heights — a hero-number or data role needs lining figures: `Times New Roman`, `Cambria`, or any listed sans or mono), mono `Consolas` / `Courier New`, math `Cambria Math` (formula preview runs only), display `Impact` / `Arial Black`. Let the locked style's character pick the axis and lead the title — `Microsoft YaHei` / `Arial` are the neutral members, never the automatic lead; a neutral sans title where the style asks for character is the failure to avoid. Non-pre-installed directions — retro/pixel Press Start 2P / VT323, rounded Nunito / Quicksand / OPPO Sans (safe substitute `Trebuchet MS` / `Verdana`), modern web Inter / HarmonyOS Sans / Source Han, calligraphic 隶书 / 华文行楷 / 华文新魏 (safe substitute `KaiTi` / `FangSong`, titles only), brand faces — need target installation or stay Design Spec references.
+**Reference — PPT-safe faces (recall, not a whitelist; one concrete named face per script — a stack carries at most one Latin face and one CJK face and never a fallback list of alternatives, because export takes the first named face of each script)**: CJK sans `Microsoft YaHei` / `SimHei`, CJK serif `SimSun` / `FangSong` / `KaiTi` (their macOS counterparts `PingFang SC` / `Heiti SC` / `Songti SC` are preview aliases, never the named face; a CJK deck that also sets Latin lines pairs both in one stack — `SimSun, Cambria` — so the theme's latin and ea slots differ), Traditional Chinese sans `Microsoft JhengHei`, serif `PMingLiU` / `DFKai-SB`, Japanese sans `Yu Gothic` / `Meiryo`, serif `Yu Mincho`, Korean sans `Malgun Gothic`, serif `Batang` (text on another locale's CJK face takes that locale's glyph forms), Arabic `Segoe UI` / `Tahoma` / `Times New Roman` (one face carries both the Latin and Arabic text), Devanagari and other Indic scripts `Nirmala UI` / `Mangal`, Thai `Leelawadee UI` / `Tahoma`, Latin sans `Arial` / `Calibri` / `Segoe UI` / `Verdana` / `Trebuchet MS`, Latin serif `Times New Roman` / `Georgia` / `Cambria` / `Palatino` / `Garamond` (`Georgia` sets old-style figures whose digits sit at different heights — a hero-number or data role needs lining figures: `Times New Roman`, `Cambria`, or any listed sans or mono), mono `Consolas` / `Courier New`, math `Cambria Math` (formula preview runs only), display `Impact` / `Arial Black`. Let the locked style's character pick the axis and lead the title — `Microsoft YaHei` / `Arial` are the neutral members, never the automatic lead; a neutral sans title where the style asks for character is the failure to avoid. Non-pre-installed directions — retro/pixel Press Start 2P / VT323, rounded Nunito / Quicksand / OPPO Sans (safe substitute `Trebuchet MS` / `Verdana`), modern web Inter / HarmonyOS Sans / Source Han, calligraphic 隶书 / 华文行楷 / 华文新魏 (safe substitute `KaiTi` / `FangSong`, titles only), brand faces — need target installation or stay Design Spec references.
**Role extension after confirmation**: while composing the roster, add a lowercase snake_case role with an exact stack only for a recurring role that materially needs a different family (`annotation`, `footer`, `footnote`, `data`, `emphasis`, `quote`, `code`), coherent with the confirmed heading/body system and locked style; one-off garnish stays omitted and Default names any added role in one compact `Role rationale` line in §IV.
@@ -177,6 +177,7 @@ python3 skills/ppt-master/scripts/visualization_recall.py validate \
| Subtitle | 1.2–1.5× |
| Lead / subheading | 1.1–1.4× |
| Body | 1× |
+| Second-language line on a bilingual page | 0.75–0.9× |
| Annotation | 0.7–0.85× |
| Footnote / page number | 0.5–0.65× |
diff --git a/skills/ppt-master/scripts/preset_shape_svg.py b/skills/ppt-master/scripts/preset_shape_svg.py
index fff4afd3..4419f837 100644
--- a/skills/ppt-master/scripts/preset_shape_svg.py
+++ b/skills/ppt-master/scripts/preset_shape_svg.py
@@ -322,11 +322,7 @@ def main(argv: Sequence[str] | None = None) -> int:
"scope": semantics["scope"],
"literal_only": semantics["literal_only"],
"adjustments": adjustments,
- **(
- {"adjustment_notes": semantics["adjustment_notes"]}
- if "adjustment_notes" in semantics
- else {}
- ),
+ "adjustment_notes": semantics.get("adjustment_notes"),
"connector_preset": connector_preset,
"path_count": path_count,
"connection_site_count": connection_site_count,
diff --git a/skills/ppt-master/scripts/svg_to_pptx/drawingml/utils.py b/skills/ppt-master/scripts/svg_to_pptx/drawingml/utils.py
index 9bbd2020..6313c785 100644
--- a/skills/ppt-master/scripts/svg_to_pptx/drawingml/utils.py
+++ b/skills/ppt-master/scripts/svg_to_pptx/drawingml/utils.py
@@ -3479,9 +3479,31 @@ def detect_text_lang(
frozenset({'el'}),
'el-GR',
)
+ if (
+ default_language
+ and language_base(default_language) in _NON_LATIN_SCRIPT_BASES
+ and any(ch.isalpha() for ch in text)
+ ):
+ # A run of Latin letters inside a CJK/Arabic/... deck (an English
+ # subtitle, a source line) proofs and reads as English, not as the
+ # deck language; digits and punctuation alone keep the deck tag.
+ return 'en-US'
return default_language or 'en-US'
+# Language bases whose script the detector recognises above; a Latin-letter
+# run under one of these deck languages is not written in that language.
+_NON_LATIN_SCRIPT_BASES = frozenset({
+ 'zh', 'ja', 'ko',
+ 'ar', 'fa', 'ps', 'sd', 'ug', 'ur',
+ 'he', 'yi',
+ 'hi', 'mr', 'ne', 'sa',
+ 'th',
+ 'be', 'bg', 'kk', 'ky', 'mk', 'mn', 'ru', 'sr', 'uk',
+ 'el',
+})
+
+
def _is_grapheme_extend(ch: str) -> bool:
"""Return whether ``ch`` extends the preceding rendered character."""
cp = ord(ch)
diff --git a/skills/ppt-master/scripts/tests/test_dogfood_hindi_fixes.py b/skills/ppt-master/scripts/tests/test_dogfood_hindi_fixes.py
index a40d9b40..b580775c 100644
--- a/skills/ppt-master/scripts/tests/test_dogfood_hindi_fixes.py
+++ b/skills/ppt-master/scripts/tests/test_dogfood_hindi_fixes.py
@@ -52,3 +52,14 @@ class TableFallbackFaceTests(unittest.TestCase):
if __name__ == "__main__":
unittest.main()
+
+
+class RunLanguageTests(unittest.TestCase):
+ def test_latin_runs_in_a_cjk_deck_are_english(self) -> None:
+ from svg_to_pptx.drawingml.utils import detect_text_lang
+ self.assertEqual(detect_text_lang("China's NEV Exports 2025", "zh-CN"), "en-US")
+ self.assertEqual(detect_text_lang("Sources: CAAM, CPCA", "ar-SA"), "en-US")
+ self.assertEqual(detect_text_lang("2025", "zh-CN"), "zh-CN")
+ self.assertEqual(detect_text_lang("出口 Exports", "zh-CN"), "zh-CN")
+ self.assertEqual(detect_text_lang("Hello", "en-GB"), "en-GB")
+ self.assertEqual(detect_text_lang("Xin chào", "vi-VN"), "vi-VN")
diff --git a/skills/ppt-master/scripts/text_measure.py b/skills/ppt-master/scripts/text_measure.py
index e3526b57..d832576c 100644
--- a/skills/ppt-master/scripts/text_measure.py
+++ b/skills/ppt-master/scripts/text_measure.py
@@ -499,13 +499,17 @@ def _outline_candidates(
value = _clean_planned_line(field_match.group('value'))
if label == 'title':
if value and 'title' in candidates:
- candidates['title'].append((slide, value))
+ candidates['title'].extend(
+ (slide, part) for part in _split_joined_blocks(value)
+ )
line_index += 1
continue
if label == 'core message':
role = 'subtitle' if 'subtitle' in candidates else 'body'
if value and role in candidates:
- candidates[role].append((slide, value))
+ candidates[role].extend(
+ (slide, part) for part in _split_joined_blocks(value)
+ )
line_index += 1
continue