I hope I posted this to the mailing list as this pertains to ruby, but
not
actual code. This is my first post, so forgive me if I’ve made a mistake
(and possibly guide me to the correct place to post).
My question is this: I’m working my way through the book “Beginning
Ruby:
From Novice to Professional” and it’s written for ruby versions 1.8 and
1.9. I am using the current version, which I believe is 1.9.3. In the
book
the author, Peter C., uses RDoc to help document his code.
It outputs something that has three frames at the top in his book. When
I
run rdoc myself from the command line, it outputs a folder with an
index.html that allows a javascript search of the methods that are
documented in the class.
I did some searching and found http://rdoc.sourceforge.net/, but that
seems
to be the three-framed rdoc mentioned in the book. Where can I learn
about
this new rdoc? I can’t seem to find information anywhere online, and I
want
to be sure I’m learning the correct commands for it.
I think this is just a different “skin” or “theme” for RDoc. The
command-line interface and the data is still the same; it’s just
displayed in a prettier way.
Your sub-bullets need to line up with your new "let margin: http://rdoc.rubyforge.org/RDoc/Markup.html#label-Simple+Lists
The new left margin would be where the first character after the bullet
point character starts. In your example the ‘B’ after the star:
Bullet point one (‘B’ is in the third column)
Sub-bullet one (‘*’ is also in the third column)
Sub-bullet two
Bullet two
Sub-bullet two
Also, it didn’t seem to process words between pluses as code ex: +this is
code+ did not format properly
If you look here: http://rdoc.rubyforge.org/RDoc/Markup.html#label-Text+Markup
You’ll see that the text markup using the start ‘*’, underscore, ‘_’,
and
plus sign ‘+’ only work when put around single words (no whitespace).
You’ll have to use the HTML-tag style of markup (, , or
respectively) if you want to markup strings containing multiple words.
Did the commands change? Where can I learn the new commands?
Also, where can I learn about the different skins or themes for Rdoc?
Using the command line: rdoc --help
You’ll see that the “–template=NAME” command-line option allows you to
change which template to use. For a list of templates, check out:
It outputs something that has three frames at the top in his book.
When I run rdoc myself from the command line, it outputs a folder
with an index.html that allows a javascript search of the methods
that are documented in the class.
The three-frames output is the old RDoc layout of RDoc prior to version
3 (I think it was this version). Modern versions of RDoc generate the
layout you’re seeing (and this new layout is called “Darkfish”).
I did some searching and found http://rdoc.sourceforge.net/, but that
seems to be the three-framed rdoc mentioned in the book. Where can I
learn about this new rdoc? I can’t seem to find information anywhere
online, and I want to be sure I’m learning the correct commands for
it.