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

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

您的问题的答案可以在section 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

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