问题标签 [scribble]

我从这里有这个简单的 Hello world 代码，但找不到 line xsd是什么意思，以及如何使用它。该文件位于何处，是否有必要？

我有以下使用参考书目的涂鸦文档：

文档的结果如下所示：

参考书目部分的标题是“BIBLIOGRAPHY”，但我实际上希望它的标题是“REFERENCES”，这可以通过涂鸦实现，还是我必须投入到乳胶黑客中？

我正在用 Scribble 写一篇技术论文。该文件包含一个表格。我正在用tabular. 到现在为止还挺好。

我想使桌子居中，但用包裹起来tabular没有centered效果。帮助！

我正在用该scribble/acmart语言创建一个 pdf。如何在我的文档中添加页码？

我有一个file.scrbl用于制作 PDF ( ) 的 Scribble 文档 ( scribble --pdf file.scrbl)。我想制作 PDF 的大字体横向版本。

有没有一种简单的方法可以file.scrbl让 Scribble 输出大字体 PDF？

我想要一种像涂鸦/文本这样的语言，但提供了一些额外的功能。这是我尝试过的：

当我尝试运行用这种语言编写的模块时，我收到一条消息，指出该模块的语言中没有 #%module-begin 绑定。

我假设 scribble/text 具有#%module-begin 的绑定，否则当我将它用作#lang 时它是如何工作的？

也许 scribble/text 知道我使用 'require' 而不是 #lang 来导入它，所以我不会自动获取 #% 宏？如果是这种情况，那么我将如何获得它们并重新出口它们？

还是这里发生了其他事情？

我知道 Racket 不像许多其他语言那样具有“文档字符串”，但考虑到在源代码记录事物的便利性，我想在 Racket 中近似类似的东西。

当我第一次了解 Scribble 和#langs 时，我认为可以执行以下操作：

...然后在 Racket 中使用 Scribble 中的文档字符串编写代码。但这不起作用，可能是因为“语言不会组合”。

这导致：

我发现scribble/srcdoc这似乎很有吸引力，因为它听起来允许您在合同之上搭载文档，这些合同已经作为一种最小（通常是模块级）文档，当然除了提供运行时检查。到目前为止，我还无法让它工作，但与其再折腾几个小时，我认为在这里询问它会更有用。对于它的价值，这就是我目前所看到的：

这导致：

由于像这样的参考文档比如何使用它更能解释事物的工作原理，因此我正在寻找一个更多关于在 Racket 中编写“文档字符串”的方法的答案。它不需要很长，足以帮助读者在他们的代码中使用这种“合同+文档字符串”模式（并且可能描述其他替代方案）。

有没有可能

正确链接时在哪里bar定义？deftechbar

我正在尝试链接到第三方（而不是核心）库（特别是data/collection）提供的 Scribble 文档，但我无法让它工作。

通过这些进口：

以下链接到 Racket 内置文档有效：

但是这个，到data/collection版本：

...导致以下错误：

我还尝试使用@tech标签，例如：

我尝试了几种变体，但无法让它工作——我在扫描文档时无法发现的一件事，例如这里，是lib链接的工作原理——路径到底指的是什么? 显然，“涂鸦”不是指本地涂鸦文件夹，而是某种全局文档路径。但是如何知道特定库的文档使用什么路径呢？对于上面提出的主要问题，这可能是次要问题，但是您可以在此处阐明的任何信息都会有所帮助。

在为函数编写 Scribble 文档时，我想链接到一个内置函数，该函数与记录在同一个 Scribble 文件中的不同函数同名。通常@racketlink可用于此目的（以及区分文档名称空间中的两个函数之类的东西），但是当链接需要位于表单prefix-in的参数部分中时，这似乎不起作用。@defproc例如：

注意上面的两种用法b:compose。后一个链接b:compose简单地呈现为compose（如预期的那样），但如果我在前一个实例中尝试相同的代码（在参数块中），它呈现为(racketlink b:compose "compose"). 如何“逃避”对defproc参数块中内容的字面处理？这是否与 Scribble 的“内容”和“前内容”概念以及“解码”过程有关？