asciinema 是一个终端会话录制和回放工具。通过 :::asciinema 指令,你可以在博客文章中嵌入录制好的终端回放。
基础示例
下面是一段简单的终端操作演示:
使用方式
在 Markdown 文件中使用 :::asciinema 指令:
:::asciinema{src="/casts/demo.cast"}markdown录制 .cast 文件
使用 asciinema CLI 录制终端会话:
# 安装
brew install asciinema # macOS
sudo apt install asciinema # Ubuntu
# 录制
asciinema rec demo.cast
# 录制指定命令
asciinema rec -c "pnpm run build" build-demo.cast
# 设置空闲压缩
asciinema rec -i 2 demo.castbash按 Ctrl+D 或输入 exit 结束录制。将生成的 .cast 文件放到 public/casts/ 目录即可引用。
自动播放
设置 autoPlay 可自动开始播放:
指令属性
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
src | string | 必填 | .cast 文件路径 |
cols | string | 80 | 终端列数 |
rows | string | 24 | 终端行数 |
speed | string | 1 | 播放速度倍率 |
idleTimeLimit | string | 2 | 空闲时间压缩阈值(秒) |
fit | string | "width" | 自适应模式 |
autoPlay | string | false | 是否自动播放 |
loop | string | false | 是否循环播放 |
播放器会自动跟随博客的亮色/暗色主题切换。
评论区
文明评论,共建和谐社区