RubyGems - nanoc - Versions diffs - 3.2.4 → 3.3.0 - Mend

nanoc 3.2.4 → 3.3.0

Files changed (230) hide show

data/.gemtest +0 -0
data/ChangeLog +3 -0
data/Gemfile +32 -0
data/LICENSE +19 -0
data/NEWS.md +470 -0
data/README.md +114 -0
data/Rakefile +14 -0
data/bin/nanoc +7 -27
data/bin/nanoc3 +3 -0
data/doc/yardoc_templates/default/layout/html/footer.erb +10 -0
data/lib/nanoc.rb +41 -0
data/lib/nanoc/base.rb +49 -0
data/lib/nanoc/base/compilation/checksum_store.rb +57 -0
data/lib/nanoc/base/compilation/compiled_content_cache.rb +62 -0
data/lib/nanoc/base/compilation/compiler.rb +458 -0
data/lib/nanoc/base/compilation/compiler_dsl.rb +214 -0
data/lib/nanoc/base/compilation/dependency_tracker.rb +200 -0
data/lib/nanoc/base/compilation/filter.rb +165 -0
data/lib/nanoc/base/compilation/item_rep_proxy.rb +103 -0
data/lib/nanoc/base/compilation/item_rep_recorder_proxy.rb +102 -0
data/lib/nanoc/base/compilation/outdatedness_checker.rb +223 -0
data/lib/nanoc/base/compilation/outdatedness_reasons.rb +46 -0
data/lib/nanoc/base/compilation/rule.rb +73 -0
data/lib/nanoc/base/compilation/rule_context.rb +84 -0
data/lib/nanoc/base/compilation/rule_memory_calculator.rb +40 -0
data/lib/nanoc/base/compilation/rule_memory_store.rb +53 -0
data/lib/nanoc/base/compilation/rules_collection.rb +243 -0
data/lib/nanoc/base/context.rb +47 -0
data/lib/nanoc/base/core_ext.rb +6 -0
data/lib/nanoc/base/core_ext/array.rb +62 -0
data/lib/nanoc/base/core_ext/hash.rb +63 -0
data/lib/nanoc/base/core_ext/pathname.rb +26 -0
data/lib/nanoc/base/core_ext/string.rb +46 -0
data/lib/nanoc/base/directed_graph.rb +275 -0
data/lib/nanoc/base/errors.rb +211 -0
data/lib/nanoc/base/memoization.rb +67 -0
data/lib/nanoc/base/notification_center.rb +84 -0
data/lib/nanoc/base/ordered_hash.rb +200 -0
data/lib/nanoc/base/plugin_registry.rb +181 -0
data/lib/nanoc/base/result_data/item_rep.rb +492 -0
data/lib/nanoc/base/source_data/code_snippet.rb +58 -0
data/lib/nanoc/base/source_data/configuration.rb +24 -0
data/lib/nanoc/base/source_data/data_source.rb +234 -0
data/lib/nanoc/base/source_data/item.rb +301 -0
data/lib/nanoc/base/source_data/layout.rb +130 -0
data/lib/nanoc/base/source_data/site.rb +361 -0
data/lib/nanoc/base/store.rb +135 -0
data/lib/nanoc/cli.rb +137 -0
data/lib/nanoc/cli/command_runner.rb +104 -0
data/lib/nanoc/cli/commands/autocompile.rb +58 -0
data/lib/nanoc/cli/commands/compile.rb +297 -0
data/lib/nanoc/cli/commands/create_item.rb +60 -0
data/lib/nanoc/cli/commands/create_layout.rb +73 -0
data/lib/nanoc/cli/commands/create_site.rb +411 -0
data/lib/nanoc/cli/commands/debug.rb +117 -0
data/lib/nanoc/cli/commands/deploy.rb +79 -0
data/lib/nanoc/cli/commands/info.rb +98 -0
data/lib/nanoc/cli/commands/nanoc.rb +38 -0
data/lib/nanoc/cli/commands/prune.rb +50 -0
data/lib/nanoc/cli/commands/update.rb +70 -0
data/lib/nanoc/cli/commands/view.rb +82 -0
data/lib/nanoc/cli/commands/watch.rb +124 -0
data/lib/nanoc/cli/error_handler.rb +199 -0
data/lib/nanoc/cli/logger.rb +92 -0
data/lib/nanoc/data_sources.rb +29 -0
data/lib/nanoc/data_sources/deprecated/delicious.rb +42 -0
data/lib/nanoc/data_sources/deprecated/last_fm.rb +87 -0
data/lib/nanoc/data_sources/deprecated/twitter.rb +38 -0
data/lib/nanoc/data_sources/filesystem.rb +299 -0
data/lib/nanoc/data_sources/filesystem_unified.rb +121 -0
data/lib/nanoc/data_sources/filesystem_verbose.rb +91 -0
data/lib/nanoc/extra.rb +24 -0
data/lib/nanoc/extra/auto_compiler.rb +103 -0
data/lib/nanoc/extra/chick.rb +125 -0
data/lib/nanoc/extra/core_ext.rb +6 -0
data/lib/nanoc/extra/core_ext/enumerable.rb +33 -0
data/lib/nanoc/extra/core_ext/pathname.rb +30 -0
data/lib/nanoc/extra/core_ext/time.rb +19 -0
data/lib/nanoc/extra/deployer.rb +47 -0
data/lib/nanoc/extra/deployers.rb +15 -0
data/lib/nanoc/extra/deployers/fog.rb +98 -0
data/lib/nanoc/extra/deployers/rsync.rb +70 -0
data/lib/nanoc/extra/file_proxy.rb +40 -0
data/lib/nanoc/extra/pruner.rb +86 -0
data/lib/nanoc/extra/validators.rb +12 -0
data/lib/nanoc/extra/validators/links.rb +268 -0
data/lib/nanoc/extra/validators/w3c.rb +95 -0
data/lib/nanoc/extra/vcs.rb +66 -0
data/lib/nanoc/extra/vcses.rb +17 -0
data/lib/nanoc/extra/vcses/bazaar.rb +25 -0
data/lib/nanoc/extra/vcses/dummy.rb +24 -0
data/lib/nanoc/extra/vcses/git.rb +25 -0
data/lib/nanoc/extra/vcses/mercurial.rb +25 -0
data/lib/nanoc/extra/vcses/subversion.rb +25 -0
data/lib/nanoc/filters.rb +59 -0
data/lib/nanoc/filters/asciidoc.rb +38 -0
data/lib/nanoc/filters/bluecloth.rb +19 -0
data/lib/nanoc/filters/coderay.rb +21 -0
data/lib/nanoc/filters/coffeescript.rb +20 -0
data/lib/nanoc/filters/colorize_syntax.rb +298 -0
data/lib/nanoc/filters/erb.rb +38 -0
data/lib/nanoc/filters/erubis.rb +34 -0
data/lib/nanoc/filters/haml.rb +27 -0
data/lib/nanoc/filters/kramdown.rb +20 -0
data/lib/nanoc/filters/less.rb +53 -0
data/lib/nanoc/filters/markaby.rb +20 -0
data/lib/nanoc/filters/maruku.rb +20 -0
data/lib/nanoc/filters/mustache.rb +24 -0
data/lib/nanoc/filters/rainpress.rb +19 -0
data/lib/nanoc/filters/rdiscount.rb +22 -0
data/lib/nanoc/filters/rdoc.rb +33 -0
data/lib/nanoc/filters/redcarpet.rb +62 -0
data/lib/nanoc/filters/redcloth.rb +47 -0
data/lib/nanoc/filters/relativize_paths.rb +94 -0
data/lib/nanoc/filters/rubypants.rb +20 -0
data/lib/nanoc/filters/sass.rb +74 -0
data/lib/nanoc/filters/slim.rb +25 -0
data/lib/nanoc/filters/typogruby.rb +23 -0
data/lib/nanoc/filters/uglify_js.rb +42 -0
data/lib/nanoc/filters/xsl.rb +46 -0
data/lib/nanoc/filters/yui_compressor.rb +23 -0
data/lib/nanoc/helpers.rb +16 -0
data/lib/nanoc/helpers/blogging.rb +319 -0
data/lib/nanoc/helpers/breadcrumbs.rb +40 -0
data/lib/nanoc/helpers/capturing.rb +138 -0
data/lib/nanoc/helpers/filtering.rb +50 -0
data/lib/nanoc/helpers/html_escape.rb +55 -0
data/lib/nanoc/helpers/link_to.rb +151 -0
data/lib/nanoc/helpers/rendering.rb +140 -0
data/lib/nanoc/helpers/tagging.rb +71 -0
data/lib/nanoc/helpers/text.rb +44 -0
data/lib/nanoc/helpers/xml_sitemap.rb +76 -0
data/lib/nanoc/tasks.rb +10 -0
data/lib/nanoc/tasks/clean.rake +16 -0
data/lib/nanoc/tasks/clean.rb +29 -0
data/lib/nanoc/tasks/deploy/rsync.rake +16 -0
data/lib/nanoc/tasks/validate.rake +92 -0
data/nanoc.gemspec +49 -0
data/tasks/doc.rake +16 -0
data/tasks/test.rake +46 -0
data/test/base/core_ext/array_spec.rb +73 -0
data/test/base/core_ext/hash_spec.rb +98 -0
data/test/base/core_ext/pathname_spec.rb +27 -0
data/test/base/core_ext/string_spec.rb +37 -0
data/test/base/test_checksum_store.rb +35 -0
data/test/base/test_code_snippet.rb +31 -0
data/test/base/test_compiler.rb +403 -0
data/test/base/test_compiler_dsl.rb +161 -0
data/test/base/test_context.rb +31 -0
data/test/base/test_data_source.rb +46 -0
data/test/base/test_dependency_tracker.rb +262 -0
data/test/base/test_directed_graph.rb +288 -0
data/test/base/test_filter.rb +83 -0
data/test/base/test_item.rb +179 -0
data/test/base/test_item_rep.rb +579 -0
data/test/base/test_layout.rb +59 -0
data/test/base/test_memoization.rb +90 -0
data/test/base/test_notification_center.rb +34 -0
data/test/base/test_outdatedness_checker.rb +394 -0
data/test/base/test_plugin.rb +30 -0
data/test/base/test_rule.rb +19 -0
data/test/base/test_rule_context.rb +65 -0
data/test/base/test_site.rb +190 -0
data/test/cli/commands/test_compile.rb +33 -0
data/test/cli/commands/test_create_item.rb +14 -0
data/test/cli/commands/test_create_layout.rb +28 -0
data/test/cli/commands/test_create_site.rb +24 -0
data/test/cli/commands/test_deploy.rb +74 -0
data/test/cli/commands/test_help.rb +12 -0
data/test/cli/commands/test_info.rb +11 -0
data/test/cli/commands/test_prune.rb +98 -0
data/test/cli/commands/test_update.rb +10 -0
data/test/cli/test_cli.rb +102 -0
data/test/cli/test_error_handler.rb +29 -0
data/test/cli/test_logger.rb +10 -0
data/test/data_sources/test_filesystem.rb +433 -0
data/test/data_sources/test_filesystem_unified.rb +536 -0
data/test/data_sources/test_filesystem_verbose.rb +357 -0
data/test/extra/core_ext/test_enumerable.rb +30 -0
data/test/extra/core_ext/test_pathname.rb +17 -0
data/test/extra/core_ext/test_time.rb +15 -0
data/test/extra/deployers/test_fog.rb +67 -0
data/test/extra/deployers/test_rsync.rb +100 -0
data/test/extra/test_auto_compiler.rb +417 -0
data/test/extra/test_file_proxy.rb +19 -0
data/test/extra/test_vcs.rb +22 -0
data/test/extra/validators/test_links.rb +62 -0
data/test/extra/validators/test_w3c.rb +47 -0
data/test/filters/test_asciidoc.rb +22 -0
data/test/filters/test_bluecloth.rb +18 -0
data/test/filters/test_coderay.rb +44 -0
data/test/filters/test_coffeescript.rb +18 -0
data/test/filters/test_colorize_syntax.rb +379 -0
data/test/filters/test_erb.rb +105 -0
data/test/filters/test_erubis.rb +78 -0
data/test/filters/test_haml.rb +96 -0
data/test/filters/test_kramdown.rb +18 -0
data/test/filters/test_less.rb +113 -0
data/test/filters/test_markaby.rb +24 -0
data/test/filters/test_maruku.rb +18 -0
data/test/filters/test_mustache.rb +25 -0
data/test/filters/test_rainpress.rb +29 -0
data/test/filters/test_rdiscount.rb +31 -0
data/test/filters/test_rdoc.rb +18 -0
data/test/filters/test_redcarpet.rb +73 -0
data/test/filters/test_redcloth.rb +33 -0
data/test/filters/test_relativize_paths.rb +533 -0
data/test/filters/test_rubypants.rb +18 -0
data/test/filters/test_sass.rb +229 -0
data/test/filters/test_slim.rb +35 -0
data/test/filters/test_typogruby.rb +21 -0
data/test/filters/test_uglify_js.rb +30 -0
data/test/filters/test_xsl.rb +105 -0
data/test/filters/test_yui_compressor.rb +44 -0
data/test/gem_loader.rb +11 -0
data/test/helper.rb +207 -0
data/test/helpers/test_blogging.rb +754 -0
data/test/helpers/test_breadcrumbs.rb +81 -0
data/test/helpers/test_capturing.rb +41 -0
data/test/helpers/test_filtering.rb +106 -0
data/test/helpers/test_html_escape.rb +32 -0
data/test/helpers/test_link_to.rb +249 -0
data/test/helpers/test_rendering.rb +89 -0
data/test/helpers/test_tagging.rb +87 -0
data/test/helpers/test_text.rb +24 -0
data/test/helpers/test_xml_sitemap.rb +103 -0
data/test/tasks/test_clean.rb +67 -0
metadata +327 -15
data/bin/nanoc-select +0 -86
data/lib/nanoc-select.rb +0 -11

