[Doc-SIG] XML Conversion Update
Moshe Zadka
Moshe Zadka <mzadka@geocities.com>
Fri, 27 Aug 1999 12:21:15 +0300 (GMT+0300)
On Thu, 26 Aug 1999, Fred L. Drake, Jr. wrote:
> I am not at all decided on a DTD to use. I see three options:
<DocBook, isomorphic to current LaTeX or a new one>
I want to suggest a thesis that the markup used (Language+ XML DTD/LaTeX
style) has little effect on the ease, as long as
a. There are few optional features
b. There are good templates ready
Personally, when I started to write Python docs, I knew LaTeX but not the
specific Python style. I started from the templates, and looked for
similar things in other docs. My LaTeX knowledge confused me, actually: I
used math to heavy for the HTML conversion work well. This shows that
DocBook is a bad idea /because/ people know it, and would have /too much/
freedom for any hope of uniformity.
I vote for a roll-our-own style. As soon as we can get a conversion ready,
there will be plenty of templates ready. More, a roll-our-own, as opposed
to the LaTeX style, could reflect the structure of a Python source file
more easily (for examples, not seperating the __init__ method from the
rest of the methods, and putting the generic class description in it).
This is also a bit of an egoism, since it would make the vapourware
PythonML->POD easier.
Just my 0.02$
--
Moshe Zadka <mzadka@geocities.com>.
INTERNET: Learn what you know.
Share what you don't.