SuperAPI AI 工具集

quarto-revealjs

办公与效率

查看项目

更新于 10-20 10:59

技能介绍

用途:该技能把 .qmd 文件通过 Quarto 的 format: revealjs 渲染成自包含的 HTML 幻灯片,并给出日常使用的工作流和语法。

主要能力:

  • 新建演示文稿:可从三套内置模板中选择。会议演示(亮色主题、Inter 字体;议程、分栏、表格、演讲者备注、行动项);技术演讲(暗色主题;带行高亮的代码块、可执行 Python、现场演示页);最小起步模板。选定后,模板连同主题文件一起被复制进项目,再替换标题、副标题、作者、页脚和占位内容。
  • 幻灯片语法:## 生成带标题页,# 生成章节分隔页,--- 生成无标题页,. . . 用于点击后暂停显示后续内容。
  • 演讲者备注:放在幻灯片标题之后、可见内容之前,按 S 打开演讲者视图。
  • 分栏:用 ::: {.columns} 与 .column 指定宽度。
  • 增量列表:用 ::: {.incremental} 逐条显示。
  • 图片与背景:支持宽度设置、background-color、background-image 和 background-opacity。
  • 代码高亮:支持 code-line-numbers="2-3",可用 "1|2-3" 逐次点击推进高亮。

主题:内置 default、dark、simple、serif、night、moon、sky、beige、blood、dracula、league、solarized。附带主题使用 Inter 文本字体与 JetBrains Mono 代码字体(来自 Google Fonts):Clean Light(theme-clean.scss,适合会议、提案)与 Clean Dark(theme-clean-dark.scss,适合技术演讲、代码演示)。亮色主题额外提供:表格样式、.small-table 紧凑表格、放大标签的 Mermaid、.bar-chart 横向条形图(.green/.blue/.amber/.red 配色)。

使用方式:渲染命令为 quarto render deck.qmd,实时预览用 quarto preview deck.qmd;成功标志是输出以 Output created: deck.html 结尾且无报错。技术演讲模板执行 Python 单元,需要装有 jupyter、numpy、pandas、matplotlib 的 Python 环境;用 uv 时可运行 uv run --with jupyter,numpy,pandas,matplotlib sh -c 'QUARTO_PYTHON=$(which python) quarto render deck.qmd'。若不想执行代码,可设 execute: enabled: false。若未安装 quarto,官方指引为 https://quarto.org/docs/get-started/。

画布与过渡:两套完整模板使用 16:9 画布(宽度 1600、高度 900、margin 0.15、最小缩放 0.2、最大缩放 1.5),过渡为 fade,速度 fast。

演示与 PDF:常用快捷键包括空格/→ 下一页、← 上一页、S 演讲者视图、O/Esc 概览、F 全屏、B/. 黑屏、E 打印视图、G 跳转、M 菜单、? 查看全部快捷键。导出 PDF 的方法:在 Chrome 中打开渲染后的演示文稿,按 E,再按 Cmd/Ctrl+P 打印,边距设为无并开启背景图形保存为 PDF。references/presenting.md 还记录了基于 ?print-pdf 的 URL 方式以及 pdf-* 选项(每页片段、每页幻灯片数)。

参考文件:references/yaml-options.md(revealjs YAML 选项)、references/theming.md(SCSS 主题、Sass 变量、自定义 CSS 类)、references/advanced-features.md(片段、auto-animate、绝对定位、堆栈、iframe、视频与背景媒体)、references/code-blocks.md(语法高亮样式、行高亮、可执行代码单元、代码输出)、references/presenting.md(演讲者视图、黑板、multiplex 观众同步、PDF 导出、无障碍)。

限制:技术演讲模板的可执行代码依赖 Jupyter 及指定 Python 包;PDF 导出依赖浏览器打印流程;资料未提及收费、平台支持范围或额外效果,这些暂未提供。