[REBOL] Re: Make-Doc Formatter replaces Make-Spec
From: al:bri:xtra at: 26-May-2001 9:02
Carl wrote:
> Make-Doc is a two pass text formatter. The first pass converts to a REBOL
block format. The second pass uses that block format to convert to the
output target format, which is HTML at this time, but it could be any type
of output, including Text, PDF, Tex, Helpfiles, .roff, whatever you want.
> Writing the output formatters is fairly easy... you can use the HTML
version as an example. Eventually we will want to put the output formatters
in separate files.
I thought this:
"#" paragraph opt newline (emit enum para) |
was a interesting idea for numbered lists (as a non-American I'm not
familiar with the use of "#" as meaning "number". I've been using "0" (the
digit/character zero) as the marker, followed by a tab.
This:
\in
and:
/in
seems intrusive, for signalling indents. I prefer to use tabs for this
purpose.
I'm a little disturbed by lines like:
h2: <font face="arial,helvetica" size="3">
as I'm a current fan of using style sheets. But I can see the advantages
of having one file containing all the formatting.
Instead of:
emit-toc: func [doc /local w] [
I'm currently prefering to create fine-grained, massively hyperlinked
document sets, with a Rebol script that links them all together and
automatically creates tables of contents, indexes and reverse indexes for
me.
BTW, in case people have difficulties, the make-doc file is at:
www.reboltech.com/library/scripts/make-doc.r
Andrew Martin
ICQ: 26227169 [new Rebol/eText site soon!]