Re: README.EXT to HTML.
Hugh Sasse <[email protected]> Mon, 25 Sep 2006 16:35:13 +0100 (WEST)
| Newsgroups | gmane.comp.lang.ruby.documentation |
|---|---|
| Message-ID | <[email protected]> |
I recently tried to get README.EXT into HTML by adding it to the
rdoc .document file, but it doesn't end up in the HTML output.
Instead I have written a few scripts to HTML-ise it using BlueCloth.
http://www.eng.cse.dmu.ac.uk/~hgs/ruby/#README.EXT
My intention was to get the valuable information about how to write
extensions in C into a form which people can navigate easily and
conveniently, and to do this using an automatic process, with no
manual steps. The results are not perfect: lines which begin with a
number get picked up as headings, in particular one beginning "3
arguements", so this is a "satisficing" solution.
Anyway, having got this working, I'm thinking it may be of use
elsewhere within the space of ruby related texts. Any improvements
would be welcome, but if you just want to use it, that's fine too.
Hugh