使用 pdf/latex 后端在涂鸦中创建一个新页面

Question

在 Latex 中，我可以使用 \newpage 命令创建一个新页面。似乎没有任何方法可以直接在 Scribble 中执行此操作（至少对于 PDF/Latex 后端没有。）

那么，如何强制 scribble 为我的文档创建新页面？

Answer 1

是的，这是可行的。然而，它有点笨拙，并且仅在呈现为乳胶文件（或 pdf 文件）时有效，因为这对网页没有意义。我必须这样做的原始方法进入了 LaTeX。然而，事实证明有一种方法可以完全保持在涂鸦中。无论您喜欢哪个，显然都取决于上下文，所以我将两个选项都放在这里。

选项 1：完全在涂鸦选项中

其工作方式是使用涂鸦 styles with a string for its name. Doing so turns the style into a LaTeX environment or command (depending on what you put it into.) In our case, we want a command, so we will use an element。生成的代码将如下所示：

(define (newpage)
  (make-element (style "newpage" '())
                '()))

现在你可以在任何地方使用 newpage 函数，latex 会插入一个 \newpage.

选项 2：插入生乳胶：

另一种选择是在涂鸦文件中插入一些原始乳胶代码。为此，您首先需要创建一个文件，例如：textstyle.tex，并在该文件中输入：

\newcommand{\identity}[1]{#1}

文件名无关紧要，如果里面有其他命令也可以。这只是为了创建一个乳胶命令，该命令仅评估其给定的相同文本。

接下来，您可以在涂鸦代码的某处创建以下两个函数：

(define (exact . items)
  (make-element (make-style "identity" '(exact-chars))
                items))

(define (newpage)
  (exact "\newpage"))

第一个函数定义了exact，我们可以用它来插入latex代码。这是有效的，因为 exact-chars 样式将字符逐字传递到乳胶中，并且不会通过任何类型的预处理器传递。我们在这里需要 identity 阶梯，这样 latex 就可以将文本放入其中。

newpage函数然后在latex中直接翻译成\newpage。只需在代码中将其命名为 (newpage)（或使用 at 表达式时 @newpage[]/@(newpage)）。

最后，您需要告诉 scribble 在哪里可以找到 texstyle.tex 文件。当运行涂鸦时，您可以使用 ++style 标志来做到这一点。总之，您的命令应该类似于：

scribble --pdf ++style texstyle.tex mydocument.scrbl

另外，如果您希望文档为任何后端编译而不仅仅是 latex/pdf，您可以使用 cond-element。这样你就可以让它成为任何其他后端的空元素：

(define (exact-latex . items)
  (cond-element [latex
                  (make-element (make-style "identity" '(exact-chars))
                                items)]
                [else ....]))

(define (newpage)
  (exact-latex "\newpage"))

使用 pdf/latex 后端在涂鸦中创建一个新页面

Create a new page in scribble with pdf/latex backend

pdf

latex

racket

scribble

选项 1：完全在涂鸦选项中

选项 2：插入生乳胶：