TwP-webby 0.9.0

data/History.txt

@@ -0,0 +1,176 @@
+== 0.9.0 / 2008-08-25
+
+* 2 major enhancements
+  - The "rake" command line tool has been replaced by the "webby"
+    command line tool for day to day site tasks
+  - Now using the "rdiscount" gem for markdown syntax
+* 4 minor enhancements
+  - Layouts can exist in subdirectories of the layouts folder
+  - Addition of a "tumblog" template
+  - Addition of a sitemap file (Ana Nelson)
+  - Updated to version 6.4.2 of ImageMagick for tex2img conversions
+* 5 bug fixes
+  - Better error message when an unkonwn filter is given
+  - Table of contents generation bug
+  - Failing to clean out the "content_for" cache when doing a
+    multi-page render
+  - Explicitly loading the RedCloth gem
+  - Handling exceptions from system calls on the Windows platform
+
+== 0.8.4 / 2008-06-03
+
+* 1 minor improvement
+  - Global defaults for HAML and SASS [Dag Odenhall]
+* 1 bug fix
+  - Added the blog templates to the package
+
+== 0.8.3 / 2008-06-02
+
+* 2 major enhancements
+  - Added blogging support
+  - Added S5 slide presentation support
+* 6 minor enhancements
+  - Changed the arguments to the DB#find method
+  - Added locals support for page templates
+  - Updated atom feed generation template
+  - Partials now support local variables when rendering
+  - Can guard rendering results from processing by subsequent filters
+    (useful when rendering partials or embedding other pages)
+  - Support for "content_for" style captures [M@ McCray]
+* 5 bug fixes
+  - Fixed reference to an non-existent Error class
+  - Basepath filter now handles XML files properly
+  - Removed the "--delete" flag from the rsync options [Denis Defreyne]
+  - Fixed a nil cursor bug in the rendering filter stack
+  - Recursive find now works from the root content folder (bug 20281)
+
+== 0.8.2 / 2008-03-12
+
+* 2 bug fixes
+  - Fixed an error when paginating on an index page
+  - Fixed an error where leading and trailing whitespace was being
+    stripped from syntax highlighted code blocks
+
+== 0.8.1 / 2008-03-09
+
+* 2 major enhancement
+  - Added support for UltraViolet syntax highlighting
+    (code provided by Guillaume Carbonneau)
+  - Added rake tasks to validate the hyperlinks for the HTML files
+    in the output directory
+* 2 minor enhancements
+  - Improved error handling and reporting during the build process
+  - Added site defaults for the helpers (coderay, graphviv, latex,
+    etc.)
+* 1 bug fix
+  - Fixed an error with the prev / next calls in the paginator and
+    rendering links to those pages
+
+== 0.8.0 / 2008-02-28
+
+* 3 major enhancements
+  - Added support for partials
+  - Refactored the coderay and graphviz filters into helper methods
+    accessible from ERB
+  - Added support for embedding LaTeX mathematical equations
+* 3 minor enhancements
+  - Added a template file for creating Atom feeds
+  - The SITE configuration is available in pages and layouts as
+    the @config variable
+  - Can specify the port the Heel webserver starts on using the
+    SITE.heel_port option in the Rakefile
+* 2 bug fixes
+  - When creating pages in directory mode the full page path was
+    not being created
+  - Read only files were being created in the output folder
+    preventing them from being overwritten if changed
+
+== 0.7.4 / 2008-02-15
+
+* 3 minor enhancements
+  - Added "limit" and "sort_by" options to the pages find method
+  - Removed dependency on RedCloth for outline generation
+  - Added some more options for outline generation, numbering, and
+    table of contents generation
+* 1 bug fix
+  - Fixed incompatibility with the new logging library
+
+== 0.7.3 / 2008-02-05
+
+* 2 bug fixes
+  - The setup.rb task now requires rubygems in case it is not in the
+    user's rubyopt
+  - Fixed file line endings on Windows when creating a new site
+
+== 0.7.2 / 2008-02-02
+
+* 4 minor enhancements
+  - Created a URI base path rewriter filter
+  - Create an outline filter for generating table of contents
+  - Pages can be created as files or as directories
+  - The @pages find method now recurses into sub-directories
+* 3 bug fixes
+  - Fixed a bug in the graphviz filter where the wrong map ID was
+    being generated
+  - Now passing the binding of the Renderer to the HAML filter
+    (this makes the @page, @pages availabe in HAML pages)
+  - The created_at attribute was not being created as a YAML
+    time object
+
+== 0.7.1 / 2008-01-03
+
+* 2 bug fixes
+  - No longer appending a '.' to files without an extension (like .htaccess)
+    (patch supplied by Stephen Duncan)
+  - Fixed a "No such file or directory" error when creating pages
+    from templates
+
+== 0.7.0 / 2008-01-01
+
+* 1 major enhancement
+  - Refactored how the filters are handled (thanks Bruce Williams)
+* 2 minor enhancements
+  - Added helper methods for URL and anchor generation
+  - Added rake task to delete the generated website
+* 2 bug fixes
+  - Fixed a bug arising from the order of the logger creation
+  - Removed the file extension form the page defaults
+    (should be set in the layout or the page itself)
+
+== 0.6.0 / 2007-12-04
+
+* Added support for embedded graphviz images and image maps
+* Tidy can be used as a filter to format HTML and check for errors
+* Simplified coderay when used with textile
+
+== 0.5.1 / 2007-11-29
+
+* Growl notifications now work on Leopard / Tiger
+* Fixed a few things for compatibility with Ruby 1.9
+
+== 0.5.0 / 2007-11-26
+
+* Launching heel now works on Windows boxen
+* Now using "logging" gem to output build status
+* Updated find routine for the pages DB
+* First whack at pagination support
+
+== 0.4.0 / 2007-09-18
+
+* Updated the Blueprint CSS stylesheets to version 0.5
+* Updating documentation and comments
+
+== 0.3.0 / 2007-09-17
+
+* Added support for CodeRay syntax highlighting
+
+== 0.2.0 / 2007-08-28
+
+* Updated rake tasks for website deployment
+* Can use 'heel' and 'launchy' for viewing websites
+* Webby executable can update rake tasks for existing websites
+* Added more rdoc documentation to classes
+
+== 0.1.0 / 2007-08-22
+
+* Birthday!

