nanoc 2.0.4 → 2.1

data/lib/nanoc/extra/vcses/dummy.rb

@@ -0,0 +1,20 @@
+module Nanoc::Extra::VCSes
+
+  class Dummy < Nanoc::Extra::VCS
+
+    identifiers :dummy
+
+    def add(filename)
+    end
+
+    def remove(filename)
+      FileUtils.rm_rf(filename)
+    end
+
+    def move(src, dst)
+      FileUtils.move(src, dst)
+    end
+
+  end
+
+end

data/lib/nanoc/extra/vcses/git.rb

@@ -0,0 +1,21 @@
+module Nanoc::Extra::VCSes
+
+  class Git < Nanoc::Extra::VCS
+
+    identifiers :git
+
+    def add(filename)
+      system('git', 'add', filename)
+    end
+
+    def remove(filename)
+      system('git', 'rm', filename)
+    end
+
+    def move(src, dst)
+      system('git', 'mv', src, dst)
+    end
+
+  end
+
+end

data/lib/nanoc/extra/vcses/mercurial.rb

@@ -0,0 +1,21 @@
+module Nanoc::Extra::VCSes
+
+  class Mercurial < Nanoc::Extra::VCS
+
+    identifiers :mercurial, :hg
+
+    def add(filename)
+      system('hg', 'add', filename)
+    end
+
+    def remove(filename)
+      system('hg', 'rm', filename)
+    end
+
+    def move(src, dst)
+      system('hg', 'mv', src, dst)
+    end
+
+  end
+
+end

data/lib/nanoc/extra/vcses/subversion.rb

@@ -0,0 +1,21 @@
+module Nanoc::Extra::VCSes
+
+  class Subversion < Nanoc::Extra::VCS
+
+    identifiers :subversion, :svn
+
+    def add(filename)
+      system('svn', 'add', filename)
+    end
+
+    def remove(filename)
+      system('svn', 'rm', filename)
+    end
+
+    def move(src, dst)
+      system('svn', 'mv', src, dst)
+    end
+
+  end
+
+end

data/lib/nanoc/filters/bluecloth.rb

@@ -0,0 +1,13 @@
+module Nanoc::Filters
+  class BlueCloth < Nanoc::Filter
+
+    identifiers :bluecloth
+
+    def run(content)
+      require 'bluecloth'
+
+      ::BlueCloth.new(content).to_html
+    end
+
+  end
+end

data/lib/nanoc/filters/erb.rb

@@ -1,34 +1,18 @@
-module Nanoc::Filter::ERB
+module Nanoc::Filters
+  class ERB < Nanoc::Filter
 
-  class Context
-
-    def initialize(hash)
-      hash.each_pair do |key, value|
-        instance_variable_set('@' + key.to_s, value)
-      end
-    end
-
-    def get_binding
-      binding
-    end
-
-  end
-
-  class ERBFilter < Nanoc::Filter
-
-    identifiers :erb, :eruby
+    identifiers :erb
+    extensions  '.erb', '.rhtml'
 
     def run(content)
-      nanoc_require 'erb'
+      require 'erb'
 
       # Create context
-      assigns = { :page => @page, :pages => @pages, :config => @config, :site => @site }
-      context = Context.new(assigns)
+      context = ::Nanoc::Extra::Context.new(assigns)
 
       # Get result
       ::ERB.new(content).result(context.get_binding)
     end
 
   end
-
 end

data/lib/nanoc/filters/erubis.rb

@@ -0,0 +1,14 @@
+module Nanoc::Filters
+  class Erubis < Nanoc::Filter
+
+    identifiers :erubis
+
+    def run(content)
+      require 'erubis'
+
+      # Get result
+      ::Erubis::Eruby.new(content).evaluate(assigns)
+    end
+
+  end
+end

data/lib/nanoc/filters/haml.rb

@@ -1,37 +1,21 @@
-module Nanoc::Filter::Haml
-
-  class Context
-
-    def initialize(hash)
-      hash.each_pair do |key, value|
-        instance_variable_set('@' + key.to_s, value)
-      end
-    end
-
-    def get_binding
-      binding
-    end
-
-  end
-
-  class HamlFilter < Nanoc::Filter
+module Nanoc::Filters
+  class Haml < Nanoc::Filter
 
     identifiers :haml
+    extensions  '.haml'
 
     def run(content)
-      nanoc_require 'haml'
+      require 'haml'
 
       # Get options
-      options = @page.haml_options || {}
+      options = @page.attribute_named(:haml_options) || {}
 
-      # Get assigns/locals
-      assigns = { :page => @page, :pages => @pages, :config => @config, :site => @site }
-      context = Context.new(assigns)
+      # Create context
+      context = ::Nanoc::Extra::Context.new(assigns)
 
       # Get result
       ::Haml::Engine.new(content, options).render(context, assigns)
     end
 
   end
-
 end

data/lib/nanoc/filters/markaby.rb

