2

Ruby 1.9.2p138 で Rdoc 2.58 を使用しています。Darkfish 形式 (これが唯一のオプション) を使用して rdoc ファイルを生成すると、ソース コードのプレビューが表示されません。エラー メッセージは表示されず、すべてのクラスの HTML ファイルが生成されています。

gem を更新してヘルプ ファイルを読んでみましたが、この問題を解決する方法が見つかりません。

これは既知の問題ですか? 他に何を試すことができますか？

アップデート：

コード例:

class Iamaclass
    def initialize
        @name = "superclass"
    end

    def get_name
        @name
    end

    def proud?
        true
    end
end

Rdoc 2.5.8 出力

Parsing sources...
100% [ 1/ 1]  someruby.rb                                                       

Generating Darkfish...

Files:         1
Classes:       1 (    1 undocumented)
Constants:     0 (    0 undocumented)
Modules:       0 (    0 undocumented)
Methods:       3 (    3 undocumented)
  0.00% documented

Elapsed: 0.0s

ソース コードは、生成された rdoc でトグルしません。

Rdoc 3.5.3 の出力

100% [ 1/ 1]  someruby.rb                                                       

Generating Darkfish format into /Users/paul/dev/alesrelated/someruby/doc...

Files:      1

Classes:    1 (1 undocumented)
Modules:    0 (0 undocumented)
Constants:  0 (0 undocumented)
Attributes: 0 (0 undocumented)
Methods:    3 (3 undocumented)

Total:      4 (4 undocumented)
  0.00% documented

Elapsed: 0.1s

ソース コードは html 出力でトグルします。

4

1 に答える 1

2

コードにコメントを追加する必要があります。たとえば、これを使用して試すことができます。

# A description about this class
class Iamaclass
 # A description about this method
 def initialize
    @name = "superclass"
 end

 # Another description about some other method
 def get_name
    @name
 end

 def proud?
    true
 end
end

この後、rdoc コマンドを再度実行してみてください。

于 2011-05-21T22:00:05.190 に答える