在多個文件中分割時聲明defproc或deform（函數/宏文檔）模塊

Question

在塗鴉中，我可以使用defproc和defform來定義函數或宏的文檔。然後塗抹文件使用文件中最接近的defform來確定函數/宏定義在哪個模塊中。

但是，有時候將同一模塊的文檔分散到多個塗鴉文件中有時是有意義的。

（說，如果你想爲一個init函數的文檔是在repl.scrbl，你婉的find文檔中api.scrbl。但他們兩人都在同一模塊中定義的，說repl.rkt。）

然而當有在文檔同一defmodule的多個substantiations，塗鴉抱怨：

WARNING: collected information for key multiple times: '(index-entry (mod-path "zordoz")); values: (list '("zordoz") (list (link-element (style "RktModLink" (list 'tt-chars #0=(list (css-addition '(collects #"scribble" #"racket.css")) (tex-addition '(collects #"scribble" #"racket.tex"))))) (cached-element (style "RktSym" (list 'tt-chars #0#)) "zordoz... (list '("zordoz") (list (link-element (style "RktModLink" (list 'tt-chars #0=(list (css-addition '(collects #"scribble" #"racket.css")) (tex-addition '(collects #"scribble" #"racket.tex"))))) (cached-element (style "RktSym" (list 'tt-chars #0#)) "zordoz... 
WARNING: collected information for key multiple times: '(mod-path "zordoz"); values: '#(("REPL") (mod-path "zordoz") (2) (doC#"main" #"index.html") #f) '#(("API") (mod-path "zordoz") (3) (doC#"main" #"index.html") #f) 
raco setup: rendering: <pkgs>/zordoz/scribblings/main.scrbl 
WARNING: collected information for key multiple times: '(index-entry (mod-path "zordoz")); values: (list '("zordoz") (list (link-element (style "RktModLink" (list 'tt-chars #0=(list (css-addition '(collects #"scribble" #"racket.css")) (tex-addition '(collects #"scribble" #"racket.tex"))))) (cached-element (style "RktSym" (list 'tt-chars #0#)) "zordoz... (list '("zordoz") (list (link-element (style "RktModLink" (list 'tt-chars #0=(list (css-addition '(collects #"scribble" #"racket.css")) (tex-addition '(collects #"scribble" #"racket.tex"))))) (cached-element (style "RktSym" (list 'tt-chars #0#)) "zordoz... 
WARNING: collected information for key multiple times: '(mod-path "zordoz"); values: '#(("REPL") (mod-path "zordoz") (2) (doC#"main" #"index.html") #f) '#(("API") (mod-path "zordoz") (3) (doC#"main" #"index.html") #f) 

那麼，有沒有什麼辦法可以記錄多個塗鴉文件兩種功能，即使他們是DEF在同一個模塊中？

Answer 1

如果這兩個文件都列爲另一個文件的小節，說main.rkt，你可以把defproc在文件和其他兩個文件將使用它作爲defproc和defform模塊。

例如：

#lang scribble/manual 

@title{Zordoz} 

@defmodule[zordoz] 
@include-section[repl.scrbl] 
@include-section[api.scrbl]