Scribble文档:两个简单文件之间的交叉引用

时间:2015-12-08 16:38:48

标签: racket cross-reference scribble

documentation for scribble(Racket文档工具)说“一起呈现的文档中的交叉引用始终已解析”,但下面的文件a.scrbl无法引用文件{{}中的部分1}}

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.scrbl部分?

1 个答案:

答案 0 :(得分:2)

It seems to work if you remove the <pre> My page-specific code.... <ng-include src="'partials/common-code.html'"></ng-include> </pre> argument.

#:doc

This might create an ambiguity though if you use the same tags in both documents, so you may have to change tag names or use your own tag prefixes.

I'm not sure why the relative path for #lang scribble/base @secref["sectag"] doesn't work as you expect. Maybe it is only used for referring to collection-installed documents.