ruby - 如何使用 RDoc 标记呈现逐字/代码/前置加号？

Question

使用 RDoc 标记并使用 Yard 生成文档，我正在尝试记录一些命令输出，其中包含如下一行:

+----------------------------------+

...但无法弄清楚如何实现这一点。我怎样才能得到 HTML:

<pre class="code">
  +----------------------------------+
</pre>

我确定我在文档中遗漏了一些微不足道的东西......

---

尝试 #1

在不尝试转义标记的情况下，我缩进了这 2 个空格(与任何其他代码/pre block 一样):

+----------------------------------+

...生成文档，并获取 HTML(如预期的那样，我想):

<pre class="code">
  <tt>----------------------------------</tt>
</pre>

---

尝试 #2

如果我使用反斜杠转义，这个标记:

\+----------------------------------+

...变成这个 HTML:

<pre class="code">
  \+----------------------------------+
</pre>

---

尝试 #3

奇怪的是，如果我连续使用两个加号，这个标记:

++----------------------------------+

...变成这个 HTML:

<pre class="code">
  ++----------------------------------+
</pre>

---

尝试 #4

使用未缩进 <tt>只给我留下了一个非“逐字”(即前/代码)部分；只是纯文本(再次，正如我想的那样):

<tt>+----------------------------------+</tt>

...变成这个 HTML:

<p>
  <tt>-------------------------------------</tt>
</p>

---

尝试#5

使用缩进 <tt>变成这个标记:

<tt>+----------------------------------+</tt>

...到这个 HTML 中:

<pre class="code">
  <tt>+----------------------------------+</tt>
</pre>

Answer 1

这是一个错误并在院子里修复:https://github.com/lsegal/yard/issues/403 .