自定义YARD降价

Question

我有以下方法,我想使用它来记录YARDoc.

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

这会生成HTML格式的dangerous粗体.因为我必须解析此输出,所以我希望有一个自定义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:
正如我在之前的问题中所描述的那样,我试图定义一个接口而不必重复代码.在这个例子中,我希望服务器"调用"一种危险的方法,而不是一种非危险的方法.

Answer 1

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

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

如果这有效，则您可以覆盖doc/css/common.css文件中的默认 css 。