Grove与文档模型[glossary-grove]

  • tree(树):可独立寻址的一段内容,有地址、标题和可选元数据。
  • root page(页面):一个.plant文件对应的顶层tree;文件名就是页面地址。
  • subtree:在文档中声明一棵嵌套tree的命令;需要长期引用时用#:id给稳定地址。
  • address(地址):具名tree的#:id或页面的文件名;未命名tree获得unstable-NNNN形式的临时地址。
  • transclude(嵌入):按ID查询森林,把目标tree的正文放在当前位置,并保留来源;不导入程序binding。
  • link(链接):指向tree ID的阅读引用,不建立Scheme依赖。
  • taxon:tree的种类;写小写英文名,大小写不敏感,显示时首字母大写并加句点。
  • tag:主题标签,和taxon一样是可查询的内容节点。
  • frontmatter(元数据):title、summary、published、updated等,属于各自的tree。
  • content tree(内容树):命令与文本解析后的结构化结果,是分析和渲染的输入。
  • forest(森林):全站页面与tree组成的内容集合;跨文章查询在分析阶段基于它。
  • 读取(reading):解析.plant并对其中Scheme求值;示例核验也在此进行。
  • 分析(analyzing):建立forest与关系,例如content-node relation。
  • 渲染(rendering):把内容树生成HTML或其他artifact。
  • checked:读取时通过核验;不表示浏览器实时运行,也不等于形式化证明。
  • backlinks/related/context:森林中的阅读关系,可折叠查看;不等于程序requires。