rainly / typo

Typo is the oldest and most powerful Ruby on Rails blogware, providing custom templates, powerful drag and drop plugins API, advanced SEO capabilities, XMLRPC API and many more.

About Typo

Being around since March 2005, Typo is (probably) the oldest blogging platform in Rails. It has a full set of feature you would expect from such an engine, powerful SEO capabilities and full themes and plugin
extension. It is available as a gem or source tarball.

Current version is Typo 5.5 for Ruby on Rails 2.3.8.

Some useful links:

• Download Typo 5.5 source code:
• Report a bug
• Frequently Asked Questions
• Official Typo blog
• Plugin directory
• Typo themes
• Follow us on Twitter

Get some help

• IRC: #typo on irc.freenode.net
• Mailing list

Installing Typo

There are various way of installing Typo, but the easiest way is certainly using our gem.

1. Prerequisites

To install Typo you need the following:

• Ruby 1.8.7 or Ruby Enterprise Edition
• Ruby On Rails 2.3.8
• A database engine, MySQL, PgSQL or SQLite3
• The Ruby connector to your favourite database engine

2. Install the gem

If you have root access, just run:

  $ sudo gem install typo

Otherwise:

  $ export GEM_PATH=~/gems
  $ gem install -i ~/gems typo

3. Install Typo

Typo comes as a highly configurable binary installer. By default, it runs with Mongrel on a random port between 4000 and 5000 and SQLite3. However we recommend using a more production ready database engine and a faster, more scalable web server. MySQL and Passenger running either on Apache or Nginx are our favourite options.

To install Typo with the default options, just run:

  typo install /some/path

This will install typo with SQLite3 and will spawn it to some random port.

To chose your database engine and web server, run the following:

  typo install /some/path web-server=my_server database=my_db db_password=password db_user=my_app db_name=my_app some/path

Options for web-server are:

• mongrel
• mongrel_cluster
• external: Apache, Nginx, Lighttpd… with Fastcgi, mod_rails, Thin…

For more information about installing Typo from the gem, please read our installer documentation

4. Start / stop Typo

If you’re using mongrel or mongrel_cluster you’ll be able to start / stop your Typo engine using Typo binary:

  $ typo start some/path

  $ typo stop some/path

Daily use

Typo’s administrative interface is available at http://your.domain.com/admin. You can use this to post articles and change Typo’s configuration settings. For posting new content, you can either use this administrative web interface or a desktop blog editor like MarsEdit or Ecto. For a short list of clients which are confirmed to work please visit http://typosphere.org/wiki/DesktopClients.

Enjoy,
Your typo team