调试Scribble的错误(需要一个解码的预部件)

Question

请考虑下面的Scribble文档：

#lang scribble/manual

@title[#:tag "MyTitle"]{MyTitle}

@(module bq racket/base
    (require scribble/html/html)
    (provide blockquote))
@(require 'bq)

@blockquote{
   "Ho, ho, ho! -- Santa Claus."
}

如果我尝试用scribble --dest . test.scrbl构建它，它将失败

/Users/varun/Code/test.scrbl:10:0: not valid in document body (need a pre-part for decode) in: (element 'blockquote '() '("\"Ho, ho, ho! -- Santa Claus.\"") #f)
  context...:
   body of "/Users/varun/Code/test.scrbl"
   .../private/map.rkt:40:19: loop
   .../racket/cmdline.rkt:191:51
   body of "/Applications/Racket v8.0/share/pkgs/scribble-lib/scribble/run.rkt"

我不明白这个错误。它指的是什么“前部分”？我发现了一个描述类似错误的博客文章“用拼字笔写论文”；问题是一个数字没有转换成一个字符串。但是，我这里有一个字符串，所以我不明白问题是什么。

Answer 1

基于萨姆在回答中所说的话，以及一个Twitter上类似的评论，我最终定义了一个区块引语：

@(require scribble/core scribble/decode)
@(define (blockquote . strs)
      (make-nested-flow (make-style "blockquote" '(command))
                        (decode-flow strs)))

(资料来源：https://sourcegraph.com/github.com/flock-lab/flock/-/blob/docs/main.scrbl?L9-L11)

这可以不用引号：

@blockquote{Ho, ho, ho! -- Santa Claus.}

Answer 2

问题是scribble/html没有连接到scribble/manual，而在那里构造的“元素”有一个HTML。您不能在这样的文档中使用来自scribble/html的函数。

如果您希望在拼字中使用块引号，则可能需要使用nested-flow。