RDoc: Изменить название «аттрибуты:» раздел в ри-документации

Question

Я использую некоторые мета-программирования, чтобы создать набор методов в рубин, как так:

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

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

Я знаю, что я могу передать rdoc '-A mood', чтобы распознать мое настроение код генерации в качестве атрибутов, который удобен, с тех пор они, по крайней мере, получают признание.

Однако, на самом деле они больше похожи на обычных методов, чем атрибуты, так я не хочу, чтобы они перечислены под «Атрибуты:» раздел, когда я смотрю в документации с использованием ri. У меня нет никаких обычных атрибутов, , так что есть простой способ, я могу просто изменить заголовок этого раздела, чтобы быть «Настроение:» или что-то в этом роде, поэтому пользователям, по крайней мере, достаточно любопытно ввести ri EmotionalObject#happy.

Answer 1

Он жестко закодирован в шаблоны RDoc, но вы можете создать новый шаблон для дублирования шаблона по умолчанию «html» и вручную изменить название заголовка.

См. Источник шаблона RDoc здесь: http://github.com/juretta/ruby/blob/master/lib/rdoc/generator/html/html.rb#L601.

Answer 2

Похоже, что где-то в районе rdoc 2.4.1 они удалили --accessor и заменили его на ## комментариями к каждому мета-методу. Хотя это позволяет вам вывести их из раздела атрибутов, это также заставляет вас прокомментировать каждый по отдельности.

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