RubyGems - nanoc2 - Versions diffs - 2.2.3 - Mend

nanoc2 2.2.3

Files changed (100) hide show

data/ChangeLog +3 -0
data/LICENSE +19 -0
data/README +75 -0
data/Rakefile +76 -0
data/bin/nanoc2 +26 -0
data/lib/nanoc2.rb +73 -0
data/lib/nanoc2/base.rb +26 -0
data/lib/nanoc2/base/asset.rb +117 -0
data/lib/nanoc2/base/asset_defaults.rb +21 -0
data/lib/nanoc2/base/asset_rep.rb +282 -0
data/lib/nanoc2/base/binary_filter.rb +44 -0
data/lib/nanoc2/base/code.rb +41 -0
data/lib/nanoc2/base/compiler.rb +67 -0
data/lib/nanoc2/base/core_ext.rb +2 -0
data/lib/nanoc2/base/core_ext/hash.rb +78 -0
data/lib/nanoc2/base/core_ext/string.rb +8 -0
data/lib/nanoc2/base/data_source.rb +286 -0
data/lib/nanoc2/base/defaults.rb +30 -0
data/lib/nanoc2/base/filter.rb +93 -0
data/lib/nanoc2/base/layout.rb +91 -0
data/lib/nanoc2/base/notification_center.rb +66 -0
data/lib/nanoc2/base/page.rb +132 -0
data/lib/nanoc2/base/page_defaults.rb +20 -0
data/lib/nanoc2/base/page_rep.rb +324 -0
data/lib/nanoc2/base/plugin.rb +71 -0
data/lib/nanoc2/base/proxies.rb +5 -0
data/lib/nanoc2/base/proxies/asset_proxy.rb +29 -0
data/lib/nanoc2/base/proxies/asset_rep_proxy.rb +26 -0
data/lib/nanoc2/base/proxies/layout_proxy.rb +25 -0
data/lib/nanoc2/base/proxies/page_proxy.rb +35 -0
data/lib/nanoc2/base/proxies/page_rep_proxy.rb +28 -0
data/lib/nanoc2/base/proxy.rb +37 -0
data/lib/nanoc2/base/router.rb +72 -0
data/lib/nanoc2/base/site.rb +274 -0
data/lib/nanoc2/base/template.rb +64 -0
data/lib/nanoc2/binary_filters.rb +1 -0
data/lib/nanoc2/binary_filters/image_science_thumbnail.rb +28 -0
data/lib/nanoc2/cli.rb +9 -0
data/lib/nanoc2/cli/base.rb +132 -0
data/lib/nanoc2/cli/commands.rb +10 -0
data/lib/nanoc2/cli/commands/autocompile.rb +80 -0
data/lib/nanoc2/cli/commands/compile.rb +312 -0
data/lib/nanoc2/cli/commands/create_layout.rb +85 -0
data/lib/nanoc2/cli/commands/create_page.rb +85 -0
data/lib/nanoc2/cli/commands/create_site.rb +323 -0
data/lib/nanoc2/cli/commands/create_template.rb +76 -0
data/lib/nanoc2/cli/commands/help.rb +69 -0
data/lib/nanoc2/cli/commands/info.rb +125 -0
data/lib/nanoc2/cli/commands/switch.rb +141 -0
data/lib/nanoc2/cli/commands/update.rb +91 -0
data/lib/nanoc2/cli/logger.rb +72 -0
data/lib/nanoc2/data_sources.rb +2 -0
data/lib/nanoc2/data_sources/filesystem.rb +707 -0
data/lib/nanoc2/data_sources/filesystem_combined.rb +495 -0
data/lib/nanoc2/extra.rb +6 -0
data/lib/nanoc2/extra/auto_compiler.rb +285 -0
data/lib/nanoc2/extra/context.rb +22 -0
data/lib/nanoc2/extra/core_ext.rb +2 -0
data/lib/nanoc2/extra/core_ext/hash.rb +54 -0
data/lib/nanoc2/extra/core_ext/time.rb +13 -0
data/lib/nanoc2/extra/file_proxy.rb +29 -0
data/lib/nanoc2/extra/vcs.rb +48 -0
data/lib/nanoc2/extra/vcses.rb +5 -0
data/lib/nanoc2/extra/vcses/bazaar.rb +21 -0
data/lib/nanoc2/extra/vcses/dummy.rb +20 -0
data/lib/nanoc2/extra/vcses/git.rb +21 -0
data/lib/nanoc2/extra/vcses/mercurial.rb +21 -0
data/lib/nanoc2/extra/vcses/subversion.rb +21 -0
data/lib/nanoc2/filters.rb +16 -0
data/lib/nanoc2/filters/bluecloth.rb +13 -0
data/lib/nanoc2/filters/erb.rb +19 -0
data/lib/nanoc2/filters/erubis.rb +14 -0
data/lib/nanoc2/filters/haml.rb +21 -0
data/lib/nanoc2/filters/markaby.rb +14 -0
data/lib/nanoc2/filters/maruku.rb +14 -0
data/lib/nanoc2/filters/old.rb +19 -0
data/lib/nanoc2/filters/rainpress.rb +13 -0
data/lib/nanoc2/filters/rdiscount.rb +13 -0
data/lib/nanoc2/filters/rdoc.rb +23 -0
data/lib/nanoc2/filters/redcloth.rb +14 -0
data/lib/nanoc2/filters/relativize_paths.rb +16 -0
data/lib/nanoc2/filters/relativize_paths_in_css.rb +16 -0
data/lib/nanoc2/filters/relativize_paths_in_html.rb +16 -0
data/lib/nanoc2/filters/rubypants.rb +14 -0
data/lib/nanoc2/filters/sass.rb +18 -0
data/lib/nanoc2/helpers.rb +9 -0
data/lib/nanoc2/helpers/blogging.rb +217 -0
data/lib/nanoc2/helpers/capturing.rb +63 -0
data/lib/nanoc2/helpers/filtering.rb +54 -0
data/lib/nanoc2/helpers/html_escape.rb +25 -0
data/lib/nanoc2/helpers/link_to.rb +113 -0
data/lib/nanoc2/helpers/render.rb +49 -0
data/lib/nanoc2/helpers/tagging.rb +56 -0
data/lib/nanoc2/helpers/text.rb +38 -0
data/lib/nanoc2/helpers/xml_sitemap.rb +63 -0
data/lib/nanoc2/routers.rb +3 -0
data/lib/nanoc2/routers/default.rb +54 -0
data/lib/nanoc2/routers/no_dirs.rb +66 -0
data/lib/nanoc2/routers/versioned.rb +79 -0
metadata +185 -0

