rdoc and Rake::RDocTask with different outputs?

P

Pablo Yanez

Hi

I had some issues using Rake for the creation of code documentation.

I've done:

$ rvm install 1.9.2
$ rvm docs generate
$ gem install rdoc
$ gem list

*** LOCAL GEMS ***

rake (0.8.7)
rdoc (3.5.3)



I've created the following task in my Rakefile:

Rake::RDocTask.new { |rdoc|
rdoc.rdoc_dir = 'doc'
rdoc.title = 'CAN Emulation'
rdoc.main = 'README'
rdoc.options << '--line-numbers' << '--inline-source'
rdoc.options << '--charset' << 'utf-8'
rdoc.options << '-f' << 'darkfish'

rdoc.rdoc_files.include('README')
rdoc.rdoc_files.include('lib/**/*.rb')
}


When I type rake rdoc then the documentation is generated. However, the
interface is a little broken.

The icons left of the files, namespaces, classes, etc. are gone. (see
attachment: rake.jpg). This is not sp bad, but when you move your mouse
over a function, then this message is displayed: "click to toggle
source". If you click on it, nothing happens.


When I test the same configuration with rdoc

$ rdoc --title 'CAN Emulator' -m README --line-numbers --inline-source
--charset utf-8 README lib/

then everything works fine (attachment rdoc1.jpg). Even the "click to
toggle source" action works (attachment rdoc2.jpg).

Am I missing something??? Why does that happen?

BTW: do we have here some kind of code-tags for ruby/bash code?

Thanks

Attachments:
http://www.ruby-forum.com/attachment/6151/rake.jpg
http://www.ruby-forum.com/attachment/6152/rdoc1.jpg
http://www.ruby-forum.com/attachment/6153/rdoc2.jpg
 

Ask a Question

Want to reply to this thread or ask your own question?

You'll need to choose a username for the site, which only take a couple of moments. After that, you can post your question and our members will help you out.

Ask a Question

Members online

Forum statistics

Threads
473,744
Messages
2,569,483
Members
44,902
Latest member
Elena68X5

Latest Threads

Top