问题
I am trying to contribute to a gem I recently took interest in - Nesta. The developer has done a great job in creating one of the lightest, thinest CMSs you can find and I want to document it. I have read through the code and commented on a few methods to the best of my knowledge.
However, I seek to test this out locally by calling gem server
and seeing the changes on my machine before pushing it online.
Things I have tried:
- Manual edit.
- Documented the file.
- Fired up
gem server
.
- Using the
gem
tool.- Documented the file.
- Ran
gem rdoc nesta --rdoc
- Restarted
gem server
All to no avail. Please help.
Thank you.
回答1:
You can preview generated html pages without installing a modified version of the gem on your machine. Add this to nesta's Rakefile:
require 'rake/rdoctask'
Rake::RDocTask.new('doc') do |i|
i.rdoc_files = FileList['lib/**/*']
end
and type rake doc
. Then view generated html/index.html
file.
回答2:
Are you sure you've installed the version that you've modified, not the original version?
If you've installed the modified version, but have forgotten to install the rdoc, see Can you install documentation for existing gems?
来源:https://stackoverflow.com/questions/5776491/generating-rdocs-for-locally-installed-gems