data/lib/nanoc2/cli/commands/create_layout.rb ADDED

@@ -0,0 +1,85 @@
+module Nanoc2::CLI
+  class CreateLayoutCommand < Cri::Command # :nodoc:
+    def name
+      'create_layout'
+    end
+    def aliases
+      [ 'cl' ]
+    end
+    def short_desc
+      'create a layout'
+    end
+    def long_desc
+      'Create a new layout in the current site.'
+    end
+    def usage
+      "nanoc2 create_layout [path]"
+    end
+    def option_definitions
+      [
+        # --vcs
+        {
+          :long => 'vcs', :short => 'c', :argument => :required,
+          :desc => 'select the VCS to use'
+        }
+      ]
+    end
+    def run(options, arguments)
+      # Check arguments
+      if arguments.length != 1
+        $stderr.puts "usage: #{usage}"
+        exit 1
+      end
+      # Extract arguments
+      path = arguments[0].cleaned_path
+      # Make sure we are in a nanoc site directory
+      @base.require_site
+      # Set VCS if possible
+      @base.set_vcs(options[:vcs])
+      # Check whether layout is unique
+      if !@base.site.layouts.find { |l| l.path == path }.nil?
+        $stderr.puts "A layout already exists at #{path}. Please pick a unique name " +
+                     "for the layout you are creating."
+        exit 1
+      end
+      # Setup notifications
+      Nanoc2::NotificationCenter.on(:file_created) do |file_path|
+        Nanoc2::CLI::Logger.instance.file(:high, :create, file_path)
+      end
+      # Create layout
+      layout = Nanoc2::Layout.new(
+        "<html>\n" +
+        "  <head>\n" +
+        "    <title><%= @page.title %></title>\n" +
+        "  </head>\n" +
+        "  <body>\n" +
+        "    <p>Hi, I'm a new layout. Please customize me!</p>\n" +
+        "<%= @page.content %>\n" +
+        "  </body>\n" +
+        "</html>\n",
+        { :filter => 'erb' },
+        path
+      )
+      layout.site = @base.site
+      layout.save
+      puts "A layout has been created at #{path}."
+    end
+  end
+end