data/Manifest.txt

@@ -0,0 +1,173 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+bin/webby
+bin/webby-gen
+examples/blog/Sitefile
+examples/blog/tasks/blog.rake
+examples/blog/templates/atom_feed.erb
+examples/blog/templates/blog/month.erb
+examples/blog/templates/blog/post.erb
+examples/blog/templates/blog/year.erb
+examples/presentation/Sitefile
+examples/presentation/content/css/uv/twilight.css
+examples/presentation/content/presentation/_sample_code.txt
+examples/presentation/content/presentation/index.txt
+examples/presentation/content/presentation/s5/blank.gif
+examples/presentation/content/presentation/s5/bodybg.gif
+examples/presentation/content/presentation/s5/framing.css
+examples/presentation/content/presentation/s5/iepngfix.htc
+examples/presentation/content/presentation/s5/opera.css
+examples/presentation/content/presentation/s5/outline.css
+examples/presentation/content/presentation/s5/pretty.css
+examples/presentation/content/presentation/s5/print.css
+examples/presentation/content/presentation/s5/s5-core.css
+examples/presentation/content/presentation/s5/slides.css
+examples/presentation/content/presentation/s5/slides.js
+examples/presentation/layouts/presentation.txt
+examples/presentation/templates/_code_partial.erb
+examples/presentation/templates/presentation.erb
+examples/tumblog/Sitefile
+examples/tumblog/content/css/tumblog.css
+examples/tumblog/content/images/tumblog/permalink.gif
+examples/tumblog/content/images/tumblog/rss.gif
+examples/tumblog/content/tumblog/200806/the-noble-chicken/index.txt
+examples/tumblog/content/tumblog/200807/historical-perspectives-on-the-classic-chicken-joke/index.txt
+examples/tumblog/content/tumblog/200807/mad-city-chickens/index.txt
+examples/tumblog/content/tumblog/200807/the-wisdom-of-the-dutch/index.txt
+examples/tumblog/content/tumblog/200807/up-a-tree/index.txt
+examples/tumblog/content/tumblog/index.txt
+examples/tumblog/content/tumblog/rss.txt
+examples/tumblog/layouts/tumblog/default.txt
+examples/tumblog/layouts/tumblog/post.txt
+examples/tumblog/lib/tumblog_helper.rb
+examples/tumblog/tasks/tumblog.rake
+examples/tumblog/templates/atom_feed.erb
+examples/tumblog/templates/tumblog/conversation.erb
+examples/tumblog/templates/tumblog/link.erb
+examples/tumblog/templates/tumblog/photo.erb
+examples/tumblog/templates/tumblog/post.erb
+examples/tumblog/templates/tumblog/quote.erb
+examples/webby/Sitefile
+examples/webby/content/communicate/index.txt
+examples/webby/content/css/background.gif
+examples/webby/content/css/blueprint/print.css
+examples/webby/content/css/blueprint/screen.css
+examples/webby/content/css/coderay.css
+examples/webby/content/css/site.css
+examples/webby/content/css/uv/twilight.css
+examples/webby/content/index.txt
+examples/webby/content/learn/index.txt
+examples/webby/content/reference/index.txt
+examples/webby/content/release-notes/rel-0-9-0/index.txt
+examples/webby/content/robots.txt
+examples/webby/content/script/jquery.corner.js
+examples/webby/content/script/jquery.js
+examples/webby/content/sitemap.txt
+examples/webby/content/tips_and_tricks/index.txt
+examples/webby/content/tutorial/index.txt
+examples/webby/content/user-manual/index.txt
+examples/webby/layouts/default.txt
+examples/webby/templates/page.erb
+examples/website/Sitefile
+examples/website/content/css/blueprint/License.txt
+examples/website/content/css/blueprint/Readme.txt
+examples/website/content/css/blueprint/compressed/print.css
+examples/website/content/css/blueprint/compressed/screen.css
+examples/website/content/css/blueprint/lib/forms.css
+examples/website/content/css/blueprint/lib/grid.css
+examples/website/content/css/blueprint/lib/grid.png
+examples/website/content/css/blueprint/lib/ie.css
+examples/website/content/css/blueprint/lib/reset.css
+examples/website/content/css/blueprint/lib/typography.css
+examples/website/content/css/blueprint/plugins/buttons/Readme
+examples/website/content/css/blueprint/plugins/buttons/buttons.css
+examples/website/content/css/blueprint/plugins/buttons/icons/cross.png
+examples/website/content/css/blueprint/plugins/buttons/icons/key.png
+examples/website/content/css/blueprint/plugins/buttons/icons/tick.png
+examples/website/content/css/blueprint/plugins/css-classes/Readme
+examples/website/content/css/blueprint/plugins/css-classes/css-classes.css
+examples/website/content/css/blueprint/plugins/fancy-type/Readme
+examples/website/content/css/blueprint/plugins/fancy-type/fancy-type-compressed.css
+examples/website/content/css/blueprint/plugins/fancy-type/fancy-type.css
+examples/website/content/css/blueprint/print.css
+examples/website/content/css/blueprint/screen.css
+examples/website/content/css/coderay.css
+examples/website/content/css/site.css
+examples/website/content/index.txt
+examples/website/layouts/default.txt
+examples/website/lib/breadcrumbs.rb
+examples/website/templates/_partial.erb
+examples/website/templates/page.erb
+examples/website/templates/presentation.erb
+lib/webby.rb
+lib/webby/apps.rb
+lib/webby/apps/generator.rb
+lib/webby/apps/main.rb
+lib/webby/auto_builder.rb
+lib/webby/builder.rb
+lib/webby/core_ext/enumerable.rb
+lib/webby/core_ext/hash.rb
+lib/webby/core_ext/kernel.rb
+lib/webby/core_ext/string.rb
+lib/webby/core_ext/time.rb
+lib/webby/filters.rb
+lib/webby/filters/basepath.rb
+lib/webby/filters/erb.rb
+lib/webby/filters/haml.rb
+lib/webby/filters/markdown.rb
+lib/webby/filters/outline.rb
+lib/webby/filters/sass.rb
+lib/webby/filters/slides.rb
+lib/webby/filters/textile.rb
+lib/webby/filters/tidy.rb
+lib/webby/helpers.rb
+lib/webby/helpers/capture_helper.rb
+lib/webby/helpers/coderay_helper.rb
+lib/webby/helpers/graphviz_helper.rb
+lib/webby/helpers/tag_helper.rb
+lib/webby/helpers/tex_img_helper.rb
+lib/webby/helpers/ultraviolet_helper.rb
+lib/webby/helpers/url_helper.rb
+lib/webby/link_validator.rb
+lib/webby/renderer.rb
+lib/webby/resources.rb
+lib/webby/resources/db.rb
+lib/webby/resources/file.rb
+lib/webby/resources/layout.rb
+lib/webby/resources/page.rb
+lib/webby/resources/partial.rb
+lib/webby/resources/resource.rb
+lib/webby/resources/static.rb
+lib/webby/stelan/mktemp.rb
+lib/webby/stelan/paginator.rb
+lib/webby/stelan/spawner.rb
+lib/webby/tasks/build.rake
+lib/webby/tasks/create.rake
+lib/webby/tasks/deploy.rake
+lib/webby/tasks/growl.rake
+lib/webby/tasks/heel.rake
+lib/webby/tasks/validate.rake
+spec/core_ext/hash_spec.rb
+spec/core_ext/string_spec.rb
+spec/core_ext/time_spec.rb
+spec/spec.opts
+spec/spec_helper.rb
+spec/webby/apps/generator_spec.rb
+spec/webby/apps/main_spec.rb
+spec/webby/helpers/capture_helper_spec.rb
+spec/webby/resources/file_spec.rb
+spec/webby/resources_spec.rb
+tasks/ann.rake
+tasks/bones.rake
+tasks/gem.rake
+tasks/git.rake
+tasks/manifest.rake
+tasks/notes.rake
+tasks/post_load.rake
+tasks/rdoc.rake
+tasks/rubyforge.rake
+tasks/setup.rb
+tasks/spec.rake
+tasks/website.rake

