背景

日常工作汇报、演讲经常需要制作PPT,一般使用这些标准工具 Microsoft PowerPointApple KeynoteGoogle 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 1
Slide 2

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

Slide 1

这里有一些内容

1
2
2

添加 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 忽略这种限制。

相关命令

# 启动 reveal-md slides.md -w # 生成 Html 默认目录_static reveal-md slides.md --static # 生成 Html 默认目录_static,指定图片目录 assets reveal-md slides.md --static --static-dirs=assets # 导出PDF reveal-md slides.md --print slides.pdf reveal-md slides.md --print slides.pdf --print-size 1024x768 reveal-md slides.md --print slides.pdf --print-size A4

幻灯片主题

默认主题

名称

效果

black

黑色背景,白色文本,蓝色链接(默认)

white

白色背景,黑色文本,蓝色链接

league

灰色背景,白色文字,蓝色链接

beige

米色背景,深色文字,棕色链接

sky

蓝色背景,细暗文本,蓝色链接

night

黑色背景,厚白色文字,橙色链接

serif

卡布奇诺背景,灰色文本,棕色链接

simple

白色背景,黑色文本,蓝色链接

solarized

高分辨率照片

blood

深色背景,厚白文字,红色链接

moon

高分辨率照片

自定义主题

  1. 下载 reveal git clone git@github.com:hakimel/reveal.js.git ;
  2. 在 /css/theme/coder.scss 中复制一个文件;
  3. 运行 npm run build -- css-themes 生成css dist/coder.css;
  4. 运行指定主题 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": "^nnn", // 幻灯片垂直切割标志 "verticalSeparator": "^nn" }

用法

当需要在 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

<meta charset="utf-8"> {{pageTitle}} <link rel="stylesheet" href="{{{themeUrl}}}" id="theme">

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

默认的 reveal.html

<meta charset="utf-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no"> {{{title}}} {{#absoluteUrl}} <meta property="og:title" content="{{{title}}}"> <meta property="og:type" content="website"> <meta property="og:image" content="{{{absoluteUrl}}}/featured-slide.jpg"> <meta property="og:url" content="{{{absoluteUrl}}}"> {{/absoluteUrl}} <link rel="shortcut icon" href="{{{base}}}/favicon.ico"> <link rel="stylesheet" href="{{{base}}}/dist/reset.css"> <link rel="stylesheet" href="{{{base}}}/dist/reveal.css"> <link rel="stylesheet" href="{{{themeUrl}}}" id="theme"> <link rel="stylesheet" href="{{{base}}}{{{highlightThemeUrl}}}"> {{#cssPaths}} <link rel="stylesheet" href="{{{.}}}"> {{/cssPaths}} {{#watch}} {{/watch}} {{{slides}}} {{#scriptPaths}} {{/scriptPaths}}

运行本地调试

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

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

domain

配置成功如下

https://slides.onlythinking.com