data/lib/nanoc2/cli/commands/create_page.rb ADDED

@@ -0,0 +1,85 @@
+module Nanoc2::CLI
+  class CreatePageCommand < Cri::Command # :nodoc:
+    def name
+      'create_page'
+    end
+    def aliases
+      [ 'cp' ]
+    end
+    def short_desc
+      'create a page'
+    end
+    def long_desc
+      'Create a new page in the current site. The template that will be ' +
+      'used for generating the page will be \'default\', unless otherwise ' +
+      'specified.'
+    end
+    def usage
+      "nanoc2 create_page [options] [path]"
+    end
+    def option_definitions
+      [
+        # --vcs
+        {
+          :long => 'vcs', :short => 'c', :argument => :required,
+          :desc => 'select the VCS to use'
+        },
+        # --template
+        {
+          :long => 'template', :short => 't', :argument => :required,
+          :desc => 'specify the template for the new page'
+        }
+      ]
+    end
+    def run(options, arguments)
+      # Check arguments
+      if arguments.length != 1
+        $stderr.puts "usage: #{usage}"
+        exit 1
+      end
+      # Extract arguments and options
+      path          = arguments[0].cleaned_path
+      template_name = options[:template] || 'default'
+      # Make sure we are in a nanoc site directory
+      @base.require_site
+      # Set VCS if possible
+      @base.set_vcs(options[:vcs])
+      # Find template
+      template = @base.site.templates.find { |t| t.name == template_name }
+      if template.nil?
+        $stderr.puts "A template named '#{template_name}' was not found; aborting."
+        exit 1
+      end
+      # Setup notifications
+      Nanoc2::NotificationCenter.on(:file_created) do |file_path|
+        Nanoc2::CLI::Logger.instance.file(:high, :create, file_path)
+      end
+      # Create page
+      page = Nanoc2::Page.new(
+        template.page_content,
+        template.page_attributes,
+        path
+      )
+      page.site = @base.site
+      page.save
+      puts "A page has been created at #{path}."
+    end
+  end
+end

data/lib/nanoc2/cli/commands/create_site.rb ADDED

