htmlewislulu-html-ppt-skill/templates/full-decks/presenter-mode-reveal
lewis 23d9f5d369 fix(presenter): rewrite as popup window with CSS scale() rendering
BREAKING: S key no longer overlays on the same page. It now opens a
separate browser window (window.open) for the presenter.

Audience window (original page):
- Stays completely untouched — normal slide view
- S key opens the presenter popup
- ← → / T / F / O all work as before
- Navigation syncs to presenter via BroadcastChannel

Presenter window (popup):
- Current slide rendered at 1920×1080 then CSS transform:scale() to fit
- Next slide preview also at 1920×1080 scale() — layout never breaks
- Large-font speaker script (18px, scrollable)
- Elapsed timer + page counter + current slide title
- ← → navigates (syncs back to audience window)
- R resets timer, Esc closes popup

Technical:
- runtime.js builds presenter HTML dynamically (buildPresenterHTML)
- Collects all slide outerHTML + notes + all stylesheets from host page
- Injects into popup via document.write()
- BroadcastChannel keyed by pathname for multi-deck isolation
- base.css: removed all old inline .pv-* / .presenter-view styles
  (presenter styles now self-contained in popup HTML)

Docs updated:
- SKILL.md: describes popup behavior, separate keyboard sections
- references/presenter-mode.md: new dual-window diagram, updated flow
- presenter-mode-reveal/README.md: updated S key and dual-screen guide
2026-04-17 22:36:04 +08:00
..
README.md fix(presenter): rewrite as popup window with CSS scale() rendering 2026-04-17 22:36:04 +08:00
index.html feat(presenter): add true presenter view (S) with speaker script + timer 2026-04-17 22:19:53 +08:00
style.css feat(presenter): add true presenter view (S) with speaker script + timer 2026-04-17 22:19:53 +08:00

README.md

presenter-mode-reveal · 演讲者模式模板

一份专为带逐字稿的技术分享设计的 full-deck 模板。核心卖点是真正可用的演讲者视图 (Presenter View):当前页 + 下页预览 + 大字号逐字稿 + 计时器,全部集成在 runtime.js 里,零依赖。

使用场景

  • 技术分享 / tech talk30-60 min
  • 产品发布会主讲
  • 课程讲授
  • 任何需要照着讲、但不能念稿的正式演讲

快速开始

cp -r templates/full-decks/presenter-mode-reveal examples/my-talk
open examples/my-talk/index.html

键盘操作

动作
S 打开演讲者窗口(弹出新窗口,原页面不动)
T 切换主题5 种预设)
翻页
Space / PgDn 下一页
F 全屏
O 总览缩略图
R 重置计时器(仅演讲者视图下)
Esc 关闭所有浮层

主题切换

模板预设了 5 个适配演讲场景的主题,在 <html data-themes="..."> 属性里:

<html lang="zh-CN" data-themes="tokyo-night,dracula,catppuccin-mocha,nord,corporate-clean">

T 循环切换。可以改成任何 assets/themes/*.css 里的主题。

写逐字稿的规范

每一页的 <aside class="notes"> 里写 150300 字。三条铁律:

  1. 不是讲稿,是提示信号 — 核心点加粗、过渡句成段、数据列清楚
  2. 150300 字/页 — 按 23 分钟/页的节奏
  3. 用口语写 — "因此" → "所以""该方案" → "这个方案";读一遍不拗口才对

示例:

<aside class="notes">
  <p>大家好,今天跟大家聊一个 <strong>很多人忽略的问题</strong>——...</p>
  <p>我先抛一个观点:<em>做 PPT 和讲 PPT 是两件事</em></p>
  <p>接下来我会用 3 个例子证明这个观点...</p>
</aside>

支持的 inline 标签:

  • <strong> — 高亮(橘色)
  • <em> — 斜体强调(蓝色)
  • <code> — 等宽字体
  • <p> — 分段(推荐每段讲 30-60 秒的内容)

文件结构

presenter-mode-reveal/
├── index.html       # 6 张示例 slide每页都有完整逐字稿
├── style.css        # scoped .tpl-presenter-mode-reveal 样式
└── README.md        # 本文件

修改 / 扩展

  • 加页:复制任意 <section class="slide"> 块,改内容和 <aside class="notes">
  • 换主题:改 data-themes 列表,或直接改 <link id="theme-link" href="...">
  • 改样式:只动 style.css,不要碰根目录的 assets/base.css
  • 加动效:在元素上加 data-anim="fade-up" 等(参考 references/animations.md

注意事项

  • 观众永远看不到 .notes 内容 — CSS 默认 display:none,只在演讲者视图里可见
  • 别把只给自己看的话写在 slide 本体上 — 所有提词必须在 <aside class="notes">
  • 双屏演讲:打开 index.html 按 S 弹出演讲者窗口,把观众窗口拖到投影/外接屏 F 全屏,演讲者窗口留在自己屏幕