[Author Prev][Author Next][Thread Prev][Thread Next][Author Index][Thread Index]

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



Do you need to embed the javascript in the document? If it were imported from an external file using a relative uri the script included with the installed docs could differ from that of the online docs. Then maybe all the comment markup could be added at document generation, with no need to post process for the web site.

Lenard

On 25/03/11 01:34 AM, René Dudfield wrote:
On Thu, Mar 24, 2011 at 7:59 PM, Lenard Lindstrom<len-l@xxxxxxxxx>  wrote:
...
Yes, I can add additional tags.

You do know that the Sphinx stuff is in branches/reStructuredText? I just
added the generated html to svn.

Lenard


Cool, that's great.

The javascript to insert the comments will be quite simple.  Something like:

$.getJson("http://www.pygame.org/docs/comments.json";, function (comments) {
     for(part in comments) {
         //var part = 'pygame.display.set_mode';
         var theComments = comments[part];
         $('#' + part).append(generateCommentHtml(theComments));
         // update the number of comments on the button
         $('#' + part).find('.viewCommentButton').html(theComments.length)
     }
}


I'll finish off the part to generate the comments.json from the
database this weekend (along with new comment submit code, and admin
moderation interface).


cya!