RubyGems - nanoc - Versions diffs - 2.0.4 → 2.1 - Mend

nanoc 2.0.4 → 2.1

Files changed (99) hide show

data/ChangeLog +31 -1
data/LICENSE +1 -1
data/README +63 -3
data/Rakefile +59 -12
data/bin/nanoc +7 -199
data/lib/nanoc.rb +83 -12
data/lib/nanoc/base/asset.rb +113 -0
data/lib/nanoc/base/asset_defaults.rb +21 -0
data/lib/nanoc/base/asset_rep.rb +277 -0
data/lib/nanoc/base/binary_filter.rb +44 -0
data/lib/nanoc/base/code.rb +41 -0
data/lib/nanoc/base/compiler.rb +46 -34
data/lib/nanoc/base/core_ext/hash.rb +51 -7
data/lib/nanoc/base/core_ext/string.rb +8 -0
data/lib/nanoc/base/data_source.rb +253 -20
data/lib/nanoc/base/defaults.rb +30 -0
data/lib/nanoc/base/enhancements.rb +9 -84
data/lib/nanoc/base/filter.rb +109 -6
data/lib/nanoc/base/layout.rb +91 -0
data/lib/nanoc/base/notification_center.rb +66 -0
data/lib/nanoc/base/page.rb +94 -126
data/lib/nanoc/base/page_defaults.rb +20 -0
data/lib/nanoc/base/page_rep.rb +318 -0
data/lib/nanoc/base/plugin.rb +57 -9
data/lib/nanoc/base/proxies/asset_proxy.rb +29 -0
data/lib/nanoc/base/proxies/asset_rep_proxy.rb +26 -0
data/lib/nanoc/base/proxies/layout_proxy.rb +25 -0
data/lib/nanoc/base/proxies/page_proxy.rb +35 -0
data/lib/nanoc/base/proxies/page_rep_proxy.rb +28 -0
data/lib/nanoc/base/proxy.rb +37 -0
data/lib/nanoc/base/router.rb +72 -0
data/lib/nanoc/base/site.rb +219 -88
data/lib/nanoc/base/template.rb +64 -0
data/lib/nanoc/binary_filters/image_science_thumbnail.rb +28 -0
data/lib/nanoc/cli.rb +1 -0
data/lib/nanoc/cli/base.rb +219 -0
data/lib/nanoc/cli/cli.rb +16 -0
data/lib/nanoc/cli/command.rb +105 -0
data/lib/nanoc/cli/commands/autocompile.rb +80 -0
data/lib/nanoc/cli/commands/compile.rb +273 -0
data/lib/nanoc/cli/commands/create_layout.rb +85 -0
data/lib/nanoc/cli/commands/create_page.rb +85 -0
data/lib/nanoc/cli/commands/create_site.rb +327 -0
data/lib/nanoc/cli/commands/create_template.rb +76 -0
data/lib/nanoc/cli/commands/help.rb +69 -0
data/lib/nanoc/cli/commands/info.rb +114 -0
data/lib/nanoc/cli/commands/switch.rb +141 -0
data/lib/nanoc/cli/commands/update.rb +91 -0
data/lib/nanoc/cli/ext.rb +37 -0
data/lib/nanoc/cli/logger.rb +66 -0
data/lib/nanoc/cli/option_parser.rb +168 -0
data/lib/nanoc/data_sources/filesystem.rb +645 -224
data/lib/nanoc/data_sources/filesystem_combined.rb +495 -0
data/lib/nanoc/extra/auto_compiler.rb +265 -0
data/lib/nanoc/extra/context.rb +22 -0
data/lib/nanoc/extra/core_ext/hash.rb +54 -0
data/lib/nanoc/extra/core_ext/time.rb +13 -0
data/lib/nanoc/extra/file_proxy.rb +29 -0
data/lib/nanoc/extra/vcs.rb +48 -0
data/lib/nanoc/extra/vcses/bazaar.rb +21 -0
data/lib/nanoc/extra/vcses/dummy.rb +20 -0
data/lib/nanoc/extra/vcses/git.rb +21 -0
data/lib/nanoc/extra/vcses/mercurial.rb +21 -0
data/lib/nanoc/extra/vcses/subversion.rb +21 -0
data/lib/nanoc/filters/bluecloth.rb +13 -0
data/lib/nanoc/filters/erb.rb +6 -22
data/lib/nanoc/filters/erubis.rb +14 -0
data/lib/nanoc/filters/haml.rb +7 -23
data/lib/nanoc/filters/markaby.rb +5 -5
data/lib/nanoc/filters/maruku.rb +14 -0
data/lib/nanoc/filters/old.rb +19 -0
data/lib/nanoc/filters/rdiscount.rb +13 -0
data/lib/nanoc/filters/rdoc.rb +5 -4
data/lib/nanoc/filters/redcloth.rb +14 -0
data/lib/nanoc/filters/rubypants.rb +14 -0
data/lib/nanoc/filters/sass.rb +13 -0
data/lib/nanoc/helpers/blogging.rb +170 -0
data/lib/nanoc/helpers/capturing.rb +59 -0
data/lib/nanoc/helpers/html_escape.rb +23 -0
data/lib/nanoc/helpers/link_to.rb +69 -0
data/lib/nanoc/helpers/render.rb +47 -0
data/lib/nanoc/helpers/tagging.rb +52 -0
data/lib/nanoc/helpers/xml_sitemap.rb +58 -0
data/lib/nanoc/routers/default.rb +54 -0
data/lib/nanoc/routers/no_dirs.rb +66 -0
data/lib/nanoc/routers/versioned.rb +79 -0
metadata +112 -22
data/lib/nanoc/base/auto_compiler.rb +0 -132
data/lib/nanoc/base/layout_processor.rb +0 -33
data/lib/nanoc/base/page_proxy.rb +0 -31
data/lib/nanoc/base/plugin_manager.rb +0 -33
data/lib/nanoc/data_sources/database.rb +0 -259
data/lib/nanoc/data_sources/trivial.rb +0 -145
data/lib/nanoc/filters/markdown.rb +0 -13
data/lib/nanoc/filters/smartypants.rb +0 -13
data/lib/nanoc/filters/textile.rb +0 -13
data/lib/nanoc/layout_processors/erb.rb +0 -35
data/lib/nanoc/layout_processors/haml.rb +0 -38
data/lib/nanoc/layout_processors/markaby.rb +0 -16

