toto-bongo 1.0.1

data/.document

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

data/LICENSE

@@ -0,0 +1,23 @@
+Copyright (c) 2011 Daniel Palacio
+
+
+Copyright (c) 2009 cloudhead
+
+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,186 @@
+toto bongo
+====
+
+Minimal blog forked from toto to use for your existing app's. 
+This is very useful for SEO optimization
+
+
+introduction
+------------
+
+toto-bongo is a git-powered, minimalist blog engine forked from toto. 
+There is no toto client, and there probably will never be, everything goes through git.
+From the security stand point, this makes toto-bongo very secure. By
+reducing the attack surface( we don't handle any user input) we've made
+a blog you can trust. 
+Other blogs have administration panels, sessions, cookies etc, that lead
+to security vulnerabilities, toto-bongo has non of that.
+
+blog in your app in 10 seconds
+------------------
+
+Toto-bongo 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)**.
+
+This is how to deploy in your existing app:
+
+1. git clone git@github.com:danpal/toto-bongo-blog.git
+2. Look at toto-bongo-blog Gemfile, add the following gems to your
+   Gemfile.
+  
+  gem 'toto-bongo'
+  gem 'builder'
+  gem 'RedCloth'
+  gem 'haml'
+  
+3. Toto-bongo runs on rack, you need to modify your existing config.ru
+we provide you with an already existing config.ru, take a look at
+toto-bongo-blog config.ru
+(note this file might be outdated here, look at the one in the
+toto-bongo-blog)
+<pre><code>
+    # This file is used by Rack-based servers to start the application.
+    require 'toto-bongo'
+    require ::File.expand_path('../config/environment', __FILE__)
+    
+    #point to your rails apps /public directory
+    use Rack::Static, :urls => ['/stylesheets', '/javascripts', '/images', '/favicon.ico'], :root => 'public'
+    
+    use Rack::ShowExceptions
+    use Rack::CommonLogger
+    
+    #run the toto application
+    toto_bongo = TotoBongo::Server.new do
+    
+      #override the default location for the toto directories
+      TotoBongo::Paths = {
+        :templates => "blog/templates",
+        :pages => "blog/templates/pages",
+        :articles => "blog/articles"
+      }
+    
+      # set your config variables here
+      set :title, 'toto-bongo blog'
+      set :date, lambda {|now| now.strftime("%B #{now.day.ordinal} %Y") }
+      set :summary, :max => 500
+      set :root, 'index'
+      set :prefix, 'blog'
+    
+      if RAILS_ENV != 'production'
+        set :url, "http://localhost:3000/blog/"
+      else
+        set :url, "http://toto-bongo.heroku.com/blog/" #EDIT THIS TO ADD YOUR OWN URL
+      end
+    end
+    
+    #create a rack app
+    app = Rack::Builder.new do
+      use Rack::CommonLogger
+    
+      #map requests to /blog to toto
+      map '/blog' do
+        run toto_bongo
+      end
+    
+      #map all the other requests to rails
+      map '/' do
+        if Rails.version.to_f >= 3.0
+          ActionDispatch::Static
+          #run [ApplicationName]::Application
+          run TotoBongoBlog::Application #change for your application name
+        else # Rails 2
+          use Rails::Rack::Static
+          run ActionController::Dispatcher.new
+        end
+      end
+    end.to_app
+    
+</code></pre>
+
+Then make the following changes
+  1. Change :title
+  2. Run TotoBongoBlog::Application #change for your application name
+  
+
+
+
+
+
+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 textile converter(RedCloth) by default.
+- templating is done through **HAML**.
+- 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`).
+
+toto-blog
+-------
+
+### 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
+
+### 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,      'blog'                                        # 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 :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-bongo, error (#{code})</font>"
+    end
+
+### Development
+
+rake gemspec: To generate the gemspec
+gem build toto-bongo.gemspec to build
+
+If you are developing use the following enviromental variable to get
+some debugging output
+export TOTODEBUG=true 
+
+
+
+thanks
+------
+
+To toto team, as they are the real developers behind toto.
+
+

data/Rakefile

@@ -0,0 +1,31 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "toto-bongo"  
+    gem.summary = %Q{Tiny blog for your existing app}
+    gem.description = %Q{Minimal blog to use with your existing app}
+    gem.homepage = "https://github.com/danpal/toto-bongo"
+    gem.authors = ["Daniel Palacio"]
+    gem.add_development_dependency "riot"
+    gem.add_dependency "builder"
+    gem.add_dependency "rack"
+    gem.add_dependency "RedCloth"
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/*_test.rb'
+  test.verbose = true
+end
+
+task :test => :check_dependencies
+task :default => :test
+

data/VERSION

@@ -0,0 +1 @@
+1.0.1

data/lib/ext/ext.rb

@@ -0,0 +1,46 @@
+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
+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 Bongo 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