CLI 命令
@foliolang/cli 提供 5 个子命令。
init
folio init
交互式向导,生成示例 article.md + folio.config.json + .env.example。
build
folio build article.md [--theme default|academic|minimal] [--inline] [--pdf]
| flag | 说明 |
|---|---|
--theme |
主题选择(默认 default) |
--inline |
asset 全部内联到单 HTML(无外部依赖) |
--pdf |
同时输出 article.pdf(需 puppeteer,本地装一份) |
输出 article.html + (可选)article.assets/ 目录。
dev
folio dev article.md [--port 5173]
启动本地 server,文件变化自动重编 + 浏览器刷新。
publish
folio publish article.md --target cloudflare|github|netlify|s3 [--slug my-article]
发布到配置的 target,返回 URL。env 需对应 token / API key 配好。
cache
folio cache stats # 看缓存命中率 + 估算花费
folio cache clean # 清空内容寻址缓存
退出码
build 在以下情况退出码非 0:
- 源文件读取失败
- 某个 engine 失败导致出错(HTML 仍会输出,含错误占位)