data/lib/nanoc/data_sources/trivial.rb DELETED Viewed

@@ -1,145 +0,0 @@
-# This is the module where the trivial data source will live in. It's not
-# really _necessary_ to create a separate module/namespace for each data
-# source, but it can be useful, especially when the data source needs extra
-# classes (for example, the database data source defines uses ActiveRecord, so
-# it needs classes for each table).
-module Nanoc::DataSource::Trivial
-  # This is the implementation of a trivial data source. It doesn't do much
-  # except return bogus data. It is meant to be a very simple example of a
-  # data source, and it should be quite useful for those who want to write
-  # their own data sources.
-  class TrivialDataSource < Nanoc::DataSource
-    ########## Attributes ##########
-    # DataSource.identifier defines the name for this data source. The first
-    # and only argument is the data source name as a symbol.
-    identifier :trivial
-    ########## Preparation ##########
-    # DataSource#up is run before compiling. This is the place where you
-    # should initialize the data source, if necessary. You don't need to
-    # implement it; you can leave it out if you don't need initialization.
-    # This is the ideal place to connect to the database, for example.
-    # If your data source requires any special libraries, require them here
-    # using 'nanoc_require'.
-    def up
-    end
-    # DataSource#down is run after compiling. This is where you should clean
-    # up any resources you used during the site compilation. You don't need to
-    # implement it; you can leave it out if there's nothing to clean up. For
-    # example, this is a good place to close the connection to the database,
-    # if you have one.
-    def down
-    end
-    # DataSource#setup is run when the site is created. This is the place
-    # where you should create the data source for the first time. You don't
-    # need to implement it; you can leave it out if there's nothing to set up.
-    # For example, if you're using a database, this is where you should create
-    # the necessary tables for the data source to function properly.
-    def setup
-      error "Sorry. The trivial data source isn't competent enough."
-    end
-    ########## Loading data ##########
-    # DataSource#pages returns an array of hashes that represent pages. Each
-    # hash must have at least the :uncompiled_content and :path keys. You can
-    # include other metadata in this hash, though.
-    def pages
-      [
-        { :uncompiled_content => 'Hi!',          :path => '/'       },
-        { :uncompiled_content => 'Hello there.', :path => '/about/' }
-      ]
-    end
-    # Datasource#page_defaults returns a hash with default values for page
-    # metadata. This hash can be anything, even an empty hash if you wish.
-    def page_defaults
-      { :layout => 'quux' }
-    end
-    # DataSource#layouts returns an array of hashes that represent layouts.
-    # Each hash must have the :name, :content and :extension keys. The
-    # :extension key determines the layout processor that will be used (they
-    # are defined in layout_processors/*.rb).
-    def layouts
-      [
-        {
-          :name       => 'quux',
-          :content    => "<html>\n" +
-                         "  <head>\n" +
-                         "    <title><%= @page.title %></title>\n" +
-                         "  </head>\n" +
-                         "  <body>\n" +
-                         "<%= @page.content %>\n" +
-                         "  </body>\n" +
-                         "</html>",
-          :extension  => '.erb'
-        }
-      ]
-    end
-    # DataSource#templates returns an array of hashes that represent page
-    # templates. These page templates are used used by DataSource#create_page
-    # to create pages using a template. Each hash must have the :name key for
-    # identifying the template. Apart from that, you can structure the hash
-    # like you desire. I recommend having :content (for the page content) and
-    # :meta (for the page metadata) keys. Note that in this example, the value
-    # corresponding to the :meta key is a hash, but it could just as well have
-    # been a YAML-formatted string. Just make sure that what
-    # DataSource#templates serves is what DataSource#create_page expects.
-    def templates
-      [
-        {
-          :name     => 'default',
-          :content  => 'Hi, I am a new page. Please edit me!',
-          :meta     => { :title => 'A New Page' }
-        }
-      ]
-    end
-    # DataSource#code returns a string containing custom code which will be
-    # loaded before the site is compiled. This can be code for custom filters
-    # and layout processors, but pretty much any code can be put in there
-    # (global helper functions are very useful). It is possible to override
-    # methods of built-in nanoc classes, but doing so will likely cause
-    # massive breakage, so doing so is not recommended.
-    def code
-      "def foo ; 'bar' ; end"
-    end
-    ########## Creating data ##########
-    # DataSource#create_page is run when a page is created. This function
-    # should create a new page with the given name and using the given
-    # template. The template is a hash taken the array of hashes returned by
-    # DataSource#templates, so make sure that what DataSource#templates
-    # returns is what DataSource#create_page expects. This trivial data source
-    # doesn't have a permanent storage, so it can't create any pages.
-    def create_page(path, template)
-      error "Sorry. The trivial data source isn't competent enough."
-    end
-    # DataSource#create_layout is run when a layout is created. This function
-    # should create a new layout with the given name. This trivial data source
-    # doesn't have a permanent storage, so it can't create any layouts.
-    def create_layout(name)
-      error "Sorry. The trivial data source isn't competent enough."
-    end
-    # DataSource#create_template is run when a template is created. This
-    # function should create a new template with the given name. This trivial
-    # data source doesn't have a permanent storage, so it can't create any
-    # templates.
-    def create_template(name)
-      error "Sorry. The trivial data source isn't competent enough."
-    end
-  end
-end