data/lib/nanoc/cli/commands/create_item.rb ADDED

@@ -0,0 +1,60 @@
+# encoding: utf-8
+usage       'create_item [options] identifier'
+summary     'create an item'
+aliases     :ci
+description <<-EOS
+Create a new item in the current site. The first data source in the site
+configuration will be used.
+EOS
+required :c, :vcs, 'specify the VCS to use'
+module Nanoc::CLI::Commands
+  class CreateItem < ::Nanoc::CLI::CommandRunner
+    def run
+      # Check arguments
+      if arguments.length != 1
+        $stderr.puts "usage: #{command.usage}"
+        exit 1
+      end
+      # Extract arguments and options
+      identifier = arguments[0].cleaned_identifier
+      # Make sure we are in a nanoc site directory
+      self.require_site
+      # Set VCS if possible
+      self.set_vcs(options[:vcs])
+      # Check whether item is unique
+      if !self.site.items.find { |i| i.identifier == identifier }.nil?
+        $stderr.puts "An item already exists at #{identifier}. Please " +
+                     "pick a unique name for the item you are creating."
+        exit 1
+      end
+      # Setup notifications
+      Nanoc::NotificationCenter.on(:file_created) do |file_path|
+        Nanoc::CLI::Logger.instance.file(:high, :create, file_path)
+      end
+      # Create item
+      data_source = self.site.data_sources[0]
+      data_source.create_item(
+        "Hi, I'm a new item!\n",
+        { :title => "A New Item" },
+        identifier
+      )
+      puts "An item has been created at #{identifier}."
+    end
+  end
+end
+runner Nanoc::CLI::Commands::CreateItem

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

