README.md in toto-0.1.6 vs README.md in toto-0.2.0

- old
+ new

@@ -20,22 +20,23 @@ - content is entirely managed trough **git**; you get full fledged version control for free. - articles are stored as _.txt_ files, with embeded metadata (in yaml format). - articles are processed through a markdown converter (rdiscount) by default. - templating is done through **ERB**. - toto is built right on top of **Rack**. -- comments are handled by disqus:(http://disqus.com) +- comments are handled by [disqus](http://disqus.com) - individual articles can be accessed through urls such as _/2009/11/21/blogging-with-toto_ - the archives can be accessed by year, month or day, wih the same format as above. +- arbitrary metadata can be included in articles files, and accessed from the templates. synopsis -------- -One would start by forking or cloning the toto-skeleton repo, to get a basic skeleton: +One would start by forking or cloning the `dorothy` repo, to get a basic skeleton: $ mkdir weblog/ $ cd weblog/ - $ git clone git://github.com/cloudhead/toto-skeleton.git . + $ git clone git://github.com/cloudhead/dorothy.git . One would then edit the template at will, it has the following structure: templates/ | @@ -90,11 +91,11 @@ $ unicorn #### on heroku -Toto was designed to work well with heroku:(http://heroku.com), it makes the most out of it's state-of-the-art caching, +Toto was designed to work well with [heroku](http://heroku.com), it makes the most out of it's state-of-the-art caching, by setting the _Cache-Control_ and _Etag_ HTTP headers. Deploying on Heroku is really easy, just get the heroku gem, create a heroku app with `heroku create`, and push with `git push heroku master`. $ heroku create $ heroku rename weblog @@ -102,17 +103,17 @@ $ heroku open ### configuration You can configure toto, by modifying the _config.ru_ file. For example, if you want to set the blog author to 'John Galt', -you could add `set :author, 'John Galt'` inside the `Toto::Server.new` block. Here's the options hash with the defaults: +you could add `set :author, 'John Galt'` inside the `Toto::Server.new` block. Here are the defaults, to get you started: - :author => ENV['USER'], # blog author - :title => Dir.pwd.split('/').last, # site title - :root => "index", # page to load on / - :date => lambda {|now| now.strftime("%d/%m/%Y") }, # date format for articles - :markdown => :smart, # use markdown + smart-mode - :disqus => false, # disqus id, or false - :summary => 150, # length of article summary - :ext => 'txt' # file extension for articles + set :author, ENV['USER'] # blog author + set :title, Dir.pwd.split('/').last # site title + set :root, "index" # page to load on / + set :date, lambda {|now| now.strftime("%d/%m/%Y") } # date format for articles + set :markdown, :smart # use markdown + smart-mode + set :disqus, false # disqus id, or false + set :summary, 150 # length of article summary + set :ext, 'txt' # file extension for articles Copyright (c) 2009 cloudhead. See LICENSE for details.