[PYTHON DOC-SIG] Bill Janssen suggested...
Tue, 13 Aug 1996 16:37:35 PDT
As a new member of the documentation SIG, let me point out that it's
Bill Janssen, not `Bill Janseen', as the web page says. You can find a
write-up on what I suggested (it's called TIM) at
5 (which, by the way, is written in TIM).
The basic idea is simple. Let's take a reasonable markup source
language which has lots of tools to translate it into other formats, and
add a layer on top to support domain-specific markup. We picked GNU
texinfo as a decent source form, from which text, HTML, Info, and
Postscript could be produced. We then added a preprocessor layer to
translate domain-specific terms such as `@isl' (used to mark an ILU ISL
literal), to the domain-independent terms used by texinfo; for example,
`@isl' is translated to `@code'. The preprocessor also drives the
transformation from texinfo to the desired output format, thereby
freeing the user from having to remember how to run TeX, etc. Finally,
two domain-independent features are provided by TIM, and implemented in
the preprocessor. They are the ability to include pictures in texinfo,
and the ability to add URL links.
DOC-SIG - SIG for the Python Documentation Project
send messages to: email@example.com
administrivia to: firstname.lastname@example.org