data/README.txt

@@ -0,0 +1,92 @@
+Webby
+
+* {Homepage}[http://webby.rubyforge.org/]
+* {Rubyforge Project}[http://rubyforge.org/projects/webby]
+* email tim dot pease at gmail dot com
+
+== DESCRIPTION:
+
+*Webby* is a fantastic little website management system. It would be called a _content management system_ if it were a bigger kid. But, it's just a runt with a special knack for transforming text. And that's really all it does - manages the legwork of turning text into something else, an *ASCII Alchemist* if you will.
+
+Webby works by combining the contents of a *page* with a *layout* to produce HTML. The layout contains everything common to all the pages - HTML headers, navigation menu, footer, etc. - and the page contains just the information for that page. You can use your favorite markup language to write your pages; Webby supports quite a few.
+
+Install Webby and try it out!
+
+== FEATURES:
+
+* choose your templating language: *ERB*, *Textile*, *Markdown*, *HAML*, *SASS*
+* support for "UltraViolet":http://ultraviolet.rubyforge.org/ and "CodeRay":http://coderay.rubychan.de/ syntax highlighting
+* embeddable DOT scripts for "Graphviz":http://www.graphviz.org/ graphs
+* "LaTeX":http://www.latex-project.org/ snippets for mathematical formulas
+* automatically clean up generated content using "Tidy":http://tidy.sourceforge.net/
+* quick and speedy - only builds pages that have changed
+* deploy anywhere - it's just HTML, no special server stuff required
+* happy "rake":http://docs.rubyrake.org/ tasks for deploying your website to a server
+* build new pages from templates for quicker blog posts and news items
+
+But Wait! There's More!
+
+Webby has a great _autobuild_ feature that continuously generates HTML whenever the *pages* or *layouts* change. The HTML is served up via "heel":http://copiousfreetime.rubyforge.org/heel/, a static file webserver based on mongrel. Whenever you change a page, you can immediately see those changes without having to run any commands.
+
+   $ webby autobuild
+   [10:21:26]  INFO: starting autobuild (Ctrl-C to stop)
+   [10:21:26]  INFO: creating output/index.html
+   [10:22:57]  INFO: creating output/index.html
+
+Webby is not limited to producing HTML. By no means! Do you ever get tired of repeating the same color code *#D3C4A2* in your CSS files? Webby can help. Need some customized JavaScript for your website. Webby can help. Anytime you find yourself repeating the same bit of text over and over, then you should be using Webby.
+
+== INSTALL:
+
+   gem install webby
+
+== EXAMPLE:
+
+   $ webby-gen website my_site
+   creating my_site
+
+   $ cd my_site
+
+   $ webby create:page 'new page'
+   creating content/new-page.txt
+
+   $ webby create:page 'another/new page'
+   creating content/another/new-page.txt
+
+   $ webby autobuild
+   [10:21:26]  INFO: starting autobuild (Ctrl-C to stop)
+   [10:21:26]  INFO: creating output/index.html
+   [10:21:26]  INFO: creating output/new-page.html
+   [10:21:26]  INFO: creating output/another/new-page.html
+
+== REQUIREMENTS:
+
+* directory_watcher
+* heel
+* hpricot
+* logging
+* rake
+* rspec
+
+== LICENSE:
+
+MIT License
+Copyright (c) 2007 - 2008
+
+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, sub-license, 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/Rakefile

@@ -0,0 +1,50 @@
+# $Id$
+
+load 'tasks/setup.rb'
+
+ensure_in_path 'lib'
+require 'webby'
+
+task :default => 'spec:specdoc'
+
+PROJ.name = 'webby'
+PROJ.summary = 'static website creation and management'
+PROJ.authors = 'Tim Pease'
+PROJ.email = 'tim.pease@gmail.com'
+PROJ.url = 'http://webby.rubyforge.org/'
+PROJ.description = paragraphs_of('README.txt', 3).join("\n\n")
+PROJ.rubyforge.name = 'webby'
+PROJ.version = Webby::VERSION
+PROJ.release_name = 'Vegan Velociraptor'
+
+PROJ.ruby_opts = %w[-W0]
+PROJ.exclude << %w(^examples/[^/]+/output ^tasks/archive ^tags$ ^webby.gemspec$)
+
+PROJ.rdoc.dir = 'doc/rdoc'
+PROJ.rdoc.remote_dir = 'rdoc'
+PROJ.rdoc.exclude << %w(^examples)
+
+PROJ.spec.opts << '--color'
+
+PROJ.ann.email[:to] << 'webby-forum@googlegroups.com'
+PROJ.ann.email[:server] = 'smtp.gmail.com'
+PROJ.ann.email[:port] = 587
+
+PROJ.ann.text = <<-ANN
+== POST SCRIPT
+
+Visit the Webby forum to chat with other Webby-Heads:
+http://groups.google.com/group/webby-forum
+
+Blessings,
+TwP
+ANN
+
+depend_on 'directory_watcher'
+depend_on 'heel'
+depend_on 'hpricot', '= 0.6.0'
+depend_on 'logging'
+depend_on 'rake'
+depend_on 'rspec'
+
+# EOF

data/bin/webby

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+
+require File.expand_path(
+    File.join(File.dirname(__FILE__), %w[.. lib webby]))
+
+::Webby::Apps::Main.run(ARGV)
+
+# EOF

data/bin/webby-gen

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+
+require File.expand_path(
+    File.join(File.dirname(__FILE__), %w[.. lib webby]))
+
+::Webby::Apps::Generator.run(ARGV)
+
+# EOF

data/examples/blog/Sitefile

@@ -0,0 +1,7 @@
+
+task :default => :build
+
+desc 'deploy the site to the webserver'
+task :deploy => [:build, 'deploy:rsync']
+
+# EOF

data/examples/blog/tasks/blog.rake

@@ -0,0 +1,72 @@
+
+namespace :blog do
+
+  # iterate over all the files in the "templates/blog" folder and create a
+  # rake task corresponding to each file found
+  FileList["#{Webby.site.template_dir}/blog/*"].each do |template|
+    next unless test(?f, template)
+    name = template.pathmap('%n')
+    next if name =~ %r/^(month|year)$/  # skip month/year blog entries
+
+    desc "Create a new blog #{name}"
+    task name => [:create_year_index, :create_month_index] do |t|
+      page, title, dir = Webby::Builder.new_page_info
+
+      # if no directory was given use the default blog directory (underneath
+      # the content directory)
+      dir = Webby.site.blog_dir if dir.empty?
+      dir = File.join(dir, Time.now.strftime('%Y/%m/%d'))
+
+      page = File.join(dir, File.basename(page))
+      page = Webby::Builder.create(page, :from => template,
+                 :locals => {:title => title, :directory => dir})
+      exec(::Webby.editor, page) unless ::Webby.editor.nil?
+    end
+  end  # each
+
+  # this task is used to create the year index file (blog/2008/index.txt)
+  task :create_year_index do |t|
+    # parse out information about the page to create
+    _, _, dir = Webby::Builder.new_page_info
+    year = Time.now.strftime '%Y'
+
+    # if no directory was given use the default blog directory (underneath
+    # the content directory)
+    dir = Webby.site.blog_dir if dir.empty?
+    dir = File.join(dir, year)
+
+    # determine the filename and template name
+    fn = File.join(dir, 'index.txt')
+    tmpl = Dir.glob(File.join(Webby.site.template_dir, 'blog/year.*')).first.to_s
+
+    if test(?f, tmpl) and not test(?f, File.join(Webby.site.content_dir, fn))
+      Webby::Builder.create(fn, :from => tmpl,
+          :locals => {:title => year, :directory => dir})
+    end
+  end
+
+  # this task is used to create the month index file (blog/2008/04/index.txt)
+  task :create_month_index do |t|
+    # parse out information about the page to create
+    _, _, dir = Webby::Builder.new_page_info
+    now = Time.now
+    month = now.strftime '%m'
+
+    # if no directory was given use the default blog directory (underneath
+    # the content directory)
+    dir = Webby.site.blog_dir if dir.empty?
+    dir = File.join(dir, now.strftime('%Y/%m'))
+
+    # determine the filename and template name
+    fn = File.join(dir, 'index.txt')
+    tmpl = Dir.glob(File.join(Webby.site.template_dir, 'blog/month.*')).first.to_s
+
+    if test(?f, tmpl) and not test(?f, File.join(Webby.site.content_dir, fn))
+      Webby::Builder.create(fn, :from => tmpl,
+          :locals => {:title => month, :directory => dir})
+    end
+  end
+
+end  # namespace :blog
+
+# EOF

data/examples/blog/templates/atom_feed.erb

@@ -0,0 +1,40 @@
+---
+title:     A New Atom Feed
+subtitle:  A really swell blog built with Webby
+site:      fake-n-site.org
+author:    Author's Name
+email:     author@fake-n-site.org
+extension: xml
+layout:    nil
+dirty:     true
+filter:    erb
+---
+<?xml version="1.0" encoding="utf-8"?>
+<feed xmlns="http://www.w3.org/2005/Atom">
+ 
+  <title><%%= h(@page.title) %></title>
+  <subtitle><%%= h(@page.subtitle) %></subtitle>
+  <link href="http://<%%= @page.site %>/<%= directory %>/" rel="self" />
+  <link href="http://<%%= @page.site %>/" />
+  <updated><%%= Time.now.xmlschema %></updated>
+  <author>
+    <name><%%= h(@page.author) %></name>
+    <email><%%= h(@page.email) %></email>
+  </author>
+  <id>http://<%%= @page.site %>/</id>
+  <%% @pages.find(:limit => 10,
+                 :in_directory => '<%= directory %>',
+                 :recursive => true,
+                 :sort_by => 'mtime',
+                 :reverse => true).each do |article|
+    next if article == @page
+  %>
+  <entry>
+    <title><%%= h(article.title) %></title>
+    <link href="<%%= article.url %>" />
+    <id>tag:<%%= @page.site %>,<%%= article.created_at.strftime('%Y-%m-%d') %>:<%%= article.created_at.to_i %></id>
+    <updated><%%= article.created_at.xmlschema %></updated>
+    <content type="html"><%%= h(render(article)) %></content>
+  </entry>
+  <%% end %>
+</feed>

data/examples/blog/templates/blog/month.erb

@@ -0,0 +1,22 @@
+---
+title:      <%= title %>
+created_at: <%= Time.now.to_y %>
+filter:     erb
+dirty:      true
+---
+<h2><%%= h(@page.title) %></h2>
+
+<%%
+  articles = @pages.find(:all, :in_directory => @page.dir, :recursive => true,
+      :sort_by => "created_at", :reverse => true, :blog_post => true)
+  articles.delete(@page)
+  paginate(articles, 10) do |page|
+-%>
+<div class="article">
+  <h1><%%= link_to_page(page) %><span class="date">(<%%= page.created_at.strftime('%Y-%m-%d') %>)</span></h1>
+
+  <div class="body">
+    <%%= render(page) %>
+  </div>
+</div>
+<%% end -%>

data/examples/blog/templates/blog/post.erb

@@ -0,0 +1,16 @@
+--- 
+title:      <%= title %>
+created_at: <%= Time.now.to_y %>
+blog_post:  true
+filter:
+  - textile
+--- 
+Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Nunc congue ipsum vestibulum libero. Aenean vitae justo. Nam eget tellus. Etiam convallis, est eu lobortis mattis, lectus tellus tempus felis, a ultricies erat ipsum at metus.
+
+h3. Litora Sociis
+
+Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Morbi et risus. Aliquam nisl. Nulla facilisi. Cras accumsan vestibulum ante. Vestibulum sed tortor. Praesent tempus fringilla elit. Ut elit diam, sagittis in, nonummy in, gravida non, nunc. Ut orci. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos hymenaeos. Nam egestas, orci eu imperdiet malesuada, nisl purus fringilla odio, quis commodo est orci vitae justo. Aliquam placerat odio tincidunt nulla. Cras in libero. Aenean rutrum, magna non tristique posuere, erat odio eleifend nisl, non convallis est tortor blandit ligula. Nulla id augue.
+
+bq. Nullam mattis, odio ut tempus facilisis, metus nisl facilisis metus, auctor consectetuer felis ligula nec mauris. Vestibulum odio erat, fermentum at, commodo vitae, ultrices et, urna. Mauris vulputate, mi pulvinar sagittis condimentum, sem nulla aliquam velit, sed imperdiet mi purus eu magna. Nulla varius metus ut eros. Aenean aliquet magna eget orci. Class aptent taciti sociosqu ad litora.
+
+Vivamus euismod. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Suspendisse vel nibh ut turpis dictum sagittis. Aliquam vel velit a elit auctor sollicitudin. Nam vel dui vel neque lacinia pretium. Quisque nunc erat, venenatis id, volutpat ut, scelerisque sed, diam. Mauris ante. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Donec mattis. Morbi dignissim sollicitudin libero. Nulla lorem.