[Webware-discuss] Re: [Webware-discuss]Webware documentation

2002-10-24 Thread Michael Engelhart
Hi - I'm new to this list and while I just barely have scratched the surface of Webware (and python for that matter), I would be glad to take files in XML format and generate the HTML documentation using XSLT. Unfortunately I've had a lot of problems generating output with the Python XSL proc

[Webware-discuss] Re: [Webware-devel] Re: [Webware-discuss]Webware documentation

2002-10-24 Thread Ray Leyva
Hi, I talked a few months back about a book, but it never seemed to get any traction. I'm big on Xml / Xsl, and am very willing to lend myself to a project like this. With Python you want the gnome / libxml2 & libxslt python bindings. They are fantastic. I also recommend using the Gentoo sty

Re: [Webware-discuss] Webware documentation

2002-10-24 Thread Ian Bicking
On Thu, 2002-10-24 at 07:18, Stefan Schwarzer wrote: > > Actually, I guess my real issue is that inline documentation doesn't > > distinguish between user interfaces and internal interfaces -- > > particularly when those internal interfaces are not entirely internal, > > like methods that you may w

Re: [Webware-devel] Re: [Webware-discuss] Webware documentation

2002-10-24 Thread Ian Bicking
On Thu, 2002-10-24 at 09:06, Aaron Held wrote: > >>Anyway, I've been writing lots of documentation lately, and I've been > >>using reStructuredText (http://docutils.sourceforge.net/rst.html). It's > >>worked pretty well for me -- the output looks decent, but more > >>importantly it's comfortable t

Re: [Webware-devel] Re: [Webware-discuss] Webware documentation

2002-10-24 Thread Mike Warren
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Ian Bicking <[EMAIL PROTECTED]> writes: > I might be able to get over my annoyance with XML if I look deeper > into Emacs -- I'm sure there's something in there to make it more > pleasant (maybe abbrev...) Yes, there's sgml-mode. Supplied with a DTD,

Re: [Webware-devel] Re: [Webware-discuss] Webware documentation

2002-10-24 Thread Ian Bicking
On Thu, 2002-10-24 at 12:40, Mike Warren wrote: > > I might be able to get over my annoyance with XML if I look deeper > > into Emacs -- I'm sure there's something in there to make it more > > pleasant (maybe abbrev...) > > Yes, there's sgml-mode. Supplied with a DTD, it gives you > popups/prompts

Re: [Webware-devel] Re: [Webware-discuss] Webware documentation

2002-10-24 Thread Aaron Held
Ian Bicking wrote: probably make a translator from a text-like markup to a particular XML schema well enough... and I might do that if we decide on a particular schema. I think that would be better than trying to deal with all the needless tags. I agree. reStruct has all the basic tags, the onl

Re: [Webware-devel] Re: [Webware-discuss] Webware documentation

2002-10-24 Thread Ian Bicking
On Thu, 2002-10-24 at 14:43, Aaron Held wrote: > Ian Bicking wrote: > > probably make a translator from a text-like markup to a particular XML > > schema well enough... and I might do that if we decide on a particular > > schema. I think that would be better than trying to deal with all the > > ne

Re: [Webware-devel] Re: [Webware-discuss] Webware documentation

2002-10-24 Thread Aaron Held
Anyway, I've been writing lots of documentation lately, and I've been using reStructuredText (http://docutils.sourceforge.net/rst.html). It's worked pretty well for me -- the output looks decent, but more importantly it's comfortable to write. Keeping the documentation up-to-date is the most esse

Re: [Webware-discuss] Webware documentation

2002-10-24 Thread Stefan Schwarzer
Hi Ian On 24 Oct 2002, Ian Bicking wrote: > Anyway, I've been writing lots of documentation lately, and I've been > using reStructuredText (http://docutils.sourceforge.net/rst.html). It's > worked pretty well for me -- the output looks decent, but more > importantly it's comfortable to write. Ke

[Webware-discuss] Webware documentation

2002-10-24 Thread Ian Bicking
The Webware documentation isn't in very good shape, as it hasn't been actively updated in a while. Anyway, I've been writing lots of documentation lately, and I've been using reStructuredText (http://docutils.sourceforge.net/rst.html). It's worked pretty well for me -- the output looks decent, bu