/

本页目录

命令行 - 编译器

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-readglobal-readnetwork 仅在编译器需要访问某项资源时才会被请求。

例如,在渲染为 HTML 时:

  • 以下情况需要 project-read,因为 HTML 输出会启用媒体存储系统 ,编译器需要处理该图片文件:
    ![Image](path/to/image.png)
  • 以下情况不需要 network,因为编译器不会访问该资源,而是让 URL 原样通过,交由浏览器处理:
    ![Image](https://example.com/image.png)