/
quarkdown c <file> 是将主源文件编译为可在浏览器中渲染的输出的命令。
所有可用选项请参阅命令行选项 页面。
Quarkdown 使用一套权限系统来控制编译期间可访问的内容。如果文档尝试执行某项需要权限但它并未拥有的操作,就会引发编译错误。
默认情况下,文档会被授予一组默认权限。你可以使用 --allow 和 --deny 选项来授予或撤销权限:
quarkdown c main.qd --allow network --allow global-read最终权限集合的计算方式为:默认权限 + 已允许 - 已拒绝。
| 名称 | 说明 |
|---|---|
project-read | 读取项目目录内的文件 (默认) |
global-read | 读取整个文件系统中的文件,包括项目目录之外 |
network | 通过网络访问远程资源(例如获取远程媒体) |
native-content | 嵌入原生内容,例如原始 HTML 与 CSS (默认) |
process | 访问宿主进程环境(例如读取环境变量 ) |
all | 上述所有权限的简写 |
project-read、global-read和network仅在编译器需要访问某项资源时才会被请求。例如,在渲染为 HTML 时:
- 以下情况需要
project-read,因为 HTML 输出会启用媒体存储系统 ,编译器需要处理该图片文件:- 以下情况不需要
network,因为编译器不会访问该资源,而是让 URL 原样通过,交由浏览器处理: