使用指南
浏览演示、添加讲稿，以及在本地预览和构建站点。
浏览与演示
从首页选择一份演示文稿，点击封面或标题即可进入。首页支持按标题、描述和分类搜索。
| 按键 | 操作 |
|---|---|
→ / 空格 |
下一页或显示下一项 |
← |
返回上一页 |
F |
切换全屏 |
S |
打开演讲者窗口，查看备注与计时 |
O |
打开幻灯片总览 |
演讲者窗口适合放在笔记本屏幕上，演示页面则显示在投影或共享屏幕上。该功能会打开独立窗口，请使用支持弹出窗口的浏览器。
添加新演示
复制仓库中的模板，在 talks/ 下创建一个以主题命名的 .qmd 文件。例如，在 PowerShell 中执行：
Copy-Item _templates/deck.qmd talks/my-topic.qmd修改文件开头的标题、描述、日期和分类，再编写每页内容：
---
title: 我的技术分享
description: 用一句话说明这次分享的主题。
date: 2026-10-06
categories: [技术分享]
---
## 为什么要讨论这个问题
给出背景和目标。
## 我的方案
展示方法和结果。每个二级标题（##）开启一页幻灯片。公共演示设置位于 talks/_metadata.yml，首页会在构建后自动收录新讲稿，无需手动修改目录。
图片统一放在 assets/，从讲稿中使用相对路径，例如 ../assets/my-topic.png。如需在首页显示封面，在讲稿的 front matter 中增加 image 字段。
本地预览与构建
安装 Quarto，然后在 slides/ 目录运行：
quarto preview预览服务会随源文件保存而更新。发布前完整构建一次：
quarto render构建结果保存在 _site/，可部署到静态托管服务。若站点位于子路径下，保留输出目录的完整结构，页面与资源采用相对链接。
内容与样式
- 用
.notes区块保存演讲备注，观众页面不会直接展示它们。 - 用
.incremental区块让列表逐项显示，帮助控制讲解节奏。 - 网站样式位于
styles/site.scss，演示样式位于styles/slides.scss。 - 提交源文件和素材；
_site/、.quarto/与本地工具目录.tools/无需提交。