asciidoc - 如何使用 AsciiDoctor 进行自定义类 HTML 划分？

Question

我从 AsciiDoctor 开始，我想输出 HTML。我一直在试图弄清楚如何在部门中创建自定义类，我搜索了谷歌、手册等，但找不到解决方案。我想做的只是写这样的东西：

Type the word [userinput]#asciidoc# into the search bar.

生成 HTML

<span class="userinput">asciidoc</span>

但我想要 div 标签而不是 span。有什么办法可以做到，或者我应该使用类似的东西 +++<div class="userinput">asciidoc</span>+++吗？

Answer 1

我认为您需要的是 Asciidoctor 中的“角色”。

这个例子：

This is some text.

[.userinput]
Type the word asciidoc into the search bar.

This is some text.

产生：

<div class="paragraph">
<p>This is some text.</p>
</div>
<div class="paragraph userinput">
<p>Type the word asciidoc into the search bar.</p>
</div>
<div class="paragraph">
<p>This is some text.</p>
</div>

您现在有一个div.userinput用于相关 div 的 css 选择器。

见13.5。在 Asciidoctor 用户手册中设置元素的属性（您也可以搜索“角色”）。

Answer 2

您可能希望为此目的使用开放块：

Type the following commands:

[.userinput]
--
command1

command1
--

生产：

<div class="paragraph">
  <p>Type the following commands:</p>
</div>
<div class="openblock userinput">
  <div class="content">
    <div class="paragraph">
      <p>command1</p>
    </div>
    <div class="paragraph">
      <p>command1</p>
    </div>
  </div>
</div>

优点是它可以包装任何其他块，并且不仅限于一个段落，就像另一个答案一样。

对于稍微不同的用例，您还可以考虑定义自定义样式。