背景

日常工作汇报、演讲经常需要制作PPT，一般使用这些标准工具 Microsoft PowerPoint、Apple Keynote 或 Google Slides 。但这些工具对我来说过于繁琐，我希望有一个简单且支持 markdown 的工具，很幸运我找到了RevealJS，它是一个开源的 HTML 幻灯片框架，制作出精美的PPT，对于web开发人员来说更是首选。

入门

reveal.js 使用 nodejs 构建，需要提前安装好 nodejs。下载启动访问http://localhost:8000 就可以看到一个演示PPT。

git clone git@github.com:hakimel/reveal.js.git
mv reveal.js slides-demo
cd slides-demo
npm install
npm start

使用 Vscode 打开 index.html 制作，一个 section 就是一页幻灯片。

Slide 1Slide 2

每张幻灯片是从左到右线性切换，如果需要在同一页垂直过渡切换，可以嵌套section 。

        Slide 1这里有一些内容122

添加 data-background 可以给幻灯片添加一个背景。

来吧！展示

添加 fragment 设置内容动画，每次展示一个内容。比如以此呈现列表，只需添加一个 class="fragment".

片段顺序第一个第二个最后一个

添加图片，在项目里创建 assets 目录存放图片，然后引入。

插入

Reveal-md

直接编辑 Html 比较麻烦，我还是习惯在 markdown 里编辑内容。使用reveal-md 可以将 markdown 转换成 Html，或导出PDF。

安装

npm install -g reveal-md

npm 6.x 版本安装会出现权限错误，需要添加 --unsafe-perm=true

sudo npm install -g reveal-md --unsafe-perm=true

--unsafe-perm=true：“false if running as root, true otherwise”，大体意思是 npm 的安全限制，root身份运行时不会查询 root 的上下文，所以 sudo 运行时还需要指定 --unsafe-perm=true 忽略这种限制。

幻灯片主题

默认主题

名称	效果
black	黑色背景，白色文本，蓝色链接（默认）
white	白色背景，黑色文本，蓝色链接
league	灰色背景，白色文字，蓝色链接
beige	米色背景，深色文字，棕色链接
sky	蓝色背景，细暗文本，蓝色链接
night	黑色背景，厚白色文字，橙色链接
serif	卡布奇诺背景，灰色文本，棕色链接
simple	白色背景，黑色文本，蓝色链接
solarized	高分辨率照片
blood	深色背景，厚白文字，红色链接
moon	高分辨率照片

自定义主题

下载 reveal git clone git@github.com:hakimel/reveal.js.git ；
在 /css/theme/coder.scss 中复制一个文件；
运行 npm run build -- css-themes 生成css dist/coder.css；
运行指定主题 reveal-md slides.md -w --theme theme/coder.css。

切换时动画

名称	效果
none	瞬间切换背景
fade	交叉淡入淡出 - 背景转换的默认值
slide	在背景之间滑动 — 幻灯片过渡的默认设置
convex	以凸角滑动
concave	以凹角滑动
zoom	向上缩放传入的幻灯片，使其从屏幕中心向内扩展

配置

我们可以在Markdown文件里通过 yaml 进行配置

title: Slides # 幻灯片名称
theme: solarized # 幻灯片主题
highlightTheme: github # 代码高亮主题
revealOptions: 
  transition: 'convex' # 动画效果

reveal 其它配置项

{
  // 显示控制箭头
  controls: true,
  // 循环播放
  loop: false
  // 更多参考 https://revealjs.com/config/
}

reveal-md 其它配置项

{
  // 幻灯片横行切割标志
  "separator": "^\n\n\n",
  // 幻灯片垂直切割标志
  "verticalSeparator": "^\n\n"
}

用法

当需要在 section 中添加属性时，Markdown 的写法如下

当需要在其它元素插入属性时，Markdown 的写法如下

一些例子，设置背景色或背景图

设置 fragment

- Item1 
- Item2

指定代码的高亮顺序

```js [1-2|3|4|5]
let a = 1;
let b = 2;
let c = x => 1   2   x;
c(3);
c(2);
```

地址跳转

[跳转0](#/0)

部署到Netlify

我喜欢将一些静态html托管到netlify，它免费比较好用。先在 Github 创建一个仓库 coder_slides，然后创建如下目录

├── README.md
└── content
    ├── assets
    │   └── bg.jpeg
    ├── template
    │   ├── listing.html
    │   └── reveal.html
    └── coder.md

content 放MD文件集合；
assets 本地图片资源；
template 是渲染后的 HTML 模版，包含列表页面和详情页面，可以自行修改。

默认的 listing.html

{{pageTitle}}{{#files}}
          {{#title}}{{.}} ({{filePath}}){{/title}}{{^title}}{{filePath}}{{/title}}        
      {{/files}}

默认的 reveal.html

{{{title}}}{{#absoluteUrl}}{{/absoluteUrl}}{{#cssPaths}}{{/cssPaths}}

    {{#watch}}document.write(
        ''
      );{{/watch}}{{{slides}}}function extend() {
        var target = {};
        for (var i = 0; i {{#scriptPaths}}{{/scriptPaths}}Reveal.initialize(options);

运行本地调试

reveal-md content/ --template template/reveal.html --listing-template template/listing.html

list

如何部署部署到netlify？

注册一个netlify，然后创建一个站点关联上github仓库。

在配置/部署里面添加构建命令

npm install -g reveal-md && reveal-md content/ --static --static-dirs=content/assets --template template/reveal.html --listing-template template/listing.html

然后在域名管理添加一个自己的域名