@@ -0,0 +1,323 @@
+module Nanoc2::CLI
+  class CreateSiteCommand < Cri::Command # :nodoc:
+    DEFAULT_PAGE = <<EOS
+<h1>A Brand New nanoc Site</h1>
+<p>You&#8217;ve just created a new nanoc site. The page you are looking at right now is the home page for your site (and it&#8217;s probably the only page).</p>
+<p>To get started, consider replacing this default homepage with your own customized homepage. Some pointers on how to do so:</p>
+<ul>
+  <li><strong>Change this page&#8217;s content</strong> by editing &#8220;content.txt&#8221; file in the &#8220;content&#8221; directory. This is the actual page content, and therefore doesn&#8217;t include the header, sidebar or style information (those are part of the layout).</li>
+  <li><strong>Change the layout</strong>, which is the &#8220;default.txt&#8221; file in the &#8220;layouts/default&#8221; directory, and create something unique (and hopefully less bland).</li>
+</ul>
+<p>If you need any help with customizing your nanoc web site, be sure to check out the documentation (see sidebar), and be sure to subscribe to the discussion group (also see sidebar). Enjoy!</p>
+EOS
+    DEFAULT_LAYOUT = <<EOS
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html>
+  <head>
+    <title>A Brand New nanoc Site - <%= @page.title %></title>
+    <style type="text/css" media="screen">
+      * {
+        margin: 0;
+        padding: 0;
+        font-family: Georgia, Palatino, Times, 'Times New Roman', sans-serif;
+      }
+      body {
+        background: #fff;
+      }
+      a {
+        text-decoration: none;
+      }
+      a:link,
+      a:visited {
+        color: #f30;
+      }
+      a:hover {
+        color: #f90;
+      }
+      #main {
+        position: absolute;
+        top: 20px;
+        left: 280px;
+        width: 500px;
+      }
+      #main h1 {
+        font-size: 40px;
+        font-weight: normal;
+        line-height: 40px;
+        padding: 20px 0 20px 0;
+        letter-spacing: -1px;
+      }
+      #main p {
+        margin: 0 0 20px 0;
+        font-size: 15px;
+        line-height: 20px;
+      }
+      #main ul {
+        padding: 0 0 0 20px;
+      }
+      #main li {
+        margin: 0 0 20px 0;
+        list-style-type: square;
+        font-size: 15px;
+        line-height: 20px;
+      }
+      #sidebar {
+        position: absolute;
+        top: 40px;
+        left: 20px;
+        width: 200px;
+        padding: 20px 20px 0 0;
+        border-right: 1px solid #ccc;
+        text-align: right;
+      }
+      #sidebar h2 {
+        text-transform: uppercase;
+        font-size: 13px;
+        color: #333;
+        letter-spacing: 1px;
+        line-height: 20px;
+      }
+      #sidebar ul {
+        list-style-type: none;
+        margin: 20px 0;
+      }
+      #sidebar li {
+        font-size: 14px;
+        line-height: 20px;
+      }
+    </style>
+  </head>
+  <body>
+    <div id="main">
+<%= @page_rep.content %>
+    </div>
+    <div id="sidebar">
+      <h2>Documentation</h2>
+      <ul>
+        <li><a href="http://nanoc.stoneship.org/help/tutorial/">Tutorial</a></li>
+        <li><a href="http://nanoc.stoneship.org/help/manual/">Manual</a></li>
+      </ul>
+      <h2>Community</h2>
+      <ul>
+        <li><a href="http://groups.google.com/group/nanoc/">Discussion Group</a></li>
+        <li><a href="http://groups.google.com/group/nanoc-es/">Spanish Discussion Group</a></li>
+        <li><a href="http://nanoc.stoneship.org/trac/">Wiki</a></li>
+      </ul>
+    </div>
+  </body>
+</html>
+EOS
+    def name
+      'create_site'
+    end
+    def aliases
+      [ 'cs' ]
+    end
+    def short_desc
+      'create a site'
+    end
+    def long_desc
+      'Create a new site at the given path. The site will use the ' +
+      'filesystem data source (but this can be changed later on). It will ' +
+      'also include a few stub rakefiles to make adding new tasks easier.'
+    end
+    def usage
+      "nanoc2 create_site [path]"
+    end
+    def option_definitions
+      [
+        # --datasource
+        {
+          :long => 'datasource', :short => 'd', :argument => :required,
+          :desc => 'specify the data source for the new site'
+        }
+      ]
+    end
+    def run(options, arguments)
+      # Check arguments
+      if arguments.length != 1
+        $stderr.puts "usage: #{usage}"
+        exit 1
+      end
+      # Extract arguments and options
+      path        = arguments[0]
+      data_source = options[:datasource] || 'filesystem'
+      # Check whether site exists
+      if File.exist?(path)
+        $stderr.puts "A site at '#{path}' already exists."
+        exit 1
+      end
+      # Check whether data source exists
+      if Nanoc2::DataSource.named(data_source).nil?
+        $stderr.puts "Unrecognised data source: #{data_source}"
+        exit 1
+      end
+      # Setup notifications
+      Nanoc2::NotificationCenter.on(:file_created) do |file_path|
+        Nanoc2::CLI::Logger.instance.file(:high, :create, file_path)
+      end
+      # Build entire site
+      FileUtils.mkdir_p(path)
+      FileUtils.cd(File.join(path)) do
+        site_create_minimal(data_source)
+        site_setup
+        site_populate
+      end
+      puts "Created a blank nanoc site at '#{path}'. Enjoy!"
+    end
+  protected
+    # Creates a configuration file and a output directory for this site, as
+    # well as a rakefile and a 'tasks' directory because raking is fun.
+    def site_create_minimal(data_source)
+      # Create output
+      FileUtils.mkdir_p('output')
+      # Create config
+      File.open('config.yaml', 'w') do |io|
+        io.write "output_dir:  \"output\"\n"
+        io.write "data_source: \"#{data_source}\"\n"
+        io.write "router:      \"default\"\n"
+      end
+      Nanoc2::NotificationCenter.post(:file_created, 'config.yaml')
+      # Create rakefile
+      File.open('Rakefile', 'w') do |io|
+        io.write "Dir['tasks/**/*.rake'].sort.each { |rakefile| load rakefile }\n"
+        io.write "\n"
+        io.write "task :default do\n"
+        io.write "  puts 'This is an example rake task.'\n"
+        io.write "end\n"
+      end
+      Nanoc2::NotificationCenter.post(:file_created, 'Rakefile')
+      # Create tasks
+      FileUtils.mkdir_p('tasks')
+      File.open('tasks/default.rake', 'w') do |io|
+        io.write "task :example do\n"
+        io.write "  puts 'This is an example rake task in tasks/default.rake.'\n"
+        io.write "end\n"
+      end
+      Nanoc2::NotificationCenter.post(:file_created, 'tasks/default.rake')
+    end
+    # Sets up the site's data source, i.e. creates the bare essentials for
+    # this data source to work.
+    def site_setup
+      # Get site
+      site = Nanoc2::Site.new(YAML.load_file('config.yaml'))
+      # Set up data source
+      site.data_source.loading do
+        site.data_source.setup
+      end
+    end
+    # Populates the site with some initial data, such as a root page, a
+    # default layout, a default template, and so on.
+    def site_populate
+      # Get site
+      site = Nanoc2::Site.new(YAML.load_file('config.yaml'))
+      # Create page
+      page = Nanoc2::Page.new(
+        DEFAULT_PAGE,
+        { :title => 'Home' },
+        '/'
+      )
+      page.site = site
+      page.save
+      # Fill asset defaults
+      Nanoc2::Asset::DEFAULTS.each_pair do |key, value|
+        site.asset_defaults.attributes[key] = value
+      end
+      site.asset_defaults.save
+      # Fill page defaults
+      Nanoc2::Page::DEFAULTS.each_pair do |key, value|
+        site.page_defaults.attributes[key] = value
+      end
+      site.page_defaults.save
+      # Create layout
+      layout = Nanoc2::Layout.new(
+        DEFAULT_LAYOUT,
+        { :filter => 'erb' },
+        '/default/'
+      )
+      layout.site = site
+      layout.save
+      # Create template
+      template = Nanoc2::Template.new(
+        "Hi, I'm a new page!\n",
+        { :title => "A New Page" },
+        'default'
+      )
+      template.site = site
+      template.save
+      # Fill code
+      code = Nanoc2::Code.new(
+        "\# All files in the 'lib' directory will be loaded\n" +
+        "\# before nanoc starts compiling.\n"
+      )
+      code.site = site
+      code.save
+    end
+  end
+end