ruby - 为本地安装的 gem 生成 RDOC

Question

我正在尝试为我最近感兴趣的 gem - 内斯塔做出贡献。开发人员在创建您能找到的最轻、最薄的 CMS 之一方面做得非常出色，我想记录下来。据我所知，我通读了代码并对一些方法进行了评论。

但是，我试图通过调用 gem server 并在将其发布到网上之前查看我机器上的更改来在本地进行测试。

我尝试过的事情:

1. 手动编辑。
   • 记录文件。
   • 启动 gem 服务器。
2. 使用gem 工具。
   • 记录文件。
   • 运行 gem rdoc nesta --rdoc
   • 重新启动 gem 服务器

一切都无济于事。请帮忙。
谢谢。

Answer 1

您可以预览生成的 html 页面，而无需在您的机器上安装 gem 的修改版本。将此添加到 nesta 的 Rakefile 中:

require 'rake/rdoctask'
Rake::RDocTask.new('doc') do |i|
  i.rdoc_files = FileList['lib/**/*']
end

然后输入rake doc。然后查看生成的html/index.html文件。