@@ -0,0 +1,73 @@
+# encoding: utf-8
+usage       'create_layout [options] identifier'
+aliases     'cl'
+summary     'create a layout'
+description <<-EOS
+Create a new layout in the current site. The first data source in the site
+configuration will be used.
+EOS
+module Nanoc::CLI::Commands
+  class CreateLayout < ::Nanoc::CLI::CommandRunner
+    def run
+      # Check arguments
+      if arguments.length != 1
+        $stderr.puts "usage: #{command.usage}"
+        exit 1
+      end
+      # Extract arguments
+      identifier = arguments[0].cleaned_identifier
+      # Make sure we are in a nanoc site directory
+      self.require_site
+      # Set VCS if possible
+      self.set_vcs(options[:vcs])
+      # Check whether layout is unique
+      if !self.site.layouts.find { |l| l.identifier == identifier }.nil?
+        $stderr.puts "A layout already exists at #{identifier}. Please " +
+                     "pick a unique name for the layout you are creating."
+        exit 1
+      end
+      # Check whether layout is not at /
+      if identifier == '/'
+        $stderr.puts "There cannot be a layout with the identifier '/'; " +
+                     "please pick a different identifier for this layout."
+        exit 1
+      end
+      # Setup notifications
+      Nanoc::NotificationCenter.on(:file_created) do |file_path|
+        Nanoc::CLI::Logger.instance.file(:high, :create, file_path)
+      end
+      # Create layout
+      data_source = self.site.data_sources[0]
+      data_source.create_layout(
+        "<html>\n" +
+        "  <head>\n" +
+        "    <title><%= @item[:title] %></title>\n" +
+        "  </head>\n" +
+        "  <body>\n" +
+        "    <p>Hi, I'm a new layout. Please customize me!</p>\n" +
+        "<%= yield %>\n" +
+        "  </body>\n" +
+        "</html>\n",
+        {},
+        identifier
+      )
+      puts "A layout has been created at #{identifier}."
+    end
+  end
+end
+runner Nanoc::CLI::Commands::CreateLayout

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

