演讲者视图

¥Speaker View

reveal.js 附带一个演讲者备注插件，可用于在单独的浏览器窗口中显示每张幻灯片的备注。备注窗口还会提供下一张即将播放的幻灯片的预览，因此即使你没有做任何备注，它也可能对你有所帮助。按键盘上的 »S« 键可打开备注窗口。

¥reveal.js comes with a speaker notes plugin which can be used to present per-slide notes in a separate browser window. The notes window also gives you a preview of the next upcoming slide so it may be helpful even if you haven't written any notes. Press the »S« key on your keyboard to open the notes window.

演讲者计时器会在演讲者视图打开后立即启动。你可以通过点击计时器来重置它。

¥A speaker timer starts as soon as the speaker view is opened. You can reset the timer by clicking on it.

注释是通过将 <aside> 元素附加到幻灯片来定义的，如下所示。如果你更喜欢使用 Markdown 撰写注意，可以将 data-markdown 属性添加到 aside 元素。

¥Notes are defined by appending an <aside> element to a slide as seen below. You can add the data-markdown attribute to the aside element if you prefer writing notes using Markdown.

或者，你也可以在幻灯片的 data-notes 属性中添加注释。类似 <section data-notes="Something important"></section>。

¥Alternatively you can add your notes in a data-notes attribute on the slide. Like <section data-notes="Something important"></section>.

在本地使用时，此功能需要 reveal.js 从本地 Web 服务器运行。

¥When used locally, this feature requires that reveal.js runs from a local web server.

<section>
  <h2>Some Slide</h2>

  <aside class="notes">
    Shhh, these are your private notes 📝
  </aside>
</section>

如果你使用的是 Markdown 插件，你可以借助特殊分隔符添加注释：

¥If you're using the Markdown plugin, you can add notes with the help of a special delimiter:

<section data-markdown="example.md" data-separator="^\n\n\n"
         data-separator-vertical="^\n\n" data-separator-notes="^Note:">
# Title
## Sub-title

Here is some content...

Note:
This will only display in the notes window.
</section>

添加演讲者备注插件

¥Adding the Speaker Notes Plugin

该插件已与 reveal.js 打包在一起。要启用演讲者备注插件，请将插件源添加到 index.html，并将插件添加到 reveal.js 的初始化中。

¥The plugin is already bundled with reveal.js. To enable the speaker notes plugin, add the plugin source to the index.html and add the plugin to the initialization of reveal.js.

<script src="plugin/notes/notes.js"></script>
<script>
  Reveal.initialize({
    plugins: [RevealNotes],
  });
</script>

共享和打印演讲者备注

¥Share and Print Speaker Notes

注释仅在演讲者视图内对演讲者可见。如果你希望与他人分享你的注意，可以初始化 reveal.js，并将 showNotes 配置值设置为 true。注释将显示在演示文稿的底部。

¥Notes are only visible to the speaker inside of the speaker view. If you wish to share your notes with others you can initialize reveal.js with the showNotes configuration value set to true. Notes will appear along the bottom of the presentations.

启用 showNotes 后，注释也会包含在 导出为 PDF 中。默认情况下，注释会打印在幻灯片顶部的方框中。如果你希望将它们打印在单独的页面上，请在幻灯片播放结束后设置 showNotes: "separate-page"。

¥When showNotes is enabled notes are also included when you export to PDF. By default, notes are printed in a box on top of the slide. If you'd rather print them on a separate page, after the slide, set showNotes: "separate-page".

演讲者备注时钟和计时器

¥Speaker Notes Clock and Timers

演讲者备注窗口还将显示：

¥The speaker notes window will also show:

  • 演示开始后已用时间。如果将鼠标悬停在此部分上方，将出现一个计时器重置按钮。

    ¥Time elapsed since the beginning of the presentation. If you hover the mouse above this section, a timer reset button will appear.

  • 当前挂钟时间

    ¥Current wall-clock time

  • （可选）一个节奏计时器，用于指示演示的当前节奏是否符合正确时间（显示为绿色），如果不符合，则指示演示者是否应该加快速度（显示为红色）或是否允许减速（显示为蓝色）。

    ¥(Optionally) a pacing timer which indicates whether the current pace of the presentation is on track for the right timing (shown in green), and if not, whether the presenter should speed up (shown in red) or has the luxury of slowing down (blue).

可以通过配置 Reveal 配置块中的 defaultTiming 参数来启用节奏计时器，该参数指定每张幻灯片的播放秒数。120 是一个合理的经验法则。或者，你可以通过设置 totalTime 来启用计时器，这会设置演示文稿的总长度（也以秒为单位）。如果同时指定了两个值，则 totalTime 优先，defaultTiming 会被忽略。无论基准计时方法如何，都可以通过设置 data-timing 属性（同样以秒为单位）为每个幻灯片 <section> 指定计时。

¥The pacing timer can be enabled by configuring the defaultTiming parameter in the Reveal configuration block, which specifies the number of seconds per slide. 120 can be a reasonable rule of thumb. Alternatively, you can enable the timer by setting totalTime, which sets the total length of your presentation (also in seconds). If both values are specified, totalTime wins and defaultTiming is ignored. Regardless of the baseline timing method, timings can also be given per slide <section> by setting the data-timing attribute (again, in seconds).

服务器端演讲者备注

¥Server Side Speaker Notes

在某些情况下，可能需要在与演示设备不同的设备上运行注意。基于 Node.js 的 notes 插件允许你使用与客户端版本相同的注释定义来实现此目的。请参阅 https://github.com/reveal/notes-server。

¥In some cases it can be desirable to run notes on a separate device from the one you're presenting on. The Node.js-based notes plugin lets you do this using the same note definitions as its client side counterpart. See https://github.com/reveal/notes-server.