# Presenterm - 终端幻灯片工具 Presenterm 是一种基于终端的现代演示工具，可将 Markdown 文件呈现为幻灯片。它支持主题、代码语法突出显示、图像、图表渲染（mermaid、d2）、数学公式（LaTeX、typst），并且可以导出为 PDF 或 HTML。 ## 核心原则 * **Markdown-first** ：用熟悉的 Markdown 语法编写演示文稿 * **Terminal-native** ：完全在终端中运行，具有丰富的渲染功能 * **高级渲染**：将 mermaid/d2 图和 LaTeX/typst 公式渲染为图像 * **演示模式**：独立的演示视图，支持演讲者备注 * **导出功能**：从 Markdown 幻灯片生成 PDF 或 HTML * **代码执行** ：在演示期间执行代码片段 * **主题支持** ：多个内置主题和自定义主题支持 ## 安装 # macOS（自制）酿造安装演示者 # 货物货物安装展示器 # 来自源码 git 克隆 https://github.com/mfontanini/presentterm CD演示器货物安装--路径。 ## 基本用法 ### 运行演示 # 运行演示演示者演示文稿.md # 使用演示模式（全屏，隐藏控件） Presenterm -p 演示文稿.md Presenterm——当前presentation.md # 使用特定主题 Presenterm -t 黑暗演示文稿.md Presenterm --主题catppuccinpresentation.md # 列出可用主题演示者--列表主题 # 显示当前主题演示者--当前主题 ### 正在导出 # 导出为 PDF Presenterm -e 演示文稿.md Presenterm --export-pdf 演示文稿.md # 导出为具有特定输出路径的PDF Presenterm -e 演示.md -o 输出.pdf Presenterm --export-pdf演示文稿.md --输出幻灯片.pdf # 导出为 HTML Presenterm -E 演示文稿.md Presenterm --export-html演示文稿.md -o演示文稿.html # 指定导出的临时路径 Presenterm -epresentation.md --导出临时路径/tmp/presenterm ## Markdown 语法 ### 滑动分离器分隔 # 第一张幻灯片内容在这里 --- # 第二张幻灯片更多内容 --- # 第三张幻灯片最后一张幻灯片 ### 幻灯片布局 # 标题幻灯片 ## 副标题作者姓名 --- # 内容幻灯片 - 要点 1 - 要点 2 - 嵌套点 - 要点 3 --- # 代码幻灯片 ``生锈 fn 主() { println!("你好，主持人！"); } ```（三个反引号） --- # 引用幻灯片 > “预测未来的最好方法就是发明它。” > — 艾伦·凯 ### 演讲者备注 # 我的幻灯片可见内容更多可见内容 --- # 另一张幻灯片 ### 图片 # 图像幻灯片 ![描述](path/to/image.png) --- # 居中图像 ![](./logo.png) ### 表格 # 表示例 |特色 |状态 |优先| |---------|--------|----------| |出口|完成 |高| |主题|完成 |高| |图片 |完成 |中等| ### 代码高亮 # 语法高亮 ````蟒蛇定义斐波那契(n): 如果 n <= 1：返回n 返回斐波那契(n-1) + 斐波那契(n-2) ```` ``生锈 fn 阶乘(n: u64) -> u64 { (1..=n).product() } ```` ```javascript const 问候 = (名字) => { console.log(`你好，${name}!`); }; ```` ## 代码执行 ### 可执行代码块 # 启用代码片段执行 Presenterm -x 演示文稿.md Presenterm --enable-snippet-executionpresentation.md # 启用替换自动执行 Presenterm -X 演示文稿.md Presenterm --enable-snippet-execution-replacepresentation.md # 无需运行即可验证片段 Presenterm --validate-snippetspresentation.md ### 可执行代码语法 # 现场演示 ```bash +exec echo“当您前进到这张幻灯片时，这将执行” 日期 ```` --- # 自动替换演示 ```bash +exec_replace ls-la ```` ## 高级渲染 Presenterm 支持直接从代码块渲染图表和公式，并在演示加载期间将它们转换为图像。 ### 美人鱼图使用“+render”属性渲染美人鱼图。 **要求：** * 安装 [mermaid-cli](): `npm install -g @mermaid-js/mermaid-cli` **语法：** ``美人鱼+渲染序列图爱丽丝->>鲍勃：你好鲍勃，你好吗？鲍勃-->>爱丽丝：我很好，谢谢！爱丽丝-)鲍勃：再见！ ```` ``美人鱼+渲染图解TD A[开始] --> B{工作正常吗？} B -->|是| C[太棒了！] B -->|否| D[调试] D-->B ```` ``美人鱼+渲染饼图标题项目时间分布 “发展”：40 “测试”：25 “文档”：20 “会议”：15 ```` **配置（在config.yaml中）：** 美人鱼： # 主题选择主题：黑暗 # 背景颜色背景：“#2E3440” # 图像缩放规模：2.0 **带有宽度属性的尺寸控制：** ```美人鱼+渲染+宽度：80% 图LR A --> B --> C ```` **性能说明：** * 每个图表的渲染时间约为 2 秒 * 异步渲染（默认2个线程） ### d2 图渲染架构图和系统图的 d2 图。 **要求：** * 安装 [d2](): `brew install d2` 或从版本下载 **语法：** ```d2 +渲染 # 系统架构 web_server: 网络服务器 { 形状: 长方形 } 数据库：数据库{ 形状: 圆柱体 } 缓存：Redis 缓存 { 形状：存储数据 } web_server -> 数据库：查询 web_server -> 缓存：读/写 ```` ```d2 +渲染我的表：{ 形状：sql_table id：int {约束：primary_key} 用户名：varchar(255) 电子邮件：varchar(255) 创建时间：时间戳 } ```` ```d2 +渲染方向：右用户 -> api：HTTP 请求 api -> auth：验证令牌 api->数据库：查询数据 api -> 缓存：检查缓存 ```` **配置（在config.yaml中）：** d2: # 主题选择主题：“北” # 图像缩放规模：1.5 **尺寸控制：** ```d2 +渲染 +宽度:70% A -> B -> C ```` ### 乳胶公式将 LaTeX 数学公式渲染为图像。 **要求：** * 安装 [typst](): `brew installtypst` 或 `cargo installtypst-cli` * 安装 [pandoc](): `brew install pandoc` **它是如何工作的：** * Pandoc 将 LaTeX 转换为 Typst * Typst 将公式渲染为图像 **语法：** ```乳胶+渲染 \[ \sum_{n=1}^{\infty} 2^{-n} = 1 \] ```` ```乳胶+渲染 \[ E = mc^2 \] ```` ```乳胶+渲染 \[ \int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi} \] ```` ```乳胶+渲染 \[ \frac{d}{dx}\left( \int_{a}^{x} f(u)\,du\right) = f(x) \] ```` ```乳胶+渲染 \[ \开始{b矩阵} a & b \\ 和d \end{b矩阵} \] ```` **配置（在config.yaml中）：** # 公式渲染的每英寸像素数打字员：像素密度：300 **尺寸控制：** ```乳胶+渲染+宽度：60% \[ \oint_C \mathbf{F} \cdot d\mathbf{r} = \iint_S (\nabla \times \mathbf{F}) \cdot d\mathbf{S} \] ```` ### 打字公式直接渲染打字公式（绕过 LaTeX 转换）。 **要求：** * 安装 [typst](): `brew installtypst` **语法：** ```打字员+渲染 $ sum_(n=1)^oo 1/n^2 = pi^2/6 $ ```` ```打字员+渲染 $ 积分_(-oo)^oo e^(-x^2) d x = sqrt(pi) $ ```` ```打字员+渲染 $ 垫（ 1, 2; 3、4； ) $ ```` **相对于 LaTeX 的优点：** * 更快（没有 pandoc 转换步骤） * 原生打字语法 * 更现代的公式排版 ### 渲染配置 **全局config.yaml设置：** # 公式渲染打字员： ppi: 300 # 公式的每英寸像素数 # 美人鱼图美人鱼：主题：黑暗背景：“#2E3440” 规模：2.0 # d2 图 d2: 主题：“北” 规模：1.5 ### 完整渲染示例 # 系统架构 ```d2 +渲染 +宽度:80% 用户：用户{ 形状：人 } lb：负载均衡器{ 形状: 长方形 } api: API 服务器 { 形状: 长方形 } 数据库：数据库{ 形状: 圆柱体 } 用户 -> 磅 lb -> api: 分发 api -> 数据库：查询 ```` --- # 请求流程 ``美人鱼+渲染序列图参与者 U 作为用户参与者 A 作为 API 参与者 D 作为数据库参与者C作为缓存 U->>A：请求数据 A->>C：检查缓存替代缓存命中 C-->>A：返回缓存数据否则缓存未命中 A->>D：查询数据库 D-->>A：返回数据 A->>C：更新缓存结束 A-->>U：响应 ```` --- # 算法复杂度 ```乳胶+渲染 \[ T(n) = \begin{案例} O(1) & \text{最佳情况} \\ O(\log n) & \text{平均情况} \\ O(n) & \text{最坏情况} \结束{案例} \] ```` --- # 数学公式 ```打字员+渲染 $ P(A|B) = (P(B|A) 点 P(A)) / P(B) $ ```` ## 图像协议 # 自动检测最佳协议 Presenterm --image-protocol 自动演示.md # 使用iTerm2协议 Presenterm --image-protocol iterm2presentation.md # 使用kitty协议（本地模式） Presenterm --image-protocol kitty-localpresentation.md # 使用kitty协议（远程模式） Presenterm --image-protocol kitty-remotepresentation.md # 使用 Sixel 协议 Presenterm --image-protocol Sixelpresentation.md # 使用 ASCII 块（后备） Presenterm --image-protocol ascii-blockspresentation.md ## 主题 ### 内置主题 # 列出所有可用的主题演示者--列表主题 # 常见主题： Presenterm -t 黑暗演示文稿.md Presenterm -t 轻演示.md Presenterm -t catppuccin 演示文稿.md Presenterm -t 德古拉presentation.md Presenterm -t gruvboxpresentation.md Presenterm -t monokaipresentation.md Presenterm -t Nord 演示文稿.md Presenterm -t 日晒-暗演示文稿.md Presenterm -t 日光照射演示文稿.md ### 自定义主题 # 使用配置中的自定义主题 Presenterm -c ~/.config/presenterm/config.yamlpresentation.md Presenterm --config-file custom-config.yamlpresentation.md ## 演讲者备注模式 ### 发布演讲者笔记 # 将演讲者笔记发布到本地网络 Presenterm -P 演示文稿.md Presenterm --publish-speaker-notes 演示文稿.md # 聆听演讲者笔记（演讲者的观点）演示者-l Presenterm --听演讲者笔记这使您能够： * 在一个屏幕上运行演示 * 在另一个设备/屏幕上查看演讲者笔记 * 非常适合双显示器设置 ## 验证 # 验证幻灯片不会溢出终端 Presenterm --validate-overflowspresentation.md # 验证代码片段 Presenterm --validate-snippetspresentation.md # 合并验证 Presenterm --validate-overflows --validate-snippetspresentation.md ## 键盘控制 ### 演示期间导航： ←/→ 上一张/下一张幻灯片空格/Enter 下一张幻灯片退格键上一张幻灯片首页第一张幻灯片结束最后一张幻灯片 g 转到特定幻灯片（输入数字）显示： f 切换全屏 q/Esc 退出演示文稿代码执行： e 执行代码块（带有 -x 标志）帮助：？显示帮助/控件 ## 配置 ### 配置文件位置 # 默认配置位置： # - Linux: ~/.config/presentterm/config.yaml # - macOS：~/Library/Application Support/presentterm/config.yaml # - Windows:%APPDATA%\presentterm\config.yaml # 指定自定义配置 Presenterm -c /path/to/config.yamlpresentation.md ### 配置示例 # 配置.yaml 主题：卡布奇辛图像协议：自动 # 默认选项演示模式：真 validate_overflows：true # 代码执行启用片段执行：假 ## 常见工作流程 ### 工作流程 1：创建简单的演示文稿 # 1.创建markdown文件猫 > demo.md << 'EOF' # 欢迎 ## 演示者演示 --- # 主要特点 - 基于终端 - Markdown 语法 - 多个主题 - 导出为 PDF/HTML --- # 谢谢你！问题？ EOF # 2. 运行演示 Presenterm -p demo.md # 3.导出为PDF Presenterm -e demo.md -o demo.pdf ### 工作流程 2：使用代码进行技术演示 # 1. 使用代码示例创建演示文稿猫 > tech-talk.md << 'EOF' # 技术深入探讨 ## Rust 异步编程 --- # 基本示例 ``生锈异步 fn fetch_data() -> 结果 <字符串，错误> { 让响应 = reqwest::get("https://api.example.com") .等待？ response.text().await } ```` --- # 现场演示 ```bash +exec 货物--版本 rustc——版本 ```` --- # 有问题吗？ EOF # 2. 启用代码执行 Presenterm -x -p tech-talk.md # 3. 分享前验证 Presenterm --validate-overflows --validate-snippets tech-talk.md # 4. 导出分发 Presenterm -e tech-talk.md -o tech-talk.pdf ### 工作流程 3：双屏演示 # 终端 1（带注释的演示者视图） Presenterm -P 演示文稿.md # 终端 2（或其他设备 - 观众视图）演示者-l # 这显示： # - 1 号航站楼：完整演示，演讲者备注可见 # - 终端 2：跟随演示者的同步视图 ### 工作流程 4：主题企业演示 # 1. 创建带有公司主题的配置 mkdir -p ~/.config/presentterm 猫 > ~/.config/presentterm/config.yaml << 'EOF' 主题：日光演示模式：真 validate_overflows：true EOF # 2. 创建演示文稿 vim 季刊评论.md # 3. 主题预览 Presenterm 季刊评论.md # 4. 导出并应用主题 Presenterm -e 季度评论.md -o 季度评论.pdf # 5. 同时导出 HTML 版本 Presenterm -E季度评论.md -o季度评论.html ### 工作流程 5：会议演讲 # 会议演讲模板 --- # 关于我 ![个人资料](./images/profile.png) - 姓名 - 标题 - 公司 - 推特：@handle --- # 议程 1. 问题陈述 2. 我们的方法 3. 演示 4. 结果 5. 问答 --- # 问题陈述 ## 挑战 - 第 1 点 - 第2点 - 第3点 --- # 现场演示 ```bash +exec ./演示.sh ```` --- # 结果 |公制|之前 |之后 |改进| |--------|--------|--------|-------------| |速度| 100 毫秒 | 10 毫秒 | 10 倍 | |内存| 500MB | 50MB | 10 倍 | - - ＃谢谢你！＃＃问题？幻灯片：https://example.com/slides 代码：https://github.com/user/repo ## 最佳实践 ### 幻灯片设计 1. **每张幻灯片一个想法**：保持幻灯片聚焦 2. **最少文本**：使用项目符号，而不是段落 3. **视觉层次**：有效使用标题 4. **代码可读性**：保持代码片段简短易读 5. **一致的格式**：始终使用相同的样式 ### 文件组织演示/ ├── Slides.md # 主要演示 ├── images/ # 图片资源 │ ├── 标志.png │ ├── 图1.png │ └── 截图.png ├── code/ # 代码示例 │ ├── 例子1.rs │ └── 演示.py └── export/ # 导出版本 ├── 幻灯片.pdf └── 幻灯片.html ### 演讲者备注 # 幻灯片标题可见内容 ### 代码示例 1. **语法高亮**：始终指定语言 2. **保持简短**：每张幻灯片最多 10-15 行 3. **突出关键部分**：使用注释来引起注意 4. **测试代码** ：确保示例正确 5. **谨慎使用 exec** ：仅用于有影响力的演示 ### 演示前验证 # 完整的验证清单 Presenterm --validate-overflowspresentation.md Presenterm --validate-snippetspresentation.md Presenterm -ppresentation.md # 试运行 Presenterm -epresentation.md # 生成备份PDF ## 提示和技巧 ### 快速演示模板 # 从模板创建新的演示文稿猫 > new-talk.md << 'EOF' # 演讲标题 ## 副标题你的名字 --- # 概要一、简介二、主要内容三、结论 --- # 第 1 节内容在这里 --- #谢谢你有问题吗？ EOF ### 快速迭代 # 在开发过程中使用 watch 进行实时重新加载 #（需要“entr”或“watchexec”） # 随着输入回声演示.md |进入演示者/_ # 使用watchexec watchexec -w 演示文稿.md 演示文稿演示.md ### 导出所有格式 #!/bin/bash # export-all.sh - 将演示文稿导出为所有格式演示=“$1” BASENAME="${PRESENTATION%.md}" echo“正在导出$PRESENTATION...” # PDF Presenterm -e "$PRESENTATION" -o "${BASENAME}.pdf" echo "✓ PDF 已导出" # HTML Presenterm -E“$PRESENTATION”-o“${BASENAME}.html” echo "✓ HTML 已导出" echo "全部导出完成！" ### 演示清单 ## 演示前检查清单技术： - [ ] 运行验证：`presentterm --validate-overflows slips.md` - [ ] 测试代码执行块 - [ ] 验证图像正确加载 - [ ] 检查字体大小可见性 - [ ] 在实际演示屏幕上测试 - [ ] 导出备份 PDF 内容： - [ ] 计时（练习贯穿） - [ ] 演讲者备注完整 - [ ] 过渡平滑 - [ ] 没有错别字 - [ ] 链接有效设置： - [ ] 终端字体大小可读 - [ ] 适合场地的主题 - [ ] 在 USB 上备份演示文稿 - [ ] 电源适配器 - [ ] HDMI/适配器电缆 ## 故障排除 ### 图像不显示 # 尝试不同的图像协议 Presenterm --image-protocol iterm2presentation.md Presenterm --image-protocol kitty-localpresentation.md Presenterm --image-protocol ascii-blockspresentation.md # 后备 # 检查图像路径是相对还是绝对 # 确保图像存在 ls -la 图片/ ### 幻灯片溢出终端 # 首先验证 Presenterm --validate-overflowspresentation.md # 解决方案： # 1.减少每张幻灯片的内容 # 2. 增加终端尺寸 # 3. 使用较小的字体 # 4.分成多张幻灯片 ### 代码执行不工作 # 确保执行已启用 Presenterm -x 演示文稿.md # 检查脚本权限 chmod +x 脚本.sh # 首先独立测试代码块 ### 主题未应用 # 列出可用主题演示者--列表主题 # 检查当前主题演示者--当前主题 # 明确指定主题 Presenterm -t 黑暗演示文稿.md # 检查配置文件位置 ls -la ~/.config/presentterm/config.yaml ## 与其他工具集成 ### 使用 Git # 跟踪版本控制中的演示文稿 git初始化 git add 演示文稿.md 图片/ git commit -m“壮举：添加初始演示” # 为不同版本创建标记版本 git tag -a v1.0 -m "会议版本" ### 使用 make/just # 只是文件目前： Presenterm -p幻灯片.md 出口： Presenterm -e幻灯片.md -o输出.pdf Presenterm -E幻灯片.md -o输出.html 验证： Presenterm --validate-overflows幻灯片.md Presenterm --validate-snippets slips.md 全部：验证导出 ### 持续集成 # .github/workflows/validate-presentation.yml 名称：验证演示文稿上：[推，拉请求] 职位：验证：运行：ubuntu-latest 步骤： - 使用：actions/checkout@v2 - 名称：安装演示者运行：cargo install Presenter - 名称：验证幻灯片运行： | Presenterm --validate-overflowspresentation.md Presenterm --validate-snippetspresentation.md - 名称：导出 PDF 运行：presenterm -epresentation.md -opresentation.pdf - 名称：上传 PDF 使用：actions/upload-artifact@v2 与：名称：演示路径：演示文稿.pdf ## 快速参考 # 基本用法 Presenterm Slides.md # 查看演示文稿 Presenterm -p Slides.md # 演示模式 Presenterm -t dark Slides.md # 带主题 # 导出 Presenterm -e Slides.md # 导出为 PDF Presenterm -E Slides.md # 导出为 HTML Presenterm -e Slides.md -o out.pdf # 自定义输出路径 # 验证 Presenterm --validate-overflows幻灯片.md Presenterm --validate-snippets slips.md # 代码执行 Presenterm -x Slides.md # 启用执行 Presenterm -X Slides.md # 自动替换执行 # 主题 Presenterm --list-themes # 列出主题 Presenterm --current-theme # 显示当前主题 # 演讲者备注 Presenterm -P Slides.md # 发布笔记 Presenterm -l # 听笔记 # 帮助 Presenterm --help # 完整帮助 Presenterm --acknowledgements # 显示致谢 Presenterm -V # 版本 ## Markdown 快速参考 # 滑动分隔符 --- # 标题 # H1 ## H2 ### H3 # 列表 - 要点 - 嵌套子弹 1. 编号项目 # 代码块 ``语言代码在这里 ```（三个反引号） # 图片 ![替代文本](path/to/image.png) # 表 |第 1 列 |第 2 栏 | |------|------| |一个 |乙| # 引号 > 引用文字 # 演讲者备注 # 可执行代码 ```bash +exec 命令 ```（三个反引号） # 渲染图 ``美人鱼+渲染图解TD 甲-->乙 ```（三个反引号） ```d2 +渲染甲->乙 ```（三个反引号） # 渲染公式 ```乳胶+渲染 \[ E = mc^2 \] ```（三个反引号） ```打字员+渲染 $ sum_(i=1)^n i = (n(n+1))/2 $ ```（三个反引号） ## 资源 * 官方存储库： * 文档： * 问题跟踪器： * 安装： `brew install Presenterm` 或 `cargo install Presenterm` ## 总结 **主要指令：** 1. 用 Markdown 编写演示文稿 2. 使用演示模式（`-p`）进行实际演示 3. 使用高级渲染：mermaid/d2 用于图表，LaTeX/typst 用于公式 4. 包括复杂幻灯片的演讲者注释 5. 展示前验证 6. 导出为 PDF/HTML 以便分发 7. 为场地/观众选择合适的主题 8. 保持幻灯片简单且重点突出 9. 在呈现之前测试代码执行和渲染块 **最常用的命令：** * `presentterm -p Slides.md` \- 当前 * `presentterm -e Slides.md` \- 导出 PDF * `presenterm -t theme Slides.md` \- 使用主题 * `presenterm --validate-overflows slips.md` \- 验证 * `presentterm --list-themes` \- 查看主题 **高级渲染：** * 美人鱼图：````mermaid +render`（需要 mermaid-cli） * d2 图：````d2 +render`（需要 d2） * LaTeX 公式： ` ```latex +render` （需要typst + pandoc） * Typst 公式：````typst +render`（需要 Typst）

演示者

包含技能