如何使用 Asciidoctor 为文字块设置行号？

如何解决如何使用 Asciidoctor 为文字块设置行号？

我的技术文档包含一些示例，显示了一些操作的控制台输出。

我猜这种类型的内容的正确标记是[literal] .... Hi world! .... ，因为它不是源代码。

linenums

我还想要文字文本的行号，因为如果您可以命名，它有时有助于更轻松地找到特定行。

不能使用 source 属性，至少看起来是这样，而且我不想被迫使用 results 进行控制台输出，因为我必须为源块的内容。

有什么想法吗？我错过了什么？

解决方法

添加行号是一个演示问题，就其本身而言，asciidoctor 不会为您执行此操作。目前，该作业已委派给当前配置的源荧光笔。

您必须在每个应显示行号的源块上指定 linenums 属性。

AFAIK，只有 rouge 或 pygments 源荧光笔支持 PDF 的行号。

对于 HTML 输出，您可以选择向页面添加一些 JavaScript，这些 JavaScript 可以初始化源荧光笔以在任何地方包含行号，包括文字文本块。您如何做到这一点取决于您使用的源荧光笔。

对于源代码块，语言是可选的。如果您使用其他属性，则必须指定一种语言，但您可能可以使用 text 语言（如 @BallpointBen 建议的那样）。