3 个版本 (破坏性更新)
0.3.0 | 2020 年 4 月 16 日 |
---|---|
0.2.0 | 2019 年 3 月 17 日 |
0.1.0 | 2019 年 3 月 11 日 |
#13 in #slide
24KB
605 行
Deck
Deck 是一个命令行工具,可以将 Markdown 文档转换为 HTML 演示文稿。
输入
幻灯片以 Markdown 编写。水平线(---
)用于分隔每个幻灯片。
用法
构建
一个 Markdown 文件可以通过单个文件中的单个命令转换为 HTML 演示文稿。默认情况下,生成的 HTML 包含一些内联 CSS 和 JavaScript,以正确渲染幻灯片。如果您想进一步自定义输出,可以使用 --css
和 --js
选项传递额外的 CSS 和 JavaScript 文件。生成的文档可以在大多数现代浏览器中打开。
deck build < slides.md > slides.html
服务
您还可以使用内置服务器提供 Markdown 幻灯片。以下命令将演示文稿提供给 https://127.0.0.1:8000/slides
deck serve slides.md -p 8000
在编写您的演示文稿时,您可能需要查看生成的 HTML 演示文稿的演变。通过在先前的命令中添加 -
和将 ?watch=true
添加到先前的 URL,将确保在修改 Markdown 幻灯片、自定义 CSS 或自定义 JavaScript 时网页会重新加载。
语法高亮
语法高亮可以以多种方式自定义。首先,build
和 serve
命令都允许您使用 --theme
选项选择不同的主题。默认情况下,只有少数几个主题可用,如此处列出。
deck build --theme InspiredGitHub < slides.md > slides.html
此外,执行所有代码高亮重任务的 syntect
包能够加载所有 TextMate 和 Sublime Text .tmTheme
颜色方案。为了加载本地主题,您必须首先将其目录添加到二进制文件将查找兼容主题的路径列表中,然后使用 --theme
选择它。假设 gruvbox.tmTheme
位于 ./themes
目录下,命令调用可能如下所示:
deck build --theme-dir ./themes --theme gruvbox < slides.md > slides.html
待办事项
- 演讲者备注
- 计时器
依赖关系
~22-35MB
~561K SLoC