glinda 0.1.0

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.rspec

@@ -0,0 +1,2 @@
+--colour --format Fuubar
+

data/Gemfile

@@ -0,0 +1,16 @@
+source 'https://rubygems.org'
+
+group :test do
+  gem 'rspec'
+  gem 'capybara'
+end
+
+gem 'rdiscount'
+gem 'builder'
+
+group :development do
+  gem 'fuubar'
+  gem 'rake'
+  gem 'jeweler'
+  gem 'gemcutter'
+end

data/Gemfile.lock

@@ -0,0 +1,71 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.3.2)
+    builder (3.0.0)
+    capybara (1.1.2)
+      mime-types (>= 1.16)
+      nokogiri (>= 1.3.3)
+      rack (>= 1.0.0)
+      rack-test (>= 0.5.4)
+      selenium-webdriver (~> 2.0)
+      xpath (~> 0.1.4)
+    childprocess (0.3.5)
+      ffi (~> 1.0, >= 1.0.6)
+    diff-lcs (1.1.3)
+    ffi (1.1.5)
+    fuubar (1.0.0)
+      rspec (~> 2.0)
+      rspec-instafail (~> 0.2.0)
+      ruby-progressbar (~> 0.0.10)
+    gemcutter (0.7.1)
+    git (1.2.5)
+    jeweler (1.8.4)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+      rdoc
+    json (1.7.5)
+    libwebsocket (0.1.5)
+      addressable
+    mime-types (1.19)
+    multi_json (1.3.6)
+    nokogiri (1.5.5)
+    rack (1.4.1)
+    rack-test (0.6.1)
+      rack (>= 1.0)
+    rake (0.9.2.2)
+    rdiscount (1.6.8)
+    rdoc (3.12)
+      json (~> 1.4)
+    rspec (2.11.0)
+      rspec-core (~> 2.11.0)
+      rspec-expectations (~> 2.11.0)
+      rspec-mocks (~> 2.11.0)
+    rspec-core (2.11.1)
+    rspec-expectations (2.11.3)
+      diff-lcs (~> 1.1.3)
+    rspec-instafail (0.2.4)
+    rspec-mocks (2.11.2)
+    ruby-progressbar (0.0.10)
+    rubyzip (0.9.9)
+    selenium-webdriver (2.25.0)
+      childprocess (>= 0.2.5)
+      libwebsocket (~> 0.1.3)
+      multi_json (~> 1.0)
+      rubyzip
+    xpath (0.1.4)
+      nokogiri (~> 1.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  builder
+  capybara
+  fuubar
+  gemcutter
+  jeweler
+  rake
+  rdiscount
+  rspec

data/Glinda.gemspec

@@ -0,0 +1,91 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "glinda"
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["rschmukler"]
+  s.date = "2012-09-05"
+  s.description = "Toto, expanded"
+  s.email = "ryan@slingingcode.com"
+  s.extra_rdoc_files = [
+    "LICENSE",
+    "README.md"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    "Gemfile",
+    "Gemfile.lock",
+    "Glinda.gemspec",
+    "LICENSE",
+    "README.md",
+    "Rakefile",
+    "VERSION",
+    "lib/ext/ext.rb",
+    "lib/glinda.rb",
+    "spec/articles/1900-05-17-the-wonderful-wizard-of-oz.txt",
+    "spec/articles/2001-01-01-two-thousand-and-one.txt",
+    "spec/articles/2009-04-01-tilt-factor.txt",
+    "spec/articles/2009-12-04-some-random-article.txt",
+    "spec/articles/2009-12-11-the-dichotomy-of-design.txt",
+    "spec/glinda_spec.rb",
+    "spec/spec_helper.rb",
+    "spec/templates/about.rhtml",
+    "spec/templates/archives.rhtml",
+    "spec/templates/article.rhtml",
+    "spec/templates/feed.builder",
+    "spec/templates/index.builder",
+    "spec/templates/index.rhtml",
+    "spec/templates/layout.rhtml",
+    "spec/templates/repo.rhtml"
+  ]
+  s.homepage = "http://github.com/rschmukler/glinda"
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.24"
+  s.summary = "Toto, expanded"
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<rdiscount>, [">= 0"])
+      s.add_runtime_dependency(%q<builder>, [">= 0"])
+      s.add_development_dependency(%q<fuubar>, [">= 0"])
+      s.add_development_dependency(%q<rake>, [">= 0"])
+      s.add_development_dependency(%q<jeweler>, [">= 0"])
+      s.add_development_dependency(%q<gemcutter>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, [">= 0"])
+      s.add_runtime_dependency(%q<builder>, [">= 0"])
+      s.add_runtime_dependency(%q<rack>, [">= 0"])
+      s.add_runtime_dependency(%q<rdiscount>, [">= 0"])
+    else
+      s.add_dependency(%q<rdiscount>, [">= 0"])
+      s.add_dependency(%q<builder>, [">= 0"])
+      s.add_dependency(%q<fuubar>, [">= 0"])
+      s.add_dependency(%q<rake>, [">= 0"])
+      s.add_dependency(%q<jeweler>, [">= 0"])
+      s.add_dependency(%q<gemcutter>, [">= 0"])
+      s.add_dependency(%q<rspec>, [">= 0"])
+      s.add_dependency(%q<builder>, [">= 0"])
+      s.add_dependency(%q<rack>, [">= 0"])
+      s.add_dependency(%q<rdiscount>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<rdiscount>, [">= 0"])
+    s.add_dependency(%q<builder>, [">= 0"])
+    s.add_dependency(%q<fuubar>, [">= 0"])
+    s.add_dependency(%q<rake>, [">= 0"])
+    s.add_dependency(%q<jeweler>, [">= 0"])
+    s.add_dependency(%q<gemcutter>, [">= 0"])
+    s.add_dependency(%q<rspec>, [">= 0"])
+    s.add_dependency(%q<builder>, [">= 0"])
+    s.add_dependency(%q<rack>, [">= 0"])
+    s.add_dependency(%q<rdiscount>, [">= 0"])
+  end
+end
+

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2012 Ryan Schmukler
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,166 @@
+Glinda
+====
+
+Everyones favorite good witch
+
+introduction
+------------
+
+Glinda is built to extend the functionality of [Toto](https://github.com/cloudhead/toto) to offer a more
+complete feature set, while staying true to the original:
+
+- git powered
+- minimalistic
+- easily customized
+
+blog in 10 seconds
+------------------
+
+    $ git clone git://github.com/rschmukler/dorothy-with-glinda.git myblog
+    $ cd myblog
+    $ heroku create myblog
+    $ git push heroku master
+
+philosophy
+----------
+
+Glinda follows the same philosophy as Toto
+
+Everything that can be done better with another tool should be, but one should not have too much pie to stay fit.
+In other words, toto does away with web frameworks or DSLs such as sinatra, and is built right on top of **rack**.
+There is no database or ORM either, we use plain text files.
+
+Toto was designed to be used with a reverse-proxy cache, such as [Varnish](http://varnish-cache.org).
+This makes it an ideal candidate for [heroku](http://heroku.com).
+
+Oh, and everything that can be done with git, _is_.
+
+how it works
+------------
+
+- content is entirely managed through **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**.
+- toto was built to take advantage of _HTTP caching_.
+- toto was built with heroku in mind.
+- 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.
+- summaries are generated intelligently by toto, following the `:max` setting you give it.
+- you can also define how long your summary is, by adding `~` at the end of it (`:delim`).
+
+dorothy-with-glinda
+-------------------
+
+Dorothy-with-glinda is glinda's default template, you can get it at <http://github.com/rschmukler/dorothy-with-glinda>. It
+comes with a very minimalistic but functional template, and a _config.ru_ file to get you started.
+It also includes a Gemfile file, for heroku and bundler.
+
+synopsis
+--------
+
+One would start by installing _glinda_, with `sudo gem install glinda`, and then forking or
+cloning the `dorothy-with-glinda` repo, to get a basic skeleton:
+
+    $ git clone git://github.com/rschmukler/dorothy-with-glinda.git weblog
+    $ cd weblog/
+
+One would then edit the template at will, it has the following structure:
+
+    templates/
+    |
+    +- layout.rhtml      # the main site layout, shared by all pages
+    |
+    +- index.builder     # the builder template for the atom feed
+    |
+    +- pages/            # pages, such as home, about, etc go here
+       |
+       +- index.rhtml    # the default page loaded from `/`, it displays the list of articles
+       |
+       +- article.rhtml  # the article (post) partial and page
+       |
+       +- about.rhtml
+
+One could then create a .txt article file in the `articles/` folder, and make sure it has the following format:
+
+    title: The Wonderful Wizard of Oz
+    author: Lyman Frank Baum
+    date: 1900/05/17
+
+    Dorothy lived in the midst of the great Kansas prairies, with Uncle Henry,
+    who was a farmer, and Aunt Em, who was the farmer's wife.
+
+If one is familiar with webby or aerial, this shouldn't look funny. Basically the top of the file is in YAML format,
+and the rest of it is the blog post. They are delimited by an empty line `/\n\n/`, as you can see above.
+None of the information is compulsory, but it's strongly encouraged you specify it.
+Note that one can also use `rake` to create an article stub, with `rake new`.
+
+Once he finishes writing his beautiful tale, one can push to the git repo, as usual:
+
+    $ git add articles/wizard-of-oz.txt
+    $ git commit -m 'wrote the wizard of oz.'
+    $ git push remote master
+
+Where `remote` is the name of your remote git repository. The article is now published.
+
+### deployment
+
+Toto is built on top of **Rack**, and hence has a **rackup** file: _config.ru_.
+
+#### on your own server
+
+Once you have created the remote git repo, and pushed your changes to it, you can run toto with any Rack compliant web server,
+such as **thin**, **mongrel** or **unicorn**.
+
+With thin, you would do something like:
+
+    $ thin start -R config.ru
+
+With unicorn, you can just do:
+
+    $ unicorn
+
+#### on heroku
+
+Toto, and subsequently Glinda, 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 weblog
+    $ git push heroku master
+    $ 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 are the defaults, to get you started:
+
+    set :author,      ENV['USER']                               # blog author
+    set :title,       Dir.pwd.split('/').last                   # site title
+    set :url,         'http://example.com'                      # site root URL
+    set :prefix,      ''                                        # common path prefix for all pages
+    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,     :max => 150, :delim => /~\n/              # length of article summary and delimiter
+    set :ext,         'txt'                                     # file extension for articles
+    set :cache,       28800                                     # cache site for 8 hours
+
+    set :to_html   do |path, page, ctx|                         # returns an html, from a path & context
+      ERB.new(File.read("#{path}/#{page}.rhtml")).result(ctx)
+    end
+
+    set :error     do |code|                                    # The HTML for your error page
+      "<font style='font-size:300%'>toto, we're not in Kansas anymore (#{code})</font>"
+    end
+
+thanks
+------
+
+To cloudhead for the awesome Toto platform
+
+Copyright (c) 2012

data/Rakefile

@@ -0,0 +1,31 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "glinda"
+    gem.summary = %Q{Toto, expanded}
+    gem.description = %Q{Toto, expanded}
+    gem.email = "ryan@slingingcode.com"
+    gem.homepage = "http://github.com/rschmukler/glinda"
+    gem.authors = ["rschmukler"]
+    gem.add_development_dependency "rspec"
+    gem.add_dependency "builder"
+    gem.add_dependency "rack"
+    if RUBY_PLATFORM =~ /win32/
+      gem.add_dependency "maruku"
+    else
+      gem.add_dependency "rdiscount"
+    end
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/lib/ext/ext.rb

@@ -0,0 +1,52 @@
+class Object
+  def meta_def name, &blk
+    (class << self; self; end).instance_eval do
+      define_method(name, &blk)
+    end
+  end
+end
+
+class String
+  def slugize
+    self.downcase.gsub(/&/, 'and').gsub(/\s+/, '-').gsub(/[^a-z0-9-]/, '')
+  end
+
+  def humanize
+    self.capitalize.gsub(/[-_]+/, ' ')
+  end
+
+  if RUBY_VERSION < "1.9"
+    def bytesize
+      size
+    end
+  end
+end
+
+class Fixnum
+  def ordinal
+    # 1 => 1st
+    # 2 => 2nd
+    # 3 => 3rd
+    # ...
+    case self % 100
+      when 11..13; "#{self}th"
+    else
+      case self % 10
+        when 1; "#{self}st"
+        when 2; "#{self}nd"
+        when 3; "#{self}rd"
+        else    "#{self}th"
+      end
+    end
+  end
+end
+
+class Date
+  # This check is for people running Toto with ActiveSupport, avoid a collision
+  unless respond_to? :iso8601
+    # Return the date as a String formatted according to ISO 8601.
+    def iso8601
+      ::Time.utc(year, month, day, 0, 0, 0, 0).iso8601
+    end
+  end
+end