Re: [Python-Dev] [Doc-SIG] The docs, reloaded

2007-05-20 Thread Gael Varoquaux
On Sat, May 19, 2007 at 03:31:59PM -0500, Ron Adam wrote: > - The html syntax highlighters. (Pydoc can use those) I have a patch on the docutils patch tracker that does this. Code is probably of a rather bad quality, but it outputs LaTeX and HTML. If we can work together to improve this patc

Re: [Python-Dev] [Doc-SIG] The docs, reloaded

2007-05-20 Thread Lea Wiemann
Martin Blais wrote: > e.g. are you still marking classes as classes > and functions as functions in the ReST source It seems so (modulo XXX's and TODO's in Georg's implementation, probably ^_^) -- all of the pages have "show source" links, so you can see for yourself. I'm not an expert with the

Re: [Python-Dev] [Doc-SIG] The docs, reloaded

2007-05-20 Thread John Gabriele
On 5/19/07, Georg Brandl <[EMAIL PROTECTED]> wrote: > > [snip] > > Waiting for comments! Awesome, Georg! Wow. Nice work. Seems like this has been a long time comin', and I bet others have been working away "in secret" on similar projects. I hope you keep running with it until it gets hijacked int

Re: [Python-Dev] [Doc-SIG] The docs, reloaded

2007-05-20 Thread Lea Wiemann
[Georg Brandl] > The highlighting is actually done with Pygments, which cannot be > included in the stdlib as-is. Perhaps a stripped-down version? No need to; we can just fall back to no syntax highlighting if Pygments is not installed on the user's system. [Gael Varoquaux] >> - The html synt

Re: [Python-Dev] [Doc-SIG] The docs, reloaded

2007-05-19 Thread Lea Wiemann
Georg Brandl wrote: > over the last few weeks I've hacked on a new approach to Python's > documentation. > As Python already has an excellent documentation framework, the docutils, > with a > readable yet extendable markup format, reST, I thought that it should be > possible to use those instead