@@ -1,13 +1,13 @@
-module Nanoc::Filter::Markaby
-  class MarkabyFilter < Nanoc::Filter
+module Nanoc::Filters
+  class Markaby < Nanoc::Filter
 
     identifiers :markaby
+    extensions  '.mab'
 
     def run(content)
-      nanoc_require 'markaby'
-
-      assigns = { :page => @page, :pages => @pages, :config => @config, :site => @site }
+      require 'markaby'
 
+      # Get result
       ::Markaby::Builder.new(assigns).instance_eval(content).to_s
     end
 

data/lib/nanoc/filters/maruku.rb

@@ -0,0 +1,14 @@
+module Nanoc::Filters
+  class Maruku < Nanoc::Filter
+
+    identifiers :maruku
+
+    def run(content)
+      require 'maruku'
+
+      # Get result
+      ::Maruku.new(content).to_html
+    end
+
+  end
+end

data/lib/nanoc/filters/old.rb

@@ -0,0 +1,19 @@
+module Nanoc::Filters
+  class Old < Nanoc::Filter
+
+    identifiers :eruby, :markdown, :smartypants, :textile
+
+    def run(content)
+      raise Nanoc::Error.new(
+        "The 'eruby', markdown', 'smartypants' and 'textile' filters no " +
+        "longer exist. Instead, use the following filters:\n" +
+        "\n" +
+        "* for Markdown:      bluecloth, rdiscount, redcloth\n" +
+        "* for Textile:       redcloth\n" +
+        "* for embedded Ruby: erb, erubis\n" +
+        "* for Smartypants:   rubypants"
+      )
+    end
+
+  end
+end

data/lib/nanoc/filters/rdiscount.rb

@@ -0,0 +1,13 @@
+module Nanoc::Filters
+  class RDiscount < Nanoc::Filter
+
+    identifiers :rdiscount
+
+    def run(content)
+      require 'rdiscount'
+
+      ::RDiscount.new(content).to_html
+    end
+
+  end
+end

data/lib/nanoc/filters/rdoc.rb

@@ -1,12 +1,13 @@
-module Nanoc::Filter::RDoc
-  class RDocFilter < Nanoc::Filter
+module Nanoc::Filters
+  class RDoc < Nanoc::Filter
 
     identifiers :rdoc
 
     def run(content)
-      nanoc_require 'rdoc/markup/simple_markup'
-      nanoc_require 'rdoc/markup/simple_markup/to_html'
+      require 'rdoc/markup/simple_markup'
+      require 'rdoc/markup/simple_markup/to_html'
 
+      # Get result
       ::SM::SimpleMarkup.new.convert(content, SM::ToHtml.new)
     end
 

data/lib/nanoc/filters/redcloth.rb

@@ -0,0 +1,14 @@
+module Nanoc::Filters
+  class RedCloth < Nanoc::Filter
+
+    identifiers :redcloth
+
+    def run(content)
+      require 'redcloth'
+
+      # Get result
+      ::RedCloth.new(content).to_html
+    end
+
+  end
+end

data/lib/nanoc/filters/rubypants.rb

@@ -0,0 +1,14 @@
+module Nanoc::Filters
+  class SmartyPants < Nanoc::Filter
+
+    identifiers :rubypants
+
+    def run(content)
+      require 'rubypants'
+
+      # Get result
+      ::RubyPants.new(content).to_html
+    end
+
+  end
+end

data/lib/nanoc/filters/sass.rb

@@ -0,0 +1,13 @@
+module Nanoc::Filters
+  class Sass < Nanoc::Filter
+
+    identifiers :sass
+
+    def run(content)
+      require 'sass'
+
+      ::Sass::Engine.new(content).render
+    end
+
+  end
+end

data/lib/nanoc/helpers/blogging.rb

