REbol HTML document generator

[1/5] from: chris:starforge at: 29-Oct-2000 12:54

Link appears now to be: here.

Hi, A couple of days ago I enquired about scripts to generate HTML documents based on the header and function descriptions in a script, somewhat similar to the way javadoc generates docs from Java source but without the comment based documentation. A beta version of the script I have developed to do this can be found at http://www.starforge.co.uk/files/reboldoc.r and an example of the HTMl documents it generates is available at http://www.starforge.co.uk/files/reboldoc.html I thought it best not to send the script to the list as it is slightly over 12k in size. If anyone finds any bugs or has any suggestions, please contact me at the address in the script. If there is any demand for it I may also add comment parsing to allow larger function descriptions. Chris -- New sig in the works Explorer 2260, Designer and Coder http://www.starforge.co.uk -- Virtue is its own punishment.

[2/5] from: joel:neely:fedex at: 29-Oct-2000 7:57

Hi, Chris, The generated doc page looks great! [rebol-bounce--rebol--com] wrote:

> and an example of the HTMl documents it generates is available at > > http://www.starforge.co.uk/files/reboldoc.html >

Just out of curiousity, did you consider using CSS? It might make the generated page (and the script) a bit more compact. -jn- P.S.: I LOVED the "spammer" notice; nearly did myself an injury laughing!

[3/5] from: chris:starforge at: 29-Oct-2000 14:37

#29-Oct-00# Message from *Joel Neely*: Hi Joel,

> Just out of curiousity, did you consider using CSS? It might > make the generated page (and the script) a bit more compact.

Yeah I did. The problem is, as with all thing HTML related, browers. Given the range of platforms Rebol supports, I have no way of knowing which browsers people will have or how good the CSS support is. There are still browsers out there that don't support CSS so I though it best to go for the LCD in this version. I may write a version with CSS for IE/Netscape later

> P.S.: I LOVED the "spammer" notice; nearly did myself an injury > laughing!

I couldn't resist putting that up ;) Chris -- New sig in the works Explorer 2260, Designer and Coder http://www.starforge.co.uk -- Cigarette, n.: A fire at one end, a fool at the other, and a bit of tobacco in between.

[4/5] from: rishi:picostar at: 29-Oct-2000 10:57

thanks. this is useful for me. I'll try it out tom... BTW, it would be nice to have option to generate html document not only on current script, but also on all imported scripts/modules (via do command). Rishi Previously, you (Chris) wrote:

[5/5] from: chris::starforge::co::uk at: 29-Oct-2000 19:59

#29-Oct-00# Message from *Rishi Oswal*: Hi Rishi,

> thanks. this is useful for me. I'll try it out tom... > BTW, it would be nice to have option to generate html document not only on > current script, but also on all imported scripts/modules (via do command).

Yeah, I'll see what I can do with that. Should be possible.. hmm.. yeah. I'll give that a try after work tomorrow. Chris -- New sig in the works Explorer 2260, Designer and Coder http://www.starforge.co.uk -- AMAZING BUT TRUE ... There is so much sand in Northern Africa that if it were spread out it would completely cover the Sahara Desert.