RDoc :更改ri-documentation中“Atttributes：”部分的名称

Question

我正在使用一些元编程来生成ruby中的一堆方法，如下所示：

class EmotionalObject
  def self.mood( name, *details )
    define_method(name) do
      # ...
    end
  end

  mood :happy, #...
  mood :sad, #...
  mood :ebuillent, #...
  #...
 end

我知道我可以通过rdoc '-A mood‘让它将我的情绪生成代码识别为属性，这很方便，因为它们至少可以被识别出来。

但是，它们实际上更像是常规方法，而不是属性，所以当我使用ri查看文档时，我不希望它们列在' attributes :‘部分下面。我没有任何常规属性，所以有没有什么简单的方法可以把这个部分的标题改为'Moods:‘或者类似的东西，这样我的用户至少会好奇地输入ri EmotionalObject#happy。

Answer 1

它被硬编码到RDoc模板中，但是您可以通过复制默认的"html“模板并手动更改标题名称来创建一个新的模板来使用。

请在此处查看RDoc模板源代码：http://github.com/juretta/ruby/blob/master/lib/rdoc/generator/html/html.rb#L601。

Answer 2

似乎在RDoC2.4.1中的某个地方，他们删除了--accessor，代之以在每个元方法上使用##注释。虽然这允许您将它们从attributes部分中取出，但它也迫使您对每个属性分别进行注释。

http://rdoc.rubyforge.org/RDoc/Parser/Ruby.html