我如何启用";单击以切换“源”;Ruby RDoc中的按钮?

我如何启用";单击以切换“源”;Ruby RDoc中的按钮?,ruby,rubygems,rdoc,Ruby,Rubygems,Rdoc,使用Darkfish RDoc生成器生成RDoc文档时,在每个方法旁边都有一个单击以切换源代码按钮。当我生成文档时,它对我不起作用,所以如何让该功能发挥作用,您是否需要在RDoc源代码中添加关键字或其他内容? 它似乎是默认启用的。我刚刚尝试了使用rdoc v2.5.11进行快速测试:- $ mkdir temp $ cd temp $ cat temp.rb class MyClass def my_method; end end $ rdoc Parsing sources... 10

使用Darkfish RDoc生成器生成RDoc文档时,在每个方法旁边都有一个
单击以切换源代码
按钮。当我生成文档时,它对我不起作用,所以如何让该功能发挥作用,您是否需要在RDoc源代码中添加关键字或其他内容?

它似乎是默认启用的。我刚刚尝试了使用rdoc v2.5.11进行快速测试:-

$ mkdir temp
$ cd temp
$ cat temp.rb

class MyClass
  def my_method; end
end

$ rdoc
Parsing sources...
100% [ 1/ 1]  temp.rb                                                           

Generating Darkfish...

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

Elapsed: 0.1s
$ open doc/index.html
当我点击
#my_method
的链接并将鼠标悬停在该方法的描述上时,我会看到“单击以切换源代码”链接,当我点击该链接时,它就会工作


您需要在浏览器中启用javascript才能执行此操作。

默认情况下似乎已启用。我刚刚尝试了使用rdoc v2.5.11进行快速测试:-

$ mkdir temp
$ cd temp
$ cat temp.rb

class MyClass
  def my_method; end
end

$ rdoc
Parsing sources...
100% [ 1/ 1]  temp.rb                                                           

Generating Darkfish...

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

Elapsed: 0.1s
$ open doc/index.html
当我点击
#my_method
的链接并将鼠标悬停在该方法的描述上时,我会看到“单击以切换源代码”链接,当我点击该链接时,它就会工作


您需要在浏览器中启用javascript才能实现此功能。

我的Rails3代码也有同样的问题。它非常通用,我不记得使用过RDoc设置,但是我的
点击切换源代码也不起作用。我知道JS是打开的,当我运行
rake doc:app
时,他们没有出现任何错误,所以我不太确定发生了什么

我唯一能想到的是,我正在RVM下运行Ruby 1.9.2/Rails 3.0.0。这有区别吗


更新:我注意到它试图从
js
目录加载不存在的Javascript文件。RDoc应该插入JS文件还是您应该手动插入?

我的Rails3代码也有同样的问题。它非常通用,我不记得使用过RDoc设置,但是我的
点击切换源代码也不起作用。我知道JS是打开的,当我运行
rake doc:app
时,他们没有出现任何错误,所以我不太确定发生了什么

我唯一能想到的是,我正在RVM下运行Ruby 1.9.2/Rails 3.0.0。这有区别吗


更新:我注意到它试图从
js
目录加载不存在的Javascript文件。RDoc应该插入JS文件,还是您应该手动插入?

我也遇到同样的问题,并在中找到了丢失的文件。 我在doc/app/js目录中手动复制了它们,现在单击以切换源代码。
这至少是一个快速修复方法。

我遇到了同样的问题,并在中找到了丢失的文件。 我在doc/app/js目录中手动复制了它们,现在单击以切换源代码。
这至少是一个快速解决方案。

这是与rvm一起工作的旧版本rdoc中的一个问题。我对2.5.8版本也有同样的问题。模板目录的路径包含.rvm,因此不会将图像和js目录复制到生成的文档中。 作为修复,您可以在lib/rdoc/generator/darkfish.rb文件中更改这一行代码

next if path =~ /#{File::SEPARATOR}\./


感谢Rubyforge.com上的Jeremy Bopp(发现了这个问题的根源)和Gordon Thiesfeld(给出了解决方案),这是与rvm合作的旧版本rdoc中的一个问题。我对2.5.8版本也有同样的问题。模板目录的路径包含.rvm,因此不会将图像和js目录复制到生成的文档中。 作为修复,您可以在lib/rdoc/generator/darkfish.rb文件中更改这一行代码

next if path =~ /#{File::SEPARATOR}\./


感谢Rubyforge.com上的Jeremy Bopp(发现了这个问题的根源)和Gordon Thiesfeld(给出了解决方案)

好的,谢谢你让我知道默认情况下它是打开的。这意味着我的设置有问题,因为我在Safari 5上运行时启用了JS。。。所以idk是什么导致的。好的,谢谢你让我知道它是默认打开的。这意味着我的设置有问题,因为我在Safari 5上运行时启用了JS。。。所以idk是什么引起的。我不知道lol。我们有相同的设置,所以如果你碰巧发现如何修复它,请更新你的答案。呃,我想我要换成院子了。这是现在所有酷孩子玩的地方,它的“Show Source”工作正常。我不知道lol。我们有相同的设置,所以如果你碰巧发现如何修复它,请更新你的答案。呃,我想我正在切换到YARD。这是现在所有酷孩子都在玩的地方,而且它的“秀源”运作正常。