Another killer feature of the sphinx documentation is that Disqus has now been integrated into the HTML rendering of the pages. You can comment on each of the pages directly. Very cool. You can also see the magic which enables Disqus/Sphinx integration on github. http://github.com/cguardia/ZODB-Documentation/blob/master/book/_templates/page.html I have not seen Disqus being used with sphinx. But I hope it catches on.
Thanks to Carlos and Jens for making the ZODB book building daily on zodb.org and enabling disqus on the pages. The bar for participating is very low -- please participate. Add a comment. Even if you like it. We need to hear more peoples thoughts.
Great to see three chapters as an ordinary web page at zodb.org. I would like to translate this into Japanese language on github with the same license of original. I also would like to setup the blog page which will have translated text of this page, my article, comments from community, all written in Japanese language. Encouraging Japanese people to participate this project and donate money via this original site is my goal. Is that Okay to do it? Thanks a lot for kicking off this project. Takeshi Yamamoto
ReplyDeleteAbsolutely. remember the chapters are drafts so they will be revised. Start your jp git branch and if you like you could post jp articles on this blog. Email me in private and I will give you privies to post. Instead of starting a separate blog. Sound good?
ReplyDelete