Re: [pygame] Experimental, Classic Look, sphinx generated XHTML docs for Pygame 1.9.2a

[claudio canepa <ccanepacc@xxxxxxxxx>]

On Tue, Mar 22, 2011 at 6:39 PM, Lenard Lindstrom <len-l@xxxxxxxxx> wrote:

Hi everyone,

I have been playing with porting the Pygame document to Sphinx. Feedback suggested the current document format was preferred. Here is a first attempt at reproducing that theme with Sphinx.

http://www3.telus.net/len_l/pygame/pygame_doc_sphinx.tar.gz

md5sum:
0ac88a9d8d052ce629c6625d4be52934 Âpygame_doc_sphinx.tar.gz

I have tried them on IE 8, Firefox 3.x, and Epiphany 2.30.6. No serious problems, but anchor titles do not show up a tooltips in IE, and Epiphany ignores the italic font style. Unfortunately, I missed a chance to try them on Safari.
Â

I checked with Opera 11.01, comparing views with IE8 and Firefox 4.0: it
 looks right, including tooltips for links to other sections.

The only misbehavoir I spotted in comparison with 1.9.1 docs, is an ASCII draw in pygame.mask.overlap which renders bad.
All three browsers show the same defect, see the snapshots taken with FF

pygame 1.9.2 sphinx rendered
http://img16.imageshack.us/img16/8173/maskoverlapff40.png

pygame 1.9.1 traditional rendered
http://img858.imageshack.us/img858/4964/maskoverlapff40pygame19.png

I appreciate that the top navigation area is retained, instead of the lateral navigation bar used by default sphinx: it allows to better use the screen area, and avoids nasty code scrollers.

Last but not least, thanks for your continuous work in pygame !

--
claudio