mcpField
A
academic-beamer-deck

academic-beamer-deck

github.com/thinkingwithagents文档处理1072 次安装26 周前更新
代码仓库

关于 academic-beamer-deck

academic-beamer-deck 是用于制作学术演示文稿的工作流指南,面向需要用 Beamer 组织现场报告的研究者。它强调叙事结构、稳健布局、视觉检查和 pdfLaTeX 编译验证。

主要功能

  1. 01规划适合现场演讲的叙事结构
  2. 02制定统一的主题与配色
  3. 03规范安全边距和页面布局
  4. 04提供图表与附录设计规则
  5. 05要求编译和视觉检查

适用场景

  1. 01将研究材料整理为学术演示文稿
  2. 02调整 Beamer 幻灯片布局与视觉层级
  3. 03检查附录导航、图表和页面边距

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/thinkingwithagents/skills --skill academic-beamer-deck

安装后在 Claude Code 中输入/academic-beamer-deck确认已加载。

详细介绍

工作流

  1. 审核并充分理解所有提供的材料。
  2. 编辑前制定幻灯片计划(结构、节奏、内容整合)。
  3. 为现场演示重构叙事。
  4. 应用视觉系统(主题、颜色、层级)。
  5. 优化内容密度和清晰度。
  6. 使用基于容器的对齐方式实现布局(不要使用间距技巧)。
  7. 检查所有幻灯片类型的编译结果和视觉效果。

叙事结构

默认结构:

  1. 标题
  2. 引入(引人入胜的开场)
  3. 研究问题
  4. 路线图
  5. 背景
  6. 数据
  7. 识别
  8. 结果
  9. 机制
  10. 综合(图表 / 总结)
  11. 政策影响
  12. 要点
  13. 附录

根据需要调整,但应优先考虑现场演示的流畅性。


设计系统

主题
  • 使用自定义的极简 Beamer 主题
  • 避免使用默认主题(例如 CambridgeUS)
  • 使用:
    • aspectratio=169
    • 不显示导航符号
    • 自定义帧标题和页脚

默认配色方案

