|
|
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
- Blog posts and pages - Blog posts are taggable and can be commented on, while pages are for non-blog content.
- Wiki-style linking - Easily link between blog posts and pages using wiki-style links.
- Glorious markup - Use Textile, Markdown, or XHTML for formatting of blog posts, pages, and comments. If you want to, you can even use all three at the same time.
- Media uploads - Easily upload images, videos, and other files and include them in your blog posts and pages.
- Painless customization - You don't have to recreate every single template to customize the look of your site. Custom themes inherit from the default theme, so you only need to override the pieces you want to change. This makes upgrading easier as well.
- Plugin support - It's easy to add custom functionality to Thoth by creating simple plugins. You can even share your plugins with other Thoth users by distributing them as gems. Thoth already has plugins for Flickr and del.icio.us, and more are on the way!
- Easy administration - Other blog software requires you to switch to a clunky administration interface to perform administrative tasks, but Thoth's administrator tools are integrated right into the main site as contextual toolbar icons.
- High performance - Even with caching disabled, Thoth can handle 20 to 30 requests per second on a decent server without breaking a sweat. With caching on (which is the default configuration), that number jumps to upwards of 300 requests per second.
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