SuperAPI AI 工具集

typst-test-slide

测试与质量

查看项目

更新于 10-15 21:37

技能介绍

用途:当需要测试、隔离、调试或预览单张 Typst 幻灯片时使用,用于单独渲染一张幻灯片做调试或视觉确认。它是一个配方(recipe),不是完整工作流。

主要能力与解决的问题:Typst 无法访问项目根目录之外的文件,若把测试文件建在 /tmp/,每次 #import 和 #image() 都会报 access denied。该技能给出正确模式,并预防几类常见错误:测试文件在 /tmp/ 导致 #import 报 access denied(应放到项目内 output/);图片路径解析到项目根外导致 #image() 报 access denied(应从 output/ 用 ../assets/);相对层级写错导致 #import 报 file not found(output/ 只有一层深,用 ../templates/ 而非 ../../templates/);缺少 #show: university-theme.with(...) 前导导致幻灯片只渲染成文本。

使用方式:第一步在 output/ 下创建测试文件,例如 cat > output/test-slide.typ << 'EOF',内容包含 #import "../templates/theme.typ": * 与 #show: university-theme.with(...) 前导,并在 #slide[ ] 中粘贴幻灯片内容。第二步从项目根目录用 tinymist compile --root . output/test-slide.typ /tmp/test-slide.png --ppi 144 编译,--root . 指明项目根为当前目录,使 output/ 下的 ../templates/ 正确解析。第三步用 rm -f output/test-slide.typ 清理。

关键规则:始终在 output/ 创建,绝不放 /tmp/ 或项目根之外;始终在项目根目录用 --root . 编译;从 output/ 出发路径上溯一层(../templates/、../assets/);从 slides/XX-topic/ 出发上溯两层(../../templates/、../../assets/),不要混淆层级;完成后删除测试文件,output/ 虽被 gitignore,但残留测试文件会造成混淆。

限制:资料未提供该技能支持的 Typst 版本、依赖插件安装细节及更多参数说明。