== Restolog

Very simple blog system based on REST/CRUD ideas. Sources (all credits going to the 
authors, i just combined their work):

* RestBlog by Alisdair McDiarmid [ http://randomoracle.com/stuff/RestBlog.tar.gz ]
* restful_authentication plugin by techno-weenie 
  [ http://svn.techno-weenie.net/projects/plugins/restful_authentication/ ]
* graseful delete degradation 
  [ http://www.thelucid.com/articles/2006/07/26/simply-restful-the-missing-action ]

The purpose is mostly proof of concept, not typo/mephisto etc. competition.

There is also Pure Ruby REST client ('script/rester') for the system with missing
curl, wget etc. 


== Requirements

* Ruby 1.8.4+ (tested with mongrel)
* Edge Rails
* SQLite 3

This will probably work fine in Ruby 1.8.2, but it won't work with Ruby 1.8.3. Most
people are up to 1.8.4 anyway.


== Features

* Pretty RESTful - using only standard action names (index, show, new, create, edit,
  update, destroy)
* tags taxonomy - more flexible than categories
* graceful delete degradation - you can delete without JS enabled
* Multiuser (but only one blog per user):
  - only logged in users can post
  - user can delete only his own articles
  - user can delete only comments to his own articles
  - 'admin' user can delete everything
  - only 'admin' user can delete tags
* blogs per tag ( /tags/? )
* blogs per user ( /users/? )
* RSS2.0/Atom feeds with suitable mime-types ( /articles.atom and /articles.rss )


== Installation

1. Get the sources:

* tarballs: [ http://zhware.net/code/ruby/ror/ ] (get restolog-x.y.tgz)
* SVN: [ svn checkout http://restolog.googlecode.com/svn/trunk/ restolog ]

2. untar if needed

3. cd to the sources directory

4. Bind it to the Edge Rails, create the database and start it:

   rails freeze_edge
   rake migrate
   server/start

5. Create the user with login 'admin' (power user, can delete everybody posts, comments, tags etc.)
   (hm, maybe 'rake bootstrap' step will be good)

6. Logout and create usual user

7. Start posting articles


== Usage

See doc/USAGE file for details


== Known Issues

Update via XML still not working. Missing test. Messy code.


== Report Bugs

You can send bug reports via email to 'stoyan@gmail.com' or post them on:

[ http://code.google.com/p/restolog/issues/list ]

Please be specific and include useful log bits if you can!


== License:

Copyright (c) 2006 by Stoyan Zhekov.

This application is released under the MIT license.  See MIT-LICENSE file for details.