Labibi is a base package to use for documentation and Web sites for other projects of mine.
For now, I’ve made it fairly easy to post sites to ReadTheDocs that enable Google Analytics, Disqus commenting, and easy source file editing. You can check it out at the labibi demo site.
This is directly based off of Mikko Ohtamaa’s excellent work on the Plone documentation.
A brief HOWTO do this for your own ReadTheDocs site:
- Get started with ReadTheDocs.
- Create a _static/ directory and put labibi.css and labibi.js in it.
- Put “html_style = ‘labibi.css’” in your conf.py
- Create a _templates/ directory and put page.html in there.
- Edit ‘page.html’ to set your google analytics, disqus, and github info.
For now, you can’t disable the editing functionality, but if you delete the google_analytics and disqus_shortname it should disable that functionality on your site.
The labibi source code is here for your checking-out pleasure.
I’ve put up a short blog post here.
–titus
This file can be edited directly through the Web. Anyone can update and fix errors in this document with few clicks -- no downloads needed.
For an introduction to the documentation format please see the reST primer.