[Doc-SIG] converting tex? use of docbook?
Ian Atkin
ianatkin@blueyonder.co.uk
Thu, 19 Sep 2002 12:37:51 +0100
hello,
python newbie very interested in tech writing
while learning python i'm focusing on doc systems, tool-chains etc
comming from a java/xml/xslt/docbook background and want to dive in to
python's doc platform
here's my views (to prevent flames, not provoke :-)
- structured markup is a Good Thing
- xml's simplicity outweighs sgml's power (in the end)
- tool-chains are a mess, so whatever works...
- authoring is in a state, so whatever syntax folks are prepared to use
is sound
- docbook is a beast, but a beautiful one :-)
here's my questions:-
- is there any motivation to move python's doc format to xml docbook?
can i contrib/promote in any way? (i read a mention of a "python doc
project" like the ldp)
- what "types" of document are most commonly used/wanted in the python
distro/apps and do these require unique markup?
- are there any open tools (or chains) around to convert tex source into
xml (xslt scripts can do the rest)?
i've got loads of other questions and ideas, but need to fathom the
world of python doc tools (docutils, happydoc, etc) in order not to
appear more stupid than i am, expect more mails...