[Zope-dev] Sphinx extension for zope.interface?

Tres Seaver tseaver at palladion.com
Mon Oct 6 23:27:21 EDT 2008


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Kevin Teague wrote:

> Nice!

Thanks!  The source is here if you feel inspired:

  http://svn.repoze.org/repoze.sphinx.autointerface/trunk/


> I've been playing with this since I wanted to start using the  
> sphinx.ext.autoclass (and now repoze.sphinx.autointerface) to generate  
> the Grok docs.
> 
> However, the HTML differs between autoclass and autointerface - it'd  
> be nice it they were more similar. In particular:
> 
>   *  <dl class="interface"> is needed to style the block.
>   * The word "Interface:" should have a <span class="interfacelabel">  
> or something around it so that it can be hidden using CSS if desired.
>   * <tt class="descinterfacename"> and <tt class="descname">
>   * Permalinks (those wierd-o backwards P characters ¶) are missing
> 
> And looking at the source it looks like it the package mostly just  
> slots in the docutils-generated HTML - so I guess it could take some  
> wrangling to make changes to the generated HTML ...

Yep.  It is on my list to try to get a smoother fit, but I confess that
the docutils / sphinx code does not make for easy reading to my eyes.  I
would also like to add an ':interface:my.package.interfaces.IFoo'
directive, which would work as a cross-ref target.

> One other small thing, the install_requires for the package doesn't  
> declare that it requires docutils >= 0.5.

Hmm, I guess I didn't realize that it did:  what blows up with 0.4?


Tres.
- --
===================================================================
Tres Seaver          +1 540-429-0999          tseaver at palladion.com
Palladion Software   "Excellence by Design"    http://palladion.com
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFI6tcZ+gerLs4ltQ4RAlxSAJ9hHUGS2c+mI5tlTU5Rklh3wafA5gCgvpFX
VN9edu5Lc3lL0h8EauGKAmk=
=398d
-----END PGP SIGNATURE-----


More information about the Zope-Dev mailing list