racket - Scribble 文档：两个简单文件之间的交叉引用

Question

scribble的文档（Racket 文档工具）说“在一起呈现的 [...] 文档中的交叉引用总是被解析”，但a.scrbl下面的文件未能引用文件中的部分b.scrbl

a.scrbl：

#lang scribble/base
@secref["sectag" #:doc "b.scrbl"]

b.scrbl：

#lang scribble/base
@section[#:tag "sectag"]{A section}

用 编译它们时scribble --html a.scrbl b.scrbl，我得到：

Warning: some cross references may be broken due to undefined tags:
 (part ("/path/to/b.scrbl" "sectag"))

如何引用b.scrblfrom中的部分a.scrbl？

Answer 1

#:doc如果您删除参数，它似乎有效。

#lang scribble/base
@secref["sectag"]

如果您在两个文档中使用相同的标签，这可能会产生歧义，因此您可能必须更改标签名称或使用自己的标签前缀。

我不确定为什么 for 的相对路径#:doc不能按预期工作。也许它只用于引用集合安装的文档。