2

使用 RDoc 标记并使用 Yard 生成文档,我正在尝试记录一些具有如下行的命令输出:

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

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

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

我确定我错过了文档中的一些琐碎内容......


尝试#1

在不试图逃避标记的情况下,我缩进了这 2 个空格(就像任何其他代码/预块一样):

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

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

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

尝试#2

如果我使用反斜杠转义,则此标记:

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

...变成这个 HTML:

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

尝试#3

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

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

...变成这个 HTML:

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

尝试#4

使用 unindented<tt>只会给我留下一个非“逐字”(即 pre/code)部分;只是纯文本(再次,正如预期的那样,我想):

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

...变成这个 HTML:

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

尝试#5

使用 indented<tt>会改变这个标记:

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

...进入这个 HTML:

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

1 回答 1

0

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

于 2013-07-03T22:32:47.433 回答