What's new? | Help | Directory | Sign in
Google
thoth-blog
A fast and simple Ruby blog engine
  
  
    
Join project
Project owners:
  rgrove

Overview

Thoth is a blog engine written in Ruby and based on Ramaze and Sequel. Its simple, elegant architecture, minimalist featureset, and extensible codebase make it both fast and easy to customize. Thoth was formerly known as Riposte, but was renamed to avoid a trademark conflict.

Features

Installing Thoth

# sudo gem install thoth

Depending on your database preferences, you'll also need to install either the mysql gem or the sqlite3-ruby gem to provide the database drivers necessary for whichever database you choose to use.

Running Thoth

First, create a new Thoth home directory. This is where your blog's config file and any customizations will live:

# thoth --create myblog
# cd myblog

Now open up thoth.conf in your favorite editor and customize it to your liking (or you can leave it alone for now if you just want to get Thoth running quickly with all the default settings). When you're ready, start Thoth by running:

# thoth

If everything goes well, you should be able to access your new Thoth blog at http://localhost:7000/ (or whatever port number you configured). That was easy, right?

Once you've tested everything and you're ready to run Thoth in production, you'll want to start it as a daemon, like so:

# thoth -d start

Getting the latest code

If you'd like to contribute to Thoth or if you just want to run the very latest code, clone the git repository:

# git clone git://github.com/rgrove/thoth.git

Or, if you don't have git, you can just download the source as a tarball:

# curl -L http://github.com/rgrove/thoth/tarball/master -o rgrove-thoth-master.tar.gz
# tar xzvf rgrove-thoth-master.tar.gz

To build and install a gem from the code you just pulled, change to the Thoth source directory and run:

# rake install