幻灯片生成工具

幻灯片（Marp+Kroki）

此文件夹包含以下内容构建的幻灯片 Marp命令行界面 以及Kroki图引擎。

先决条件

• Node.js（LTS）
• Docker+Docker Compose（用于在本地运行Kroki）

安装

• 安装依赖项（Marp CLI已在中列出 package.json):

npm install

在本地启动Kroki

• Kroki的Docker Compose设置包含在此项目中 ./kroki.
• 在提供幻灯片之前启动它（Marp配置为使用 http://localhost:8000):

cd kroki
docker compose up -d
# Kroki should now listen on http://localhost:8000

提供幻灯片（允许使用本地资源）

从该目录以服务器模式运行Marp，使其能够 marp.config.js 和那个 slides/ 内容：

npx marp -s -c marp.config.js --allow-local-files
# → Server: http://localhost:8080/

笔记：

• 这 --allow-local-files 需要标记，因为幻灯片包含来自的本地图像/资源 slides/.
• 短期选择 -c 必须直接跟在配置文件路径后面(-c marp.config.js).

项目布局

• 幻灯片条目： slides/pres.md
• Marp配置（启用Kroki）： marp.config.js

故障排除

• 错误：“找不到或解析配置文件（EISDIR）”--确保命令使用 -c marp.config.js 在其他旗帜之前：

# Correct
npx marp -s -c marp.config.js --allow-local-files

# Common mistake (will fail)
# npx marp -s -c --allow-local-files marp.config.js

• 确保Kroki在 http://localhost:8000 在渲染图表之前。Marp配置将Marp/Kroki指向此端点。