Mailing List Archive: 49091 messages
  • Home
  • Script library
  • AltME Archive
  • Mailing list
  • Articles Index
  • Site search

[REBOL] Re: Comments about make-doc-pro?

From: jean:holzammer:faedv-n:bayern at: 9-Aug-2001 8:25

>Hi, I hope that some of you had a look at the make-doc-pro script
and played
>around with it a bit. Any comments? Robert
You aimed to a improved (but as compatible as possible) version of the original makedoc. You added some nice features. Here my suggestions: 1. It's nice to be able to select a language: I would suggest sth. like this to specify it: =language any-string Then you 'do a file called %path-to-makedoc-pro/locale/any-string.r , that defines the localized strings example: %path-to-makedoc-pro/locale/US.r: contents: "Contents" %path-to-makedoc-pro/locale/DE.r: contents: "Inhalt" %path-to-makedoc-pro/locale/EN.r: contents: "Contents" So you wouldn't need to have support for different languages hardcoded into the the compiler. 2. 'browse function exspects a string containing a valid URL. So instead of: filename: %testout.html browse to-string filename you should do sth. like this: filename: %testout.html fullpath: join dirize what-dir %testout.html browse rejoin [file://localhost/ to-local-file fullpath] As browse passes the string given as command line argument to the browser without modification/conversion, it gets an invalid URL ! This might work with _your_ browser, but not necessarily with other browsers. 3. I don't think it's a good idea to use CSS for intendation. If a browser doesn't support this (or the user has disabled that feature) there will not be any intendation at all. 4. You should add an option to disable generating a contents section (have a look at make-spec.r), but without disabling generation of a <title> tag. If contents section is not generated, the first section of the text may not begin with h2 but with h1 instead ! 5. You should put font definitions into an external file (as makespec does), and use no fonts tags as internal default. 6. A function that allows inserting images into the floating text itself would be nice. Just some ideas,... Jean