除非用户另有指定,否则使用以下方案:

  • 主色:SlateTeal (#1B4D5C) -> 标题、页眉

  • 强调色:WarmAmber (#D4A84B) -> 高亮、关键数字

  • 正文颜色:DeepCharcoal (#2C3E50)

  • 次强调色:SoftCoral (#C0534D) -> 负面结果 / 显著性

  • 弱化色:CoolGray (#8899A6) -> 注释、标注

  • 浅色填充:PaleSage (#EDF2F0) -> tcolorbox 填充、区块正文

  • 背景:

    • 默认:白色 (#FFFFFF)
    • 可选:WarmWhite (#FAFAF8)(仅当所有图表的背景均为非白色时使用)
颜色规则
  • 谨慎使用强调色
  • 每张幻灯片最多使用 2-3 种主导颜色
  • 确保高对比度
  • 在所有幻灯片中保持一致

字体排版与结构

  • 层级清晰:

    • 突出标题
    • 正文精简
    • 有选择地突出重点
  • 优先采用:

    • 用方框呈现关键观点
    • 结构化布局(分栏、网格)
  • 避免:

    • 密集段落
    • 杂乱布局

内容规则

  • 每张幻灯片只讲一个主要观点
  • 优先使用视觉内容,而非文字
  • 合并重复的幻灯片
  • 将次要内容移至附录
  • 谨慎使用叠加显示(\pause)

图表规则(TikZ / 视觉内容)

按以下顺序优化:

  1. 清晰度
  2. 平衡
  3. 适配
  4. 紧凑度

规则:

  • 将整体构图置于幻灯片中央
  • 水平链条超出空间时,将最后一个或多个节点换行至下方居中排列
    • 不要缩小文字或节点宽度来强行排成单行
    • 使用坐标中点将换行后的节点行居中: \coordinate (mid) at ($(first.south)!0.5!(last.south)$); 这需要 \usetikzlibrary{calc}
  • 避免不必要的箭头(尤其是指向视觉上分离的结果节点时)
  • 将注释标签直接放在对应父节点下方
  • 注释文字使用弱化色(CoolGray)
  • 为结果节点使用独特样式(例如,强调色填充 + 强调色边框)
  • 定义可复用的节点样式(box、resultbox、evidence),而非使用内联样式
  • 始终使用 positioning 库(right=of、below=of),而非手动指定坐标

布局规则(重要)

核心原则

不要将元素紧贴幻灯片边缘放置。 定义统一的安全区域,并通过结构化方式确保其得到遵守。


安全区域

定义一个统一的内缩值(例如 1.5cm),并一致地应用于:

  • 页码(通过页脚中的 rightskip)
  • 按钮(通过末尾的 \hspace)
  • 所有右对齐内容

此值应只定义一次,并重复使用。如果更改该值,所有使用处都必须同步更改。


帧标题

在 frametitle 模板中明确设置垂直间距:

\setbeamertemplate{frametitle}{%
  \vskip18pt%
  \nointerlineskip%
  {\usebeamerfont{frametitle}\usebeamercolor[fg]{frametitle}\insertframetitle\par}%
  \vskip2pt%
  {\color{AccentColor}\rule{\textwidth}{1.2pt}}%
  \vskip4pt%
}

要点:

  • 开头的 \vskip 控制与幻灯片边缘之间的留白
  • 从 16-18pt 开始;根据用户反馈调整
  • 不要依赖 Beamer 默认的 frametitle 间距
页脚/页码

必须使用显式设置 rightskip 的 beamercolorbox。

\setbeamertemplate{footline}{%
  \begin{beamercolorbox}[wd=\paperwidth, ht=18pt, right, rightskip=1.5cm]{footline}%
    \insertframenumber\,/\,\inserttotalframenumber\vskip4pt%
  \end{beamercolorbox}%
}

这点至关重要,原因如下:

  • 内容后的 \hspace 会被 beamercolorbox 的边界裁切
  • 这意味着 \hfill{content}\hspace{Xcm} 无法可靠地实现右侧缩进
  • 唯一可靠的方法是在容纳内容的 beamercolorbox 上设置 rightskip
  • 这是实践中遇到的头号布局问题

不要使用:

% BROKEN: hspace gets clipped at box edge
\setbeamertemplate{footline}{%
  \hfill \insertframenumber \hspace{1.5cm}\vskip8pt%
}

按钮与导航

使用 \hfill 的按钮会被推到最右侧,并且会与页码重叠。

修复方法:在每组按钮之后添加与页脚 rightskip 相同的 \hspace:

\hfill \hyperlink{label}{\beamerbutton{Back}}\hspace{1.5cm}

对每张带按钮的幻灯片都应用此方法,包括:

  • 带有附录链接的主幻灯片(SDID、ATT 等)
  • 带有返回按钮的附录幻灯片
  • 一行中有多个按钮的幻灯片(只在最后一个按钮后添加 \hspace)

如果一张幻灯片有多个按钮,分别位于不同的 \hfill 行,则只需在最后一行添加末尾的 \hspace:

\hfill \hyperlink{a}{\beamerbutton{Back (A)}}
\hfill \hyperlink{b}{\beamerbutton{Back (B)}}\hspace{1.5cm}

结构规则

如果间距调整没有达到预期效果: -> 问题出在结构,而非数值 -> 修复容器(页脚/模板),而不是文本 -> 首先检查 beamercolorbox 或模板定义


图形整合

  • 如果任何图形的背景为白色 -> 使用白色幻灯片背景
  • 仅当所有图形都具有透明背景或与幻灯片背景相匹配时,才使用 WarmWhite(#FAFAF8)
  • 对所有 \includegraphics 调用使用 keepaspectratio
  • 为 4:3 创建的图形无法在 16:9 中正确拉伸;仅通过宽度限制尺寸
  • 避免图形在背景上呈现明显的“方框”效果

规则: 视觉整合 > 严格遵循主题纯度


附录

  • 使用纯分隔页进行分隔(样式与标题页一致)
  • 使用 appendixnumberbeamer 软件包重新开始幻灯片编号
  • 保留主幻灯片中的所有超链接标签
  • 所有返回按钮都必须链接到正确的主幻灯片标签
  • 保持附录幻灯片功能完善,但避免过多展示性设计:
    • 不使用渐进式显示
    • 表格可以更紧凑
    • 减少装饰元素

实施规则

  • 优先采用结构性修复,而不是间距变通方案
  • 首先检查容器(beamercolorbox、模板)
  • 避免反复试错调整间距
  • 使用 \graphicspath{{figures/}},并将所有图片存放在 figures/ 子目录中
  • 不要提交编译生成的文件(.pdf、.aux、.log、.nav、.out、.snm、.synctex.gz、.toc)

验证

编译
  • 必须使用 pdfLaTeX 编译(除非明确要求,否则不要使用 XeLaTeX)
  • 不得有错误(表格出现 overfull hbox 警告可以接受)
  • 至少运行两次,以解析交叉引用和超链接

视觉质量检查

检查:

  • 帧标题上方留有空间(不要紧贴幻灯片边缘)
  • 页码与右侧边缘之间留有可见间距
  • 任何幻灯片上的按钮都没有与页码重叠
  • 示意图居中且完整显示在帧内
  • 图形与背景融合(没有明显的白色方框)
  • 密集表格清晰易读(尤其检查附录幻灯片)
  • 标题页元素布局不拥挤

压力测试

验证:

  • 带有返回按钮的附录幻灯片(检查按钮与页码是否重叠)
  • 密集表格(检查 overfull vbox 警告和可读性)
  • 多图幻灯片(检查子图对齐)
  • TikZ 示意图(检查是否溢出、是否居中)
  • 导航较多的幻灯片(包含许多按钮的稳健性检查清单)
  • 标题页和附录分隔页(纯帧的间距有所不同)

应避免的故障模式

  • 幻灯片过于拥挤
  • 项目符号过多
  • 过度使用叠加效果
  • 元素被边缘裁切(尤其是页码)
  • 示意图溢出(横向链条对 16:9 来说过宽)
  • 图形与背景颜色不匹配
  • 脆弱的间距变通方案(在方框边界处使用 \hspace)
  • 按钮与页码重叠
  • 主幻灯片与附录之间的超链接失效

成功标准

一份成功的演示文稿应:

  • 使用 pdfLaTeX 顺利编译
  • 符合演示时长
  • 比原稿更易于演示
  • 外观简洁、专业
  • 保持学术严谨性
  • 在所有幻灯片上(包括带按钮的附录)均能稳健地处理间距
  • 没有任何元素紧贴幻灯片边缘

启发式原则

如有疑问:

  • 化繁为简
  • 对齐元素
  • 留出更多空间
  • 调整容器,而非文本
  • 优先考虑现场观众,而非存档

评论

支持 Markdown