data/lib/nanoc/filters/markdown.rb DELETED Viewed

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

data/lib/nanoc/filters/smartypants.rb DELETED Viewed

@@ -1,13 +0,0 @@
-module Nanoc::Filter::SmartyPants
-  class SmartyPantsFilter < Nanoc::Filter
-    identifiers :smartypants, :rubypants
-    def run(content)
-      nanoc_require 'rubypants'
-      ::RubyPants.new(content).to_html
-    end
-  end
-end

data/lib/nanoc/filters/textile.rb DELETED Viewed

@@ -1,13 +0,0 @@
-module Nanoc::Filter::Textile
-  class TextileFilter < Nanoc::Filter
-    identifiers :textile, :redcloth
-    def run(content)
-      nanoc_require 'redcloth'
-      ::RedCloth.new(content).to_html
-    end
-  end
-end

data/lib/nanoc/layout_processors/erb.rb DELETED Viewed

@@ -1,35 +0,0 @@
-module Nanoc::LayoutProcessor::ERB
-  class ERBContext
-    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 ERBLayoutProcessor < Nanoc::LayoutProcessor
-    identifiers  :erb, :eruby
-    extensions   '.erb', '.rhtml'
-    def run(layout)
-      nanoc_require 'erb'
-      # Create context
-      assigns = @other_assigns.merge({ :page => @page, :pages => @pages, :config => @config, :site => @site })
-      context = ERBContext.new(assigns)
-      # Get result
-      ::ERB.new(layout).result(context.get_binding)
-    end
-  end
-end

data/lib/nanoc/layout_processors/haml.rb DELETED Viewed

@@ -1,38 +0,0 @@
-module Nanoc::LayoutProcessor::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 HamlLayoutProcessor < Nanoc::LayoutProcessor
-    identifiers :haml
-    extensions  '.haml'
-    def run(content)
-      nanoc_require 'haml'
-      # Get options
-      options = @page.haml_options || {}
-      # Get assigns/locals
-      assigns = { :page => @page, :pages => @pages, :config => @config, :site => @site }
-      context = Context.new(assigns)
-      # Get result
-      ::Haml::Engine.new(content, options).render(context, assigns)
-    end
-  end
-end

data/lib/nanoc/layout_processors/markaby.rb DELETED Viewed

@@ -1,16 +0,0 @@
-module Nanoc::LayoutProcessor::Markaby
-  class MarkabyLayoutProcessor < Nanoc::LayoutProcessor
-    identifiers :markaby
-    extensions  '.mab'
-    def run(layout)
-      nanoc_require 'markaby'
-      assigns = @other_assigns.merge({ :page => @page, :pages => @pages, :config => @config, :site => @site })
-      ::Markaby::Builder.new(assigns).instance_eval(layout).to_s
-    end
-  end
-end