admin/Templated-PPT-Master
1
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Add chapter-aware agendas and fixed header handoff (0.9.1)

Browse Source
This commit is contained in:
Commilitia
2026-10-21 09:37:30 +08:00
parent 4729693a9e
commit f7a87b6c97
4 changed files with 14 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files
references/authoring-handoff.md
+4
View File
@@ -12,6 +12,10 @@ This package carries no template, theme or global style library. Installation an
A theme switch changes only declared palette and asset properties. Shared canvas, typography, geometry, layout/slot identities and content meaning remain fixed unless the template explicitly defines an exception. Rebuild and inspect affected pages after a switch. Recompilation sets the PowerPoint theme palette; it does not retroactively recolor undeclared source literals.
For a template with chapter/subsection agendas, use its declared generator and data contract. A single overview may expand all subsections or collapse them all. Repeated agendas precede chapter and subsection entries, expand only the chapter being entered, and highlight the actual target through stable parent/child IDs. Preserve chapters without children. Bind any generated insertion plan to the report's real page order; co-located chapter/first-subsection entries need one agenda rather than consecutive duplicates. Reuse the template's fixed typography and whole-chapter column recipe; report capacity failures without dropping children, shrinking text or silently turning a single overview into multiple pages.
When the selected template provides a shared page-header generator, all pages with that header must use it. Supply the page title, the navigation number or upper-line text with its existing report meaning, and the current chapter or subsection's full title plus any explicit header short title. Keep the agenda title intact. Select the current leaf by stable IDs; do not infer a page number, chapter number or new numbering policy from that selection. Respect the template's fixed short-title capacity, actual font-width checks, divider and page-title coordinates. A shorter name does not move the main title; an overlong name needs an explicit short title, and a page title requiring two lines uses the declared two-line layout. Do not shrink type, change tracking, truncate text or replace only a prototype navigation token. Preserve layouts without this header. When adapting a frozen page-library source, first apply the current template's header adapter to a project-local copy; leave the library source and preview bytes intact.
## Icon material handoff
Apply [icon production](icon-production.md) to template reuse and all new authored, generated or external icons. Use a project-local material descriptor for new icons; do not edit a locked vendor snapshot. Whole and partial coloring follow the same contract.