tributary 0.0.1

data/README.md

@@ -0,0 +1,99 @@
+tributary
+=========
+
+A tiny, heavily [toto](http://cloudhead.io/toto)-inspired and (no less heavily) [Sinatra](http://www.sinatrarb.com/)-powered blogging engine.
+
+
+
+Overview
+--------
+
+tributary aggregates a set of `Item`s, representing individual website contents (blog posts, photolog entries, standalone pages, etc.) stored in YAML-enhanced Markdown files, and allows accessing them with a simple 1:1 URL-to-filename mapping. All `Item`s with a publication date are combined into a `Stream`, which can be interated over (to, e.g., display the seven most recent `Item`s, or all photos) or navigated from inside (to get the `Item` that’s previous/subsequent to the current one).
+
+
+
+Items
+-----
+
+An `Item` is represented in the filesystem in the form of text file with a Markdown body and a YAML header:
+
+    date: 2010-07-15
+    title: welcome to tributary
+    
+    tributary _welcome_ article
+
+The above example, if stored as `articles/welcome.md`, will be seen in tributary as an `Item` object with `Item#body` returning the kramdown-generated `<p>tributary <em>welcome</em> article</p>\n`, `Item#title` and `Item#date` returning YAML-parsed `welcome to tributary` and `2010-07-15 00:00:00 +0200`, while `Item#type` and `Item#path` will be inherited from the filesystem location and return `:articles` and `welcome`, respectively.
+
+
+
+Item types
+----------
+
+Every `Item` has a type, inherited from the `Item`’s position in the filesystem and returned by `Item#type`. When a given `Item` is requested over HTTP (via its `Item#path`) the view associated with its type is rendered; this allows rendering different HTML/CSS layouts for different content types (‘static’ pages vs blog posts vs photolog entries, for example).
+
+
+
+Views
+-----
+
+As mentioned above, every `Item` has an associated type, and this type defines the HTML view displayed when the given `Item` is requested; this allows for different rendering of e.g. static pages vs photolog entries. The views are written in [Haml](http://haml-lang.com/) and are located in `views/*.haml` files, with the file’s basename equal to the `Item`’s type.
+
+Additionally, for every type the URL with that type’s name can be accessed (for example `http://…/pages`, assuming at least in one case `Item#type` returns `:pages`). In this case, the relevant `views/*.index.haml` Haml view is rendered (so `views/pages.index.haml` in the aforementioned example). These views can be used to create custom category-like pages – e.g., a page indexing all of your photographs that renders their thumbnails.
+
+
+
+Stream
+------
+
+The `Stream` object contains all tributary `Item`s ordered by their publication date (if present) and can be queried to return a given number of the most recent `Item`s or an `Item` previous of (or subsequent to) a given `Item` (the returned `Item`(s) take into account the current `locale` and `lang_limit` settings). Every such query can additionally filter the `Stream` and for example request the subsequent `Item` that is also a photolog entry.
+
+
+
+Multilingual support
+--------------------
+
+There are two session variables governing the user’s language preferences: `locale` and `lang_limit`. The first sets the user’s preferred language (and, for example, allows for a localised user interface), while the second limits the contents returned from the `Stream`.
+
+Every `Item` can have multiple language versions (stored in `<type>/<path>.*.md` files, where `*` maps to the relevant locale) and/or a language-agnostic version (stored in the `<type>/<path>.md` file). When a given `Item` is requested (via the `http://…/<path>` URL) tributary chooses the language version most suitable for the request, based on either an explicit `locale` cookie sent along with the request or the `Accept-Language` HTTP header. If the preferred language version is not available, tributary falls back to the language-agnostic version or (if there’s no such version) to a language version that’s not explicitely filtered out by the `lang_limit` setting.
+
+The site’s interface can be multilingualised using [R18n](http://r18n.rubyforge.org/) (via [R18n for Sinatra](http://r18n.rubyforge.org/sinatra.html)). The `t` object (available in views) can be sent messages like `t.recent_items`, which are translated to the relevant localised strings based on YAML entries in `i18n/*.yml` files (where `*` maps to the current user’s `locale`). The example `i18n/en.yml` file (in the `spec/site` directory) contains
+
+    recent_items: recent items
+
+while the example `i18n/pl.yml` file contains
+
+    recent_items: najnowsze
+
+– and so the `views/index.haml` view used by the spec site can call `t.recent_items` to get a properly localised string (note that `Tributary::App` already registers `Sinatra::R18n` and exposes `locale` to the session, while also setting the `locale` to either the user’s preference, their browser configuration’s default or English, so there’s nothing more that needs to be done).
+
+
+
+Configuration
+-------------
+
+Application-level configuration is stored right on the `App` object itself; see the example `config.ru`, which happens to serve the site used by specs:
+
+    Tributary::App.configure do |config|
+      config.set :author,   'Ary Tribut'
+      config.set :root,     'spec/site'
+      config.set :sitename, 'a tributary site'
+    end
+
+User-level configuration is also stored on the `App` object and can be operated on by visiting the `/set?option=value` URLs – for example, setting the `locale` to English and `lang_limit` to English and Polish can be done by visiting the `/set?locale=en&lang_limit=en+pl` URL.
+
+The `user_prefs` config option contains a list of settings that can be altered by visiting `/set` (and defaults to `[:lang_limit, :locale]`) – changing this option (by setting it as above in `config.ru`, for example) allows the users to alter other (e.g., nonexistent by default) settings and see the changes reflected on the `App` object.
+
+The settings altered by the user are kept in the given user’s session and so persist between requests and visits.
+
+
+
+Plugins
+-------
+
+Plugins (put in the `App.plugins` `Array`) are objects which can be sent a `handle` method with an `Item` as a parameter and are expected to return the `Item` (so the calls to subsequent plugins are chainable). See the `Mnml` plugin for an example implementation utilising a `SimpleDelegator` to filter the given `Item`’s `body` and `title` methods.
+
+
+
+---
+
+© MMX Piotr Szotkowski <chastell@chastell.net>, licensed under AGPL 3 (see LICENCE)

data/Rakefile

@@ -0,0 +1,5 @@
+require 'rspec/core/rake_task'
+
+ENV['TZ'] = 'Europe/Warsaw'
+
+RSpec::Core::RakeTask.new :spec

data/config.ru

@@ -0,0 +1,9 @@
+require './lib/tributary'
+
+Tributary::App.configure do |config|
+  config.set :author,   'Ary Tribut'
+  config.set :root,     'spec/site'
+  config.set :sitename, 'a tributary site'
+end
+
+run Tributary::App

data/lib/tributary/app.rb

@@ -0,0 +1,61 @@
+module Tributary class App < Sinatra::Base
+
+  register Sinatra::R18n
+
+  use Rack::Session::Cookie, expire_after: 60 * 60 * 24 * 365 * 7
+
+  def self.configure *args, &block
+    set :cache?,     production?
+    set :lang_limit, nil
+    set :locale,     nil
+    set :plugins,    []
+    set :user_prefs, [:lang_limit, :locale]
+    super
+    set :stream,     cache? ? Tributary::Stream.new : nil
+  end
+
+  before do
+    Tributary::App.locale     = session[:locale]
+    Tributary::App.lang_limit = session[:lang_limit] && session[:lang_limit].split
+    @stream = Tributary::App.stream || Tributary::Stream.new
+  end
+
+  get '/' do
+    @item = OpenStruct.new type: :index
+    haml @item.type
+  end
+
+  get '/set' do
+    params.each { |key, value| session[key.to_sym] = value if App.user_prefs.map(&:to_s).include? key }
+    redirect request.referer
+  end
+
+  get '/:feed.xml' do |feed|
+    content_type 'application/atom+xml'
+    feed, App.locale, lang_limit = feed.split '.'
+    App.lang_limit = lang_limit.split if lang_limit
+    File.exists?("#{App.views}/#{feed}.xml.haml") ? haml("#{feed}.xml".to_sym, layout: false) : 404
+  end
+
+  get '/:style.css' do |style|
+    content_type 'text/css'
+    File.exists?("#{App.views}/#{style}.sass") ? sass(style.to_sym) : 404
+  end
+
+  get '/:path' do |path|
+    if @stream.types.map(&:to_s).include? path
+      @item = OpenStruct.new path: path, type: "#{path}.index".to_sym
+    else
+      @item = @stream.pick_item path
+    end
+    @item ? haml(@item.type) : 404
+  end
+
+  error 400...600 do
+    unless response.content_type
+      @item = OpenStruct.new type: :error
+      haml @item.type
+    end
+  end
+
+end end

data/lib/tributary/item.rb

@@ -0,0 +1,66 @@
+# encoding: UTF-8
+
+module Tributary class Item < OpenStruct
+
+  def initialize file
+    @file = file
+    yaml, @body = File.read(@file).split "\n\n", 2
+    super YAML.load yaml
+  end
+
+  def <=> other
+    case
+    when other.date && date then other.date <=> date
+    when date               then -1
+    when other.date         then 1
+    else                         0
+    end.nonzero? or
+    (other.path <=> path).nonzero? or
+    case
+    when lang       == App.locale then -1
+    when other.lang == App.locale then 1
+    when lang.nil?                then -1
+    when other.lang.nil?          then 1
+    else                               lang <=> other.lang
+    end
+  end
+
+  def body
+    Kramdown::Document.new(@body).to_html
+  end
+
+  def date
+    @date ||= case @table[:date]
+              when Date   then @table[:date].to_time
+              when String then Time.parse @table[:date]
+              when Time   then @table[:date]
+              end
+  end
+
+  alias eql? ==
+
+  def hash
+    @file.hash
+  end
+
+  def lang
+    File.basename(@file, '.md').split('.')[1]
+  end
+
+  def path
+    @path ||= File.basename(@file, '.md').split('.').first
+  end
+
+  def published?
+    date and date < Time.now
+  end
+
+  def title
+    @table[:title] or @body.scan(/\p{L}+/).first + '…'
+  end
+
+  def type
+    File.dirname(@file).split('/').last.to_sym
+  end
+
+end end

data/lib/tributary/plugins/dummy.rb

@@ -0,0 +1,7 @@
+module Tributary module Plugins class Dummy
+
+  def handle item
+    item
+  end
+
+end end end

data/lib/tributary/plugins/mnml.rb

@@ -0,0 +1,14 @@
+module Tributary module Plugins class Mnml
+
+  def handle item
+    mnml = SimpleDelegator.new item
+    def mnml.body
+      super.tr 'aeiouy', ''
+    end
+    def mnml.title
+      super.tr 'aeiouy', ''
+    end
+    mnml
+  end
+
+end end end

data/lib/tributary/plugins/unbreak_my_art.rb

@@ -0,0 +1,22 @@
+# encoding: UTF-8
+
+module Tributary module Plugins class UnbreakMyArt
+
+  def handle item
+    unbroken = SimpleDelegator.new item
+    def unbroken.body
+      Plugins::UnbreakMyArt.unbreak super
+    end
+    def unbroken.title
+      Plugins::UnbreakMyArt.unbreak super
+    end
+    unbroken
+  end
+
+  private
+
+  def self.unbreak string
+    string.gsub /((^|[^\p{L}<])\p{L}\p{P}?) /, '\1 '
+  end
+
+end end end

data/lib/tributary/stream.rb

@@ -0,0 +1,51 @@
+module Tributary class Stream
+
+  def initialize root = App.root, plugins = App.plugins
+    @items = Dir["#{root}/*/*.md"].map { |file| Item.new file }
+    plugins.each do |plugin|
+      @items.map! { |item| plugin.handle item }
+    end
+  end
+
+  def langs
+    @items.map(&:lang).uniq.compact.sort
+  end
+
+  def pick_item path
+    path, lang = path.split '.'
+    (lang ? @items.select { |item| item.lang == lang } : @items).sort.find { |item| item.path == path }
+  end
+
+  def previous item, filter = {}
+    published(filter)[published(filter).index { |i| i.path == item.path } + 1] rescue nil
+  end
+
+  def recent limit = nil, filter = {}
+    published(filter).take limit || @items.size
+  end
+
+  def subsequent item, filter = {}
+    published(filter).reverse[published(filter).reverse.index { |i| i.path == item.path } + 1] rescue nil
+  end
+
+  def types
+    @items.map(&:type).uniq.sort
+  end
+
+  private
+
+  def items_ltd filter = {}
+    items_ltd = @items.sort
+    items_ltd.delete_if { |item| item.lang and not App.lang_limit.include? item.lang } if App.lang_limit and not App.lang_limit.empty?
+    filter.each do |method, value|
+      items_ltd = items_ltd.select { |item| item.send(method) == value }
+    end
+    items_ltd.select { |item| item == items_ltd.find { |i| i.path == item.path } }
+  end
+
+  def published filter = {}
+    @published ||= {}
+    @published[[App.lang_limit, App.locale, filter]] ||= items_ltd({published?: true}.merge filter)
+  end
+
+end end

data/lib/tributary.rb

@@ -0,0 +1,8 @@
+require 'kramdown'
+require 'sinatra/base'
+require 'sinatra/r18n'
+require 'yaml'
+
+require_relative 'tributary/app'
+require_relative 'tributary/item'
+require_relative 'tributary/stream'

data/spec/fixtures/index.en.en+pl.xml

@@ -0,0 +1,50 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<feed xmlns='http://www.w3.org/2005/Atom'>
+  <author>
+    <name>Ary Tribut</name>
+  </author>
+  <generator uri='http://github.com/chastell/tributary'>tributary</generator>
+  <id>http://example.org/</id>
+  <link href='http://example.org/' rel='alternate' />
+  <link href='http://example.org/index.en.en+pl.xml' rel='self' />
+  <title>a tributary site</title>
+  <updated>2010-07-23T02:00:00+02:00</updated>
+  <entry>
+    <id>http://example.org/polish</id>
+    <link href='http://example.org/polish' rel='alternate' />
+    <title>ten…</title>
+    <updated>2010-07-23T02:00:00+02:00</updated>
+    <content type='html'>&lt;p&gt;ten beep jest tylko po polsku.&lt;/p&gt;</content>
+  </entry>
+  <entry>
+    <id>http://example.org/english</id>
+    <link href='http://example.org/english' rel='alternate' />
+    <title>this…</title>
+    <updated>2010-07-23T01:00:00+02:00</updated>
+    <content type='html'>&lt;p&gt;this beep is only in English.&lt;/p&gt;</content>
+  </entry>
+  <entry>
+    <id>http://example.org/600</id>
+    <link href='http://example.org/600' rel='alternate' />
+    <title>600th anniversary (English)</title>
+    <updated>2010-07-15T12:00:00+02:00</updated>
+    <content type='html'>
+      &lt;p&gt;600 years ago &lt;a href=&quot;http://en.wikipedia.org/wiki/Battle_of_Grunwald&quot;&gt;something supposedly important&lt;/a&gt;
+      happened around these parts of the world&lt;/p&gt;
+    </content>
+  </entry>
+  <entry>
+    <id>http://example.org/bilingual</id>
+    <link href='http://example.org/bilingual' rel='alternate' />
+    <title>bilinguality</title>
+    <updated>2010-07-15T06:00:00+02:00</updated>
+    <content type='html'>&lt;p&gt;this article is also available &lt;a href=&quot;bilingual.pl&quot;&gt;in Polish&lt;/a&gt;&lt;/p&gt;</content>
+  </entry>
+  <entry>
+    <id>http://example.org/dated</id>
+    <link href='http://example.org/dated' rel='alternate' />
+    <title>a…</title>
+    <updated>2010-07-15T03:00:00+02:00</updated>
+    <content type='html'>&lt;p&gt;a dated beep.&lt;/p&gt;</content>
+  </entry>
+</feed>

data/spec/fixtures/index.en.en.xml

@@ -0,0 +1,50 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<feed xmlns='http://www.w3.org/2005/Atom'>
+  <author>
+    <name>Ary Tribut</name>
+  </author>
+  <generator uri='http://github.com/chastell/tributary'>tributary</generator>
+  <id>http://example.org/</id>
+  <link href='http://example.org/' rel='alternate' />
+  <link href='http://example.org/index.en.en.xml' rel='self' />
+  <title>a tributary site</title>
+  <updated>2010-07-23T01:00:00+02:00</updated>
+  <entry>
+    <id>http://example.org/english</id>
+    <link href='http://example.org/english' rel='alternate' />
+    <title>this…</title>
+    <updated>2010-07-23T01:00:00+02:00</updated>
+    <content type='html'>&lt;p&gt;this beep is only in English.&lt;/p&gt;</content>
+  </entry>
+  <entry>
+    <id>http://example.org/600</id>
+    <link href='http://example.org/600' rel='alternate' />
+    <title>600th anniversary (English)</title>
+    <updated>2010-07-15T12:00:00+02:00</updated>
+    <content type='html'>
+      &lt;p&gt;600 years ago &lt;a href=&quot;http://en.wikipedia.org/wiki/Battle_of_Grunwald&quot;&gt;something supposedly important&lt;/a&gt;
+      happened around these parts of the world&lt;/p&gt;
+    </content>
+  </entry>
+  <entry>
+    <id>http://example.org/bilingual</id>
+    <link href='http://example.org/bilingual' rel='alternate' />
+    <title>bilinguality</title>
+    <updated>2010-07-15T06:00:00+02:00</updated>
+    <content type='html'>&lt;p&gt;this article is also available &lt;a href=&quot;bilingual.pl&quot;&gt;in Polish&lt;/a&gt;&lt;/p&gt;</content>
+  </entry>
+  <entry>
+    <id>http://example.org/dated</id>
+    <link href='http://example.org/dated' rel='alternate' />
+    <title>a…</title>
+    <updated>2010-07-15T03:00:00+02:00</updated>
+    <content type='html'>&lt;p&gt;a dated beep.&lt;/p&gt;</content>
+  </entry>
+  <entry>
+    <id>http://example.org/welcome</id>
+    <link href='http://example.org/welcome' rel='alternate' />
+    <title>welcome to tributary</title>
+    <updated>2010-07-15T00:00:00+02:00</updated>
+    <content type='html'>&lt;p&gt;tributary &lt;em&gt;welcome&lt;/em&gt; article&lt;/p&gt;</content>
+  </entry>
+</feed>

data/spec/fixtures/index.en.xml

@@ -0,0 +1,50 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<feed xmlns='http://www.w3.org/2005/Atom'>
+  <author>
+    <name>Ary Tribut</name>
+  </author>
+  <generator uri='http://github.com/chastell/tributary'>tributary</generator>
+  <id>http://example.org/</id>
+  <link href='http://example.org/' rel='alternate' />
+  <link href='http://example.org/index.en.xml' rel='self' />
+  <title>a tributary site</title>
+  <updated>2010-07-23T02:00:00+02:00</updated>
+  <entry>
+    <id>http://example.org/polish</id>
+    <link href='http://example.org/polish' rel='alternate' />
+    <title>ten…</title>
+    <updated>2010-07-23T02:00:00+02:00</updated>
+    <content type='html'>&lt;p&gt;ten beep jest tylko po polsku.&lt;/p&gt;</content>
+  </entry>
+  <entry>
+    <id>http://example.org/english</id>
+    <link href='http://example.org/english' rel='alternate' />
+    <title>this…</title>
+    <updated>2010-07-23T01:00:00+02:00</updated>
+    <content type='html'>&lt;p&gt;this beep is only in English.&lt;/p&gt;</content>
+  </entry>
+  <entry>
+    <id>http://example.org/600</id>
+    <link href='http://example.org/600' rel='alternate' />
+    <title>600th anniversary (English)</title>
+    <updated>2010-07-15T12:00:00+02:00</updated>
+    <content type='html'>
+      &lt;p&gt;600 years ago &lt;a href=&quot;http://en.wikipedia.org/wiki/Battle_of_Grunwald&quot;&gt;something supposedly important&lt;/a&gt;
+      happened around these parts of the world&lt;/p&gt;
+    </content>
+  </entry>
+  <entry>
+    <id>http://example.org/bilingual</id>
+    <link href='http://example.org/bilingual' rel='alternate' />
+    <title>bilinguality</title>
+    <updated>2010-07-15T06:00:00+02:00</updated>
+    <content type='html'>&lt;p&gt;this article is also available &lt;a href=&quot;bilingual.pl&quot;&gt;in Polish&lt;/a&gt;&lt;/p&gt;</content>
+  </entry>
+  <entry>
+    <id>http://example.org/dated</id>
+    <link href='http://example.org/dated' rel='alternate' />
+    <title>a…</title>
+    <updated>2010-07-15T03:00:00+02:00</updated>
+    <content type='html'>&lt;p&gt;a dated beep.&lt;/p&gt;</content>
+  </entry>
+</feed>

data/spec/fixtures/index.pl.pl.xml

@@ -0,0 +1,50 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<feed xmlns='http://www.w3.org/2005/Atom'>
+  <author>
+    <name>Ary Tribut</name>
+  </author>
+  <generator uri='http://github.com/chastell/tributary'>tributary</generator>
+  <id>http://example.org/</id>
+  <link href='http://example.org/' rel='alternate' />
+  <link href='http://example.org/index.pl.pl.xml' rel='self' />
+  <title>a tributary site</title>
+  <updated>2010-07-23T02:00:00+02:00</updated>
+  <entry>
+    <id>http://example.org/polish</id>
+    <link href='http://example.org/polish' rel='alternate' />
+    <title>ten…</title>
+    <updated>2010-07-23T02:00:00+02:00</updated>
+    <content type='html'>&lt;p&gt;ten beep jest tylko po polsku.&lt;/p&gt;</content>
+  </entry>
+  <entry>
+    <id>http://example.org/600</id>
+    <link href='http://example.org/600' rel='alternate' />
+    <title>600th anniversary (intl.)</title>
+    <updated>2010-07-15T12:00:00+02:00</updated>
+    <content type='html'>
+      &lt;p&gt;600 years ago &lt;a href=&quot;http://en.wikipedia.org/wiki/Battle_of_Grunwald&quot;&gt;something supposedly important&lt;/a&gt;
+      happened around these parts of the world&lt;/p&gt;
+    </content>
+  </entry>
+  <entry>
+    <id>http://example.org/bilingual</id>
+    <link href='http://example.org/bilingual' rel='alternate' />
+    <title>dwujęzyczność</title>
+    <updated>2010-07-15T06:00:00+02:00</updated>
+    <content type='html'>&lt;p&gt;ten wpis jest także dostępny &lt;a href=&quot;bilingual.en&quot;&gt;po angielsku&lt;/a&gt;&lt;/p&gt;</content>
+  </entry>
+  <entry>
+    <id>http://example.org/dated</id>
+    <link href='http://example.org/dated' rel='alternate' />
+    <title>a…</title>
+    <updated>2010-07-15T03:00:00+02:00</updated>
+    <content type='html'>&lt;p&gt;a dated beep.&lt;/p&gt;</content>
+  </entry>
+  <entry>
+    <id>http://example.org/welcome</id>
+    <link href='http://example.org/welcome' rel='alternate' />
+    <title>welcome to tributary</title>
+    <updated>2010-07-15T00:00:00+02:00</updated>
+    <content type='html'>&lt;p&gt;tributary &lt;em&gt;welcome&lt;/em&gt; article&lt;/p&gt;</content>
+  </entry>
+</feed>

data/spec/fixtures/index.pl.xml

@@ -0,0 +1,50 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<feed xmlns='http://www.w3.org/2005/Atom'>
+  <author>
+    <name>Ary Tribut</name>
+  </author>
+  <generator uri='http://github.com/chastell/tributary'>tributary</generator>
+  <id>http://example.org/</id>
+  <link href='http://example.org/' rel='alternate' />
+  <link href='http://example.org/index.pl.xml' rel='self' />
+  <title>a tributary site</title>
+  <updated>2010-07-23T02:00:00+02:00</updated>
+  <entry>
+    <id>http://example.org/polish</id>
+    <link href='http://example.org/polish' rel='alternate' />
+    <title>ten…</title>
+    <updated>2010-07-23T02:00:00+02:00</updated>
+    <content type='html'>&lt;p&gt;ten beep jest tylko po polsku.&lt;/p&gt;</content>
+  </entry>
+  <entry>
+    <id>http://example.org/english</id>
+    <link href='http://example.org/english' rel='alternate' />
+    <title>this…</title>
+    <updated>2010-07-23T01:00:00+02:00</updated>
+    <content type='html'>&lt;p&gt;this beep is only in English.&lt;/p&gt;</content>
+  </entry>
+  <entry>
+    <id>http://example.org/600</id>
+    <link href='http://example.org/600' rel='alternate' />
+    <title>600th anniversary (intl.)</title>
+    <updated>2010-07-15T12:00:00+02:00</updated>
+    <content type='html'>
+      &lt;p&gt;600 years ago &lt;a href=&quot;http://en.wikipedia.org/wiki/Battle_of_Grunwald&quot;&gt;something supposedly important&lt;/a&gt;
+      happened around these parts of the world&lt;/p&gt;
+    </content>
+  </entry>
+  <entry>
+    <id>http://example.org/bilingual</id>
+    <link href='http://example.org/bilingual' rel='alternate' />
+    <title>dwujęzyczność</title>
+    <updated>2010-07-15T06:00:00+02:00</updated>
+    <content type='html'>&lt;p&gt;ten wpis jest także dostępny &lt;a href=&quot;bilingual.en&quot;&gt;po angielsku&lt;/a&gt;&lt;/p&gt;</content>
+  </entry>
+  <entry>
+    <id>http://example.org/dated</id>
+    <link href='http://example.org/dated' rel='alternate' />
+    <title>a…</title>
+    <updated>2010-07-15T03:00:00+02:00</updated>
+    <content type='html'>&lt;p&gt;a dated beep.&lt;/p&gt;</content>
+  </entry>
+</feed>

data/spec/fixtures/index.xml

@@ -0,0 +1,50 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<feed xmlns='http://www.w3.org/2005/Atom'>
+  <author>
+    <name>Ary Tribut</name>
+  </author>
+  <generator uri='http://github.com/chastell/tributary'>tributary</generator>
+  <id>http://example.org/</id>
+  <link href='http://example.org/' rel='alternate' />
+  <link href='http://example.org/index.xml' rel='self' />
+  <title>a tributary site</title>
+  <updated>2010-07-23T02:00:00+02:00</updated>
+  <entry>
+    <id>http://example.org/polish</id>
+    <link href='http://example.org/polish' rel='alternate' />
+    <title>ten…</title>
+    <updated>2010-07-23T02:00:00+02:00</updated>
+    <content type='html'>&lt;p&gt;ten beep jest tylko po polsku.&lt;/p&gt;</content>
+  </entry>
+  <entry>
+    <id>http://example.org/english</id>
+    <link href='http://example.org/english' rel='alternate' />
+    <title>this…</title>
+    <updated>2010-07-23T01:00:00+02:00</updated>
+    <content type='html'>&lt;p&gt;this beep is only in English.&lt;/p&gt;</content>
+  </entry>
+  <entry>
+    <id>http://example.org/600</id>
+    <link href='http://example.org/600' rel='alternate' />
+    <title>600th anniversary (intl.)</title>
+    <updated>2010-07-15T12:00:00+02:00</updated>
+    <content type='html'>
+      &lt;p&gt;600 years ago &lt;a href=&quot;http://en.wikipedia.org/wiki/Battle_of_Grunwald&quot;&gt;something supposedly important&lt;/a&gt;
+      happened around these parts of the world&lt;/p&gt;
+    </content>
+  </entry>
+  <entry>
+    <id>http://example.org/bilingual</id>
+    <link href='http://example.org/bilingual' rel='alternate' />
+    <title>bilinguality</title>
+    <updated>2010-07-15T06:00:00+02:00</updated>
+    <content type='html'>&lt;p&gt;this article is also available &lt;a href=&quot;bilingual.pl&quot;&gt;in Polish&lt;/a&gt;&lt;/p&gt;</content>
+  </entry>
+  <entry>
+    <id>http://example.org/dated</id>
+    <link href='http://example.org/dated' rel='alternate' />
+    <title>a…</title>
+    <updated>2010-07-15T03:00:00+02:00</updated>
+    <content type='html'>&lt;p&gt;a dated beep.&lt;/p&gt;</content>
+  </entry>
+</feed>