@@ -0,0 +1,170 @@
+module Nanoc::Helpers
+
+  # Nanoc::Helpers::Blogging provides some functionality for building blogs,
+  # such as finding articles and constructing feeds.
+  #
+  # This helper has a few requirements. First, all blog articles should have
+  # the following attributes:
+  #
+  # * 'kind', set to 'article'.
+  #
+  # * 'created_at', set to the creation timestamp.
+  #
+  # Some functions in this blogging helper, such as the +atom_feed+ function,
+  # require additional attributes to be set; these attributes are described in
+  # the documentation for these functions.
+  #
+  # The two main functions are sorted_articles and atom_feed.
+  module Blogging
+
+    # Returns the list of articles, sorted by descending creation date (so
+    # newer articles appear first).
+    def sorted_articles
+      @pages.select do |page|
+        page.kind == 'article'
+      end.sort do |x,y|
+        y.created_at <=> x.created_at
+      end
+    end
+
+    # Returns a string representing the atom feed containing recent articles,
+    # sorted by descending creation date. +params+ is a hash where the
+    # following keys can be set:
+    #
+    # +limit+:: The maximum number of articles to show. Defaults to 5.
+    #
+    # The following attributes must be set on blog articles:
+    #
+    # * 'title', containing the title of the blog post.
+    #
+    # * all other attributes mentioned above.
+    #
+    # The following attributes can optionally be set on blog articles to
+    # change the behaviour of the Atom feed:
+    #
+    # * 'excerpt', containing an excerpt of the article, usually only a few
+    #   lines long.
+    #
+    # * 'custom_path_in_feed', containing the path that will be used instead
+    #   of the normal path in the feed. This can be useful when including
+    #   non-outputted pages in a feed; such pages could have their custom feed
+    #   path set to the blog path instead, for example.
+    #
+    # The feed will also include dates on which the articles were updated.
+    # These are generated automatically; the way this happens depends on the
+    # used data source (the filesystem data source checks the file mtimes, for
+    # instance).
+    #
+    # The feed page will need to have the following attributes:
+    #
+    # * 'base_url', containing the URL to the site, without trailing slash.
+    #   For example, if the site is at "http://example.com/", the base_url
+    #   would be "http://example.com". It is probably a good idea to define
+    #   this in the page defaults, i.e. the 'meta.yaml' file (at least if the
+    #   filesystem data source is being used, which is probably the case).
+    #
+    # * 'title', containing the title of the feed, which is usually also the
+    #   title of the blog.
+    #
+    # * 'author_name', containing the name of the page's author. This will
+    #   likely be a global attribute, unless the site is managed by several
+    #   people/
+    #
+    # * 'author_uri', containing the URI for the page's author, such as the
+    #   author's web site URL. This will also likely be a global attribute.
+    #
+    # The feed page can have the following optional attributes:
+    #
+    # * 'feed_url', containing the custom URL of the feed. This can be useful
+    #   when the private feed URL shouldn't be exposed; for example, when
+    #   using FeedBurner this would be set to the public FeedBurner URL.
+    #
+    # To construct a feed, create a blank page with no layout, only the 'erb'
+    # (or 'erubis') filter, and an 'xml' extension. It may also be useful to
+    # set 'is_hidden' to true, so that helpers such as the sitemap helper will
+    # ignore the page. The content of the feed page should be:
+    #
+    #   <%= atom_feed %>
+    def atom_feed(params={})
+      require 'builder'
+
+      # Extract parameters
+      limit = params[:limit] || 5
+
+      # Get most recent article
+      last_article = sorted_articles.first
+
+      # Create builder
+      buffer = ''
+      xml = Builder::XmlMarkup.new(:target => buffer, :indent => 2)
+
+      # Build feed
+      xml.instruct!
+      xml.feed(:xmlns => 'http://www.w3.org/2005/Atom') do
+        # Add primary attributes
+        xml.id      @page.base_url + '/'
+        xml.title   @page.title
+
+        # Add date
+        xml.updated last_article.created_at.to_iso8601_time
+
+        # Add links
+        xml.link(:rel => 'alternate', :href => @page.base_url)
+        xml.link(:rel => 'self',      :href => feed_url)
+
+        # Add author information
+        xml.author do
+          xml.name  @page.author_name
+          xml.uri   @page.author_uri
+        end
+
+        # Add articles
+        sorted_articles.first(limit).each do |a|
+          xml.entry do
+            # Add primary attributes
+            xml.id        atom_tag_for(a)
+            xml.title     a.title, :type => 'html'
+
+            # Add dates
+            xml.published a.created_at.to_iso8601_time
+            xml.updated   a.mtime.to_iso8601_time
+
+            # Add link
+            xml.link(:rel => 'alternate', :href => url_for(a))
+
+            # Add content
+            xml.content   a.content, :type => 'html'
+            xml.summary   a.excerpt, :type => 'html' unless a.excerpt.nil?
+          end
+        end
+      end
+
+      buffer
+    end
+
+    # Returns the URL for the given page. It will return the URL containing
+    # the custom path in the feed if possible, otherwise the normal path.
+    def url_for(page)
+      @page.base_url + (page.custom_path_in_feed || page.path)
+    end
+
+    # Returns the URL of the feed. It will return the custom feed URL if set,
+    # or otherwise the normal feed URL.
+    def feed_url
+      @page[:feed_url] || @page.base_url + @page.path
+    end
+
+    # Returns an URI containing an unique ID for the given page. This will be
+    # used in the Atom feed to uniquely identify articles. These IDs are
+    # created using a procedure suggested by Mark Pilgrim in this blog post:
+    # http://diveintomark.org/archives/2004/05/28/howto-atom-id.
+    def atom_tag_for(page)
+      hostname        = @page.base_url.sub(/.*:\/\/(.+?)\/?$/, '\1')
+      formatted_date  = page.created_at.to_iso8601_date
+
+      'tag:' + hostname + ',' + formatted_date + ':' + page.path
+    end
+
+  end
+
+end