@@ -0,0 +1,411 @@
+# encoding: utf-8
+usage       'create_site [options] path'
+aliases     'cs'
+summary     'create a site'
+description <<-EOS
+Create a new site at the given path. The site will use the filesystem_unified data source by default, but this can be changed using the --datasource commandline option.
+EOS
+required :d, :datasource, 'specify the data source for the new site'
+module Nanoc::CLI::Commands
+  class CreateSite < ::Nanoc::CLI::CommandRunner
+    class << self
+    protected
+      # Converts the given array to YAML format
+      def array_to_yaml(array)
+        '[ ' + array.map { |s| "'" + s + "'" }.join(', ') + ' ]'
+      end
+    end
+    DEFAULT_CONFIG = <<EOS
+# A list of file extensions that nanoc will consider to be textual rather than
+# binary. If an item with an extension not in this list is found,  the file
+# will be considered as binary.
+text_extensions: #{array_to_yaml(Nanoc::Site::DEFAULT_CONFIG[:text_extensions])}
+# The path to the directory where all generated files will be written to. This
+# can be an absolute path starting with a slash, but it can also be path
+# relative to the site directory.
+output_dir: #{Nanoc::Site::DEFAULT_CONFIG[:output_dir]}
+# A list of index filenames, i.e. names of files that will be served by a web
+# server when a directory is requested. Usually, index files are named
+# “index.html”, but depending on the web server, this may be something else,
+# such as “default.htm”. This list is used by nanoc to generate pretty URLs.
+index_filenames: #{array_to_yaml(Nanoc::Site::DEFAULT_CONFIG[:index_filenames])}
+# Whether or not to generate a diff of the compiled content when compiling a
+# site. The diff will contain the differences between the compiled content
+# before and after the last site compilation.
+enable_output_diff: false
+prune:
+  # Whether to automatically remove files not managed by nanoc from the output
+  # directory. For safety reasons, this is turned off by default.
+  auto_prune: false
+  # Which files and directories you want to exclude from pruning. If you version
+  # your output directory, you should probably exclude VCS directories such as
+  # .git, .svn etc.
+  exclude: [ '.git', '.hg', '.svn', 'CVS' ]
+# The data sources where nanoc loads its data from. This is an array of
+# hashes; each array element represents a single data source. By default,
+# there is only a single data source that reads data from the “content/” and
+# “layout/” directories in the site directory.
+data_sources:
+  -
+    # The type is the identifier of the data source. By default, this will be
+    # `filesystem_unified`.
+    type: #{Nanoc::Site::DEFAULT_DATA_SOURCE_CONFIG[:type]}
+    # The path where items should be mounted (comparable to mount points in
+    # Unix-like systems). This is “/” by default, meaning that items will have
+    # “/” prefixed to their identifiers. If the items root were “/en/”
+    # instead, an item at content/about.html would have an identifier of
+    # “/en/about/” instead of just “/about/”.
+    items_root: #{Nanoc::Site::DEFAULT_DATA_SOURCE_CONFIG[:items_root]}
+    # The path where layouts should be mounted. The layouts root behaves the
+    # same as the items root, but applies to layouts rather than items.
+    layouts_root: #{Nanoc::Site::DEFAULT_DATA_SOURCE_CONFIG[:layouts_root]}
+    # Whether to allow periods in identifiers. When turned off, everything
+    # past the first period is considered to be the extension, and when
+    # turned on, only the characters past the last period are considered to
+    # be the extension. For example,  a file named “content/about.html.erb”
+    # will have the identifier “/about/” when turned off, but when turned on
+    # it will become “/about.html/” instead.
+    allow_periods_in_identifiers: false
+# Configuration for the “watch” command, which watches a site for changes and
+# recompiles if necessary.
+watcher:
+  # A list of directories to watch for changes. When editing this, make sure
+  # that the “output/” and “tmp/” directories are _not_ included in this list,
+  # because recompiling the site will cause these directories to change, which
+  # will cause the site to be recompiled, which will cause these directories
+  # to change, which will cause the site to be recompiled again, and so on.
+  dirs_to_watch: [ 'content', 'layouts', 'lib' ]
+  # A list of single files to watch for changes. As mentioned above, don’t put
+  # any files from the “output/” or “tmp/” directories in here.
+  files_to_watch: [ 'config.yaml', 'Rules' ]
+  # When to send notifications (using Growl or notify-send).
+  notify_on_compilation_success: true
+  notify_on_compilation_failure: true
+EOS
+    DEFAULT_RULES = <<EOS
+#!/usr/bin/env ruby
+# A few helpful tips about the Rules file:
+#
+# * The string given to #compile and #route are matching patterns for
+#   identifiers--not for paths. Therefore, you can’t match on extension.
+#
+# * The order of rules is important: for each item, only the first matching
+#   rule is applied.
+#
+# * Item identifiers start and end with a slash (e.g. “/about/” for the file
+#   “content/about.html”). To select all children, grandchildren, … of an
+#   item, use the pattern “/about/*/”; “/about/*” will also select the parent,
+#   because “*” matches zero or more characters.
+compile '/stylesheet/' do
+  # don’t filter or layout
+end
+compile '*' do
+  if item.binary?
+    # don’t filter binary items
+  else
+    filter :erb
+    layout 'default'
+  end
+end
+route '/stylesheet/' do
+  '/style.css'
+end
+route '*' do
+  if item.binary?
+    # Write item with identifier /foo/ to /foo.ext
+    item.identifier.chop + '.' + item[:extension]
+  else
+    # Write item with identifier /foo/ to /foo/index.html
+    item.identifier + 'index.html'
+  end
+end
+layout '*', :erb
+EOS
+    DEFAULT_ITEM = <<EOS
+<h1>A Brand New nanoc Site</h1>
+<p>You’ve just created a new nanoc site. The page you are looking at right now is the home page for your site. To get started, consider replacing this default homepage with your own customized homepage. Some pointers on how to do so:</p>
+<ul>
+  <li><p><strong>Change this page’s content</strong> by editing the “index.html” file in the “content” directory. This is the actual page content, and therefore doesn’t include the header, sidebar or style information (those are part of the layout).</p></li>
+  <li><p><strong>Change the layout</strong>, which is the “default.html” file in the “layouts” directory, and create something unique (and hopefully less bland).</p></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_STYLESHEET = <<EOS
+* {
+  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: 40px;
+  left: 280px;
+  width: 500px;
+}
+#main h1 {
+  font-size: 40px;
+  font-weight: normal;
+  line-height: 40px;
+  letter-spacing: -1px;
+}
+#main p {
+  margin: 20px 0;
+  font-size: 15px;
+  line-height: 20px;
+}
+#main ul, #main ol {
+  margin: 20px;
+}
+#main li {
+  font-size: 15px;
+  line-height: 20px;
+}
+#main ul li {
+  list-style-type: square;
+}
+#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;
+}
+EOS
+    DEFAULT_LAYOUT = <<EOS
+<!DOCTYPE HTML>
+<html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <title>A Brand New nanoc Site - <%= @item[:title] %></title>
+    <link rel="stylesheet" type="text/css" href="/style.css" media="screen">
+    <meta name="generator" content="nanoc #{Nanoc::VERSION}">
+  </head>
+  <body>
+    <div id="main">
+      <%= yield %>
+    </div>
+    <div id="sidebar">
+      <h2>Documentation</h2>
+      <ul>
+        <li><a href="http://nanoc.stoneship.org/docs/">Documentation</a></li>
+        <li><a href="http://nanoc.stoneship.org/docs/3-getting-started/">Getting Started</a></li>
+      </ul>
+      <h2>Community</h2>
+      <ul>
+        <li><a href="http://groups.google.com/group/nanoc/">Discussion Group</a></li>
+        <li><a href="irc://chat.freenode.net/#nanoc">IRC Channel</a></li>
+        <li><a href="http://projects.stoneship.org/trac/nanoc/">Wiki</a></li>
+      </ul>
+    </div>
+  </body>
+</html>
+EOS
+    def run
+      # Check arguments
+      if arguments.length != 1
+        $stderr.puts "usage: #{command.usage}"
+        exit 1
+      end
+      # Extract arguments and options
+      path        = arguments[0]
+      data_source = options[:datasource] || 'filesystem_unified'
+      # 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 Nanoc::DataSource.named(data_source).nil?
+        $stderr.puts "Unrecognised data source: #{data_source}"
+        exit 1
+      end
+      # Setup notifications
+      Nanoc::NotificationCenter.on(:file_created) do |file_path|
+        Nanoc::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 that loads the standard nanoc tasks.
+    def site_create_minimal(data_source)
+      # Create output
+      FileUtils.mkdir_p('output')
+      # Create config
+      File.open('config.yaml', 'w') { |io| io.write(DEFAULT_CONFIG.make_compatible_with_env) }
+      Nanoc::NotificationCenter.post(:file_created, 'config.yaml')
+      # Create rules
+      File.open('Rules', 'w') do |io|
+        io.write DEFAULT_RULES.make_compatible_with_env
+      end
+      Nanoc::NotificationCenter.post(:file_created, 'Rules')
+    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 = Nanoc::Site.new('.')
+      # Set up data sources
+      site.data_sources.each do |data_source|
+        data_source.loading { data_source.setup }
+      end
+    end
+    # Populates the site with some initial data, such as a root item, a
+    # default layout, and so on.
+    def site_populate
+      # Get site
+      site = Nanoc::Site.new('.')
+      data_source = site.data_sources[0]
+      # Create home page
+      data_source.create_item(
+        DEFAULT_ITEM.make_compatible_with_env,
+        { :title => "Home" },
+        '/'
+      )
+      # Create stylesheet
+      data_source.create_item(
+        DEFAULT_STYLESHEET.make_compatible_with_env,
+        {},
+        '/stylesheet/',
+        :extension => '.css'
+      )
+      # Create layout
+      data_source.create_layout(
+        DEFAULT_LAYOUT.make_compatible_with_env,
+        {},
+        '/default/'
+      )
+      # Create code
+      FileUtils.mkdir_p('lib')
+      File.open('lib/default.rb', 'w') do |io|
+        io.write "\# All files in the 'lib' directory will be loaded\n"
+        io.write "\# before nanoc starts compiling.\n"
+      end
+    end
+  end
+end
+runner Nanoc::CLI::Commands::CreateSite