From: G. M. <mi...@us...> - 2008-09-25 14:17:37
|
On 24.09.08, David Goodger wrote: > On Wed, Sep 24, 2008 at 12:07, Sam Partington <sam...@gm...> wrote: > > The field list definately seems like the solution. Both :param : and > > :return : seem common amongst sphinx and epydoc, which is encouraging. > > > > I did consider field lists at one point, but disliked the table > > output, but I can live with that if there is a convention growing. > Output can be changed. > If you were prepared to implement custom directives, it's not much > different to implement a custom Reader with Transforms, to get the > semantics and the output you want. There is already a HTML writer that outputs field lists as CSS styled lists instead tables. See http://docutils.sf.net/sandbox/html4strict/ and http://svn.berlios.de/viewcvs/*checkout*/docutils/trunk/sandbox/html4strict/README.txt (for some strange reason the README.txt file did not make it to the docutils.sf.net site). Günter |