朋辈辅学「实用技能拾遗」课程仓库

课程介绍

2023 年春夏学期浙江大学计算机学院朋辈辅学课程「实用技能拾遗」单周周日下午班。课程内容、目标为一些基础、实用但学校课程中并不会讲解的技能的介绍。

课程内容索引见 https://slides.tonycrane.cc/PracticalSkillsTutorial/。

关于 slides

构建与部署

原版指南

1. 安装 reveal-md

   $ npm install -g reveal-md

2. 在浏览器中实时预览

   $ reveal-md main.md -w

3. 构建静态文件

   $ reveal-md main.md --static site --assets-dir assets

   • 生成 pdf 版：在 url 后面加上 ?print-pdf 使用浏览器打印
4. 部署
   • 很蠢的一个实现，总之就是用 Action 把 site 文件夹中的内容复制到我的另一个私有 repo 中，然后在那个 repo 里部署 GitHub Pages
   • 构建出 site 文件夹后 commit & push，message 需要以 [deploy] 开头

本课程所有 slides 都使用 reveal-md，源码都在 slides/src/ 目录中，同时包含了一个简单的 Makefile 用来更方便地预览和构建。

• 实时预览

  $ make         # 仅 lec0
  $ make LECNO=1 # lec1

• 单个 slides 构建

  $ make build         # 仅 lec0
  $ make LECNO=1 build # lec1

• 构建全部 slides

  $ make all

• 清除全部 slides

  $ make clean

用法

和 reveal-js 的快捷键一致，在页面中按下 ? 可以查看所有快捷键。常用的：

• N / SPACE：下一页
• P / Shift SPACE：上一页
• ← / H：翻到左边页面
• → / L：翻到右边页面
• ↑ / K：翻到上边页面
• ↓ / J：翻到下边页面
• B / .：暂停（黑屏）
• F：全屏
• ESC / O：显示概览
• S：打开演讲者窗口