5

我有以下方法，我想使用YARDoc.

# Here is my method
# @arg woop [Woop] *dangerous* this parameter is output to the screen
def shoop(woop)
  puts woop
end

dangerous这会生成以粗体显示的HTML 。因为我必须解析这个输出，所以我想要一个自定义 HTML 标记。换句话说，我想让它在下面的代码注释被解析时YARDoc，这个词dangerous被<div class="custom"></div>标签包围，而不是<b><\b>标签，这使得用 Nokogiri 解析更容易。并不是说目前无法使用 Nokogiri 进行解析，它只是有点尴尬并且容易受到 YARD 代码更改的影响。

# Here is my method
# @arg woop [Woop] **dangerous** this parameter is output to the screen
def shoop(woop)
  puts woop
end

YARD 中是否有任何功能可以让我做到这一点？我查看了创建自定义模板，但这似乎更多地涉及解析代码。然后我检查了创建自定义降价模板，但我没有看到这可以或应该如何完成。我开始觉得我在找错树了，我会很感激谷歌关键词给我的。

为什么我首先要解析 HTML：
正如我在前面的问题中所描述的，我正在尝试定义一个接口而不必复制代码。在此示例中，我希望服务器“调用”危险的方法与不危险的方法不同。

4

1 回答 1

5

Markdown 允许您包含内联 html。所以也许尝试：

# Here is my method
# @arg woop [Woop] <div class="custom">dangerous</div> this ....
def shoop...
...

如果这可行，那么您可以覆盖doc/css/common.css文件中的默认 css。

于 2013-11-01T09:03:52.467 回答