Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Totoro is a featherweight blog engine for the Alpha-Geek
Fetching latest commit...
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
pages add support for markdown /<pages>
posts excerpt() for the index and rss views
themes/default create a Post class
.gitignore moved some functions into lib/bato.php
README.markdown README: added notes for dev. shortened the License section
config.php support html pages
index.php get page titles




Totoro is a featherweight blog engine for the Alpha-Geek.


  • RSS feed
  • All the posts are stored on the file system, in Markdown, Textile or HTML
  • Simple file-based caching of pages
  • Disqus comments are supported in the default theme
  • Themeable (includes a simple default theme)
  • The markdown pages that are in pages/<name-of-page>.md are accessible from /name-of-page


  1. copy the content of this repository into your document root folder
  2. modify the content of config.php to suit your needs (author_name, base_url, title, description, etc).
  3. remove demo posts in posts/, and write your own first post. Don't forget to add a title in the first line of your post. You'll also need to name your file using this format: "<YYYY-MM-DD>-<post-slug>.<format>"
  4. make the cache directory writable: chmod a+w cache/
  5. (optional) if you wish to have Disqus comments, first create an account on Then paste the 'disqus_shortname' in your config.php.

Notes for deployment

If you're using TOTORO_ENV in your config.php to detect the current environment, you might want to set the environment in your .htaccess file, like this:

SetEnv TOTORO_ENV production

Notes for development

When you're developing your blog locally, you shouldn't need to set the TOTORO_ENV environment variable.

Also note that Totoro only serve the cached versions of pages/posts when TOTORO_ENV is set to 'production'. With any other value, the cache will be refreshed on each requests.


Totoro is inspired by Toto. Give it a shot, it's pretty cool.



Something went wrong with that request. Please try again.