Welcome to the labibi demo site!

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:

  1. Get started with ReadTheDocs.
  2. Create a _static/ directory and put labibi.css and labibi.js in it.
  3. Put “html_style = ‘labibi.css’” in your conf.py
  4. Create a _templates/ directory and put page.html in there.
  5. 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

Indices and tables

comments powered by Disqus

Table Of Contents

This Page

Edit this document!

This file can be edited directly through the Web. Anyone can update and fix errors in this document with few clicks -- no downloads needed.

  1. Go to Welcome to the labibi demo site! on GitHub.
  2. Edit files using GitHub's text editor in your web browser (see the 'Edit' tab on the top right of the file)
  3. Fill in the Commit message text box at the bottom of the page describing why you made the changes. Press the Propose file change button next to it when done.
  4. Then click Send a pull request.
  5. Your changes are now queued for review under the project's Pull requests tab on GitHub!

For an introduction to the documentation format please see the reST primer.