Skip to content
Go back

Asciinema 终端回放

使用 AsciinemaPlayer 组件在博客中嵌入终端会话回放,展示命令行操作。

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.cast
bash

Ctrl+D 或输入 exit 结束录制。将生成的 .cast 文件放到 public/casts/ 目录即可引用。

自动播放

设置 autoPlay 可自动开始播放:

指令属性

属性类型默认值说明
srcstring必填.cast 文件路径
colsstring80终端列数
rowsstring24终端行数
speedstring1播放速度倍率
idleTimeLimitstring2空闲时间压缩阈值(秒)
fitstring"width"自适应模式
autoPlaystringfalse是否自动播放
loopstringfalse是否循环播放

播放器会自动跟随博客的亮色/暗色主题切换。



上一篇
为什么选择 astro-minimax:设计决策与技术思考
下一篇
Excalidraw 白板:在博客中嵌入手绘风格图表

评论区

文明评论,共建和谐社区