[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
