html - 通过滚动保持无趣的代码可访问

Question

如果我用 处理以下asciidoc文件asciidoctor，

Here is our first program:
[source,cpp]
----
// Uninteresting/Potboiler line
// Uninteresting/Potboiler line
// Uninteresting/Potboiler line
// Uninteresting/Potboiler line
// Interesting line
// Interesting line
// Uninteresting/Potboiler line
// Uninteresting/Potboiler line
// Uninteresting/Potboiler line
// Uninteresting/Potboiler line
----

结果如下所示：

但通常（如上面的代码中所暗示的）有趣的关键是简短的。

在这种情况下，我可以通过仅引用有趣的行并添加指向完整源文件的链接来保持整个 HTML 简洁。这会使读者脱离上下文，并迫使他们在 HTML 导航中前进/后退。

相反，我正在寻找一种方法来保持通过在 html 页面中滚动来访问完整代码，同时只显示有趣的部分。这可能与 asciidoctor 吗？

Answer 1

您的问题的答案可以在第 49.1 节关于包含的文档中找到。为了把所有东西放在一起，我也会在这里举一个简单的例子。

执行包含时使用标签或行部分。如果你使用线条，它看起来像：

include::my_file[lines=5..7]

如果您决定使用标签（哪个 imo 更好，因为您不太可能使两者不同步），它将如下所示：

include::my_file[tags=interesting_part]

然后my_file看起来像

Uninteresting line
Uninteresting line
Uninteresting line
// tag::interesting_part[]
Interesting line
Interesting line
// end::interesting_part[]
Uninteresting line
Uninteresting line

对要包含的文件中的特定文件类型使用正确的任何类型的注释。