nanoc3 3.1.0a2 → 3.1.0a3

data/lib/nanoc3/base/site.rb

@@ -15,9 +15,10 @@ module Nanoc3
   # A site also has several helper classes:
   #
   # * {#data_sources} (array of {Nanoc3::DataSource}) - A list of data sources
-  #     that are used for loading site data
+  #   that are used for loading site data
+  #
   # * {#compiler} ({Nanoc3::Compiler}) - The compiler that is used for
-  #     compiling items and their representations
+  #   compiling items and their representations
   #
   # The physical representation of a {Nanoc3::Site} is usually a directory
   # that contains a configuration file, site data, a rakefile, a rules file,
@@ -38,6 +39,7 @@ module Nanoc3
     # that lacks some options, the default value will be taken from
     # `DEFAULT_CONFIG`.
     DEFAULT_CONFIG = {
+      :text_extensions => %w( css erb haml htm html less markdown md sass txt ),
       :output_dir      => 'output',
       :data_sources    => [ {} ],
       :index_filenames => [ 'index.html' ]
@@ -46,55 +48,54 @@ module Nanoc3
     # The site configuration. The configuration has the following keys:
     #
     # * `output_dir` ({String}) - The directory to which compiled items will
-    #     be written. This path is relative to the current working directory,
-    #     but can also be an absolute path.
+    #   be written. This path is relative to the current working directory,
+    #   but can also be an absolute path.
     #
     # * `data_sources` ({Array<Hash>}) - A list of data sources for this site.
-    #     See below for documentation on the structure of this list. By
-    #     default, there is only one data source of the filesystem  type
-    #     mounted at `/`.
+    #   See below for documentation on the structure of this list. By default,
+    #   there is only one data source of the filesystem  type mounted at `/`.
     #
     # * `index_filenames` ({Array<String>}) - A list of filenames that will be
-    #     stripped off full item paths to create cleaner URLs. For example,
-    #     `/about/` will be used instead of `/about/index.html`). The default
-    #     value should be okay in most cases.
+    #   stripped off full item paths to create cleaner URLs. For example,
+    #   `/about/` will be used instead of `/about/index.html`). The default
+    #   value should be okay in most cases.
     #
     # The list of data sources consists of hashes with the following keys:
     #
     # * `:type` ({String}) - The type of data source, i.e. its identifier.
     #
     # * `:items_root` ({String}) - The prefix that should be given to all
-    #     items returned by the {#items} method (comparable to mount points
-    #     for filesystems in Unix-ish OSes).
+    #   items returned by the {#items} method (comparable to mount points
+    #   for filesystems in Unix-ish OSes).
     #
     # * `:layouts_root` ({String}) - The prefix that should be given to all
-    #     layouts returned by the {#layouts} method (comparable to mount
-    #     points for filesystems in Unix-ish OSes).
+    #   layouts returned by the {#layouts} method (comparable to mount
+    #   points for filesystems in Unix-ish OSes).
     #
     # * `:config` ({Hash}) - A hash containing the configuration for this data
-    #     source. nanoc itself does not use this hash. This is especially
-    #     useful for online data sources; for example, a Twitter data source
-    #     would need the username of the account from which to fetch tweets.
+    #   source. nanoc itself does not use this hash. This is especially
+    #   useful for online data sources; for example, a Twitter data source
+    #   would need the username of the account from which to fetch tweets.
     #
     # @return [Hash] The site configuration
     attr_reader :config
 
     # @return [Time] The timestamp when the site configuration was last
-    #   modified
+    # modified
     attr_reader :config_mtime
 
     # @return [Time] The timestamp when the rules were last modified
     attr_reader :rules_mtime
 
     # @return [Proc] The code block that will be executed after all data is
-    #   loaded but before the site is compiled
+    # loaded but before the site is compiled
     attr_accessor :preprocessor
 
     # Creates a site object for the site specified by the given
     # `dir_or_config_hash` argument.
     #
     # @param [Hash, String] dir_or_config_hash If a string, contains the path
-    #   to the site directory; if a hash, contains the site configuration.
+    # to the site directory; if a hash, contains the site configuration.
     def initialize(dir_or_config_hash)
       build_config(dir_or_config_hash)
 
@@ -115,10 +116,10 @@ module Nanoc3
     # none exists yet.
     #
     # @return [Array<Nanoc3::DataSource>] The list of data sources for this
-    #   site
+    # site
     #
     # @raise [Nanoc3::Errors::UnknownDataSource] if the site configuration
-    #   specifies an unknown data source
+    # specifies an unknown data source
     def data_sources
       @data_sources ||= begin
         @config[:data_sources].map do |data_source_hash|
@@ -128,8 +129,11 @@ module Nanoc3
 
           # Warn about deprecated data sources
           # TODO [in nanoc 4.0] remove me
-          if data_source_hash[:type] == 'filesystem'
-            warn "Warning: the 'filesystem' data source has been renamed to 'filesystem_verbose'. Using 'filesystem' will work in nanoc 3.1.x, but it will likely not work anymore in a future release of nanoc. Please update your data source configuration and replace 'filesystem' with 'filesystem_verbose'."
+          case data_source_hash[:type]
+            when 'filesystem'
+              warn "Warning: the 'filesystem' data source has been renamed to 'filesystem_verbose'. Using 'filesystem' will work in nanoc 3.1.x, but it will likely not work anymore in a future release of nanoc. Please update your data source configuration and replace 'filesystem' with 'filesystem_verbose'."
+            when 'filesystem_combined', 'filesystem_compact'
+              warn "Warning: the 'filesystem_combined' and 'filesystem_compact' data source has been merged into the new 'filesystem_unified' data source. Using 'filesystem_combined' and 'filesystem_compact' will work in nanoc 3.1.x, but it will likely not work anymore in a future release of nanoc. Please update your data source configuration and replace 'filesystem_combined' and 'filesystem_compact with 'filesystem_unified'."
           end
 
           # Create data source
@@ -149,7 +153,7 @@ module Nanoc3
     # the `force` parameter is true.
     #
     # @param [Boolean] force If true, will force load the site data even if it
-    #   has been loaded before, to circumvent caching issues
+    # has been loaded before, to circumvent caching issues
     #
     # @return [void]
     def load_data(force=false)
@@ -179,10 +183,10 @@ module Nanoc3
     # Returns this site’s code snippets.
     #
     # @return [Array<Nanoc3::CodeSnippet>] The list of code snippets in this
-    #   site
+    # site
     #
     # @raise [Nanoc3::Errors::DataNotYetAvailable] if the site data hasn’t
-    #   been loaded yet (call {#load_data} to load the site data)
+    # been loaded yet (call {#load_data} to load the site data)
     def code_snippets
       raise Nanoc3::Errors::DataNotYetAvailable.new('Code snippets', false) unless @code_snippets_loaded
       @code_snippets
@@ -193,7 +197,7 @@ module Nanoc3
     # @return [Array<Nanoc3::Item>] The list of items in this site
     #
     # @raise [Nanoc3::Errors::DataNotYetAvailable] if the site data hasn’t
-    #   been loaded yet (call {#load_data} to load the site data)
+    # been loaded yet (call {#load_data} to load the site data)
     def items
       raise Nanoc3::Errors::DataNotYetAvailable.new('Items', true) unless @items_loaded
       @items
@@ -204,7 +208,7 @@ module Nanoc3
     # @return [Array<Nanoc3::Layouts>] The list of layout in this site
     #
     # @raise [Nanoc3::Errors::DataNotYetAvailable] if the site data hasn’t
-    #   been loaded yet (call {#load_data} to load the site data)
+    # been loaded yet (call {#load_data} to load the site data)
     def layouts
       raise Nanoc3::Errors::DataNotYetAvailable.new('Layouts', true) unless @layouts_loaded
       @layouts

data/lib/nanoc3/cli/base.rb

@@ -203,7 +203,7 @@ module Nanoc3::CLI
     def handle_option(option)
       case option
       when :version
-        puts "nanoc #{Nanoc3::VERSION} (c) 2007-2009 Denis Defreyne."
+        puts "nanoc #{Nanoc3::VERSION} (c) 2007-2010 Denis Defreyne."
         puts "Ruby #{RUBY_VERSION} (#{RUBY_RELEASE_DATE}) running on #{RUBY_PLATFORM}"
         exit 0
       when :verbose

data/lib/nanoc3/cli/commands/create_site.rb

@@ -40,13 +40,11 @@ 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 (and it’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>
+<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 “content.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.txt” file in the “layouts/default” directory, and create something unique (and hopefully less bland).</p></li>
+  <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>
@@ -155,28 +153,28 @@ a:hover {
 EOS
 
     DEFAULT_LAYOUT = <<EOS
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
-<html>
+<!DOCTYPE HTML>
+<html lang="en">
   <head>
+    <meta charset="utf-8">
     <title>A Brand New nanoc Site - <%= @item[:title] %></title>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
     <link rel="stylesheet" type="text/css" href="/style.css" media="screen">
     <meta name="generator" content="nanoc #{Nanoc3::VERSION}">
   </head>
   <body>
     <div id="main">
-<%= yield %>
+      <%= yield %>
     </div>
     <div id="sidebar">
       <h2>Documentation</h2>
       <ul>
-        <li><a href="http://nanoc.stoneship.org/tutorial/">Tutorial</a></li>
-        <li><a href="http://nanoc.stoneship.org/manual/">Manual</a></li>
+        <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="http://groups.google.com/group/nanoc-es/">Spanish 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>
@@ -198,7 +196,7 @@ EOS
 
     def long_desc
       'Create a new site at the given path. The site will use the ' +
-      'filesystem_compact data source by default, but this can be ' +
+      'filesystem_unified data source by default, but this can be ' +
       'changed using the --datasource commandline option.'
     end
 
@@ -225,7 +223,7 @@ EOS
 
       # Extract arguments and options
       path        = arguments[0]
-      data_source = options[:datasource] || 'filesystem_compact'
+      data_source = options[:datasource] || 'filesystem_unified'
 
       # Check whether site exists
       if File.exist?(path)

data/lib/nanoc3/cli.rb

@@ -3,7 +3,6 @@
 # Load Cri
 require 'cri'
 
-# Module for CLI
 module Nanoc3::CLI
 end
 

data/lib/nanoc3/data_sources/filesystem.rb

@@ -81,7 +81,14 @@ module Nanoc3::DataSources
         content_filename = filename_for(base_filename, content_ext)
 
         # Read content and metadata
-        meta, content = parse(content_filename, meta_filename, kind)
+        is_binary = !!(content_filename && !@site.config[:text_extensions].include?(File.extname(content_filename)[1..-1]))
+        if is_binary
+          meta                = (meta_filename && YAML.load_file(meta_filename)) || {}
+          content_or_filename = content_filename
+        else
+          meta, content_or_filename = parse(
+            content_filename, meta_filename, kind)
+        end
 
         # Get attributes
         attributes = {
@@ -118,7 +125,10 @@ module Nanoc3::DataSources
         end
 
         # Create layout object
-        klass.new(content, attributes, identifier, mtime)
+        klass.new(
+          content_or_filename, attributes, identifier,
+          :binary => is_binary, :mtime => mtime
+        )
       end
     end
 

data/lib/nanoc3/data_sources/filesystem_unified.rb

@@ -14,10 +14,10 @@ module Nanoc3::DataSources
   # itself can start with a metadata section: it can be stored at the top of
   # the file, between `---` (three dashes) separators. For example:
   #
-  #     ---
-  #     title: "Moo!"
-  #     ---
-  #     h1. Hello!
+  #   ---
+  #   title: "Moo!"
+  #   ---
+  #   h1. Hello!
   #
   # The metadata section can be omitted. If the file does not start with
   # three or five dashes, the entire file will be considered as content.
@@ -26,7 +26,7 @@ module Nanoc3::DataSources
   # an `index.*` filename, such as `index.txt`, will have the filesystem path
   # with the `index.*` part stripped as a identifier. For example:
   #
-  #     foo/bar/index.html → /foo/bar/
+  #   foo/bar/index.html → /foo/bar/
   #
   # In other cases, the identifier is calculated by stripping the extension.
   # If the `allow_periods_in_identifiers` attribute in the configuration is
@@ -34,24 +34,24 @@ module Nanoc3::DataSources
   # extensions; if it is false or unset, all extensions will be stripped.
   # For example:
   #
-  #     (`allow_periods_in_identifiers` set to true)
-  #     foo.entry.html → /foo.entry/
-  #
-  #     (`allow_periods_in_identifiers` set to false)
-  #     foo.html.erb → /foo/
+  #   (`allow_periods_in_identifiers` set to true)
+  #   foo.entry.html → /foo.entry/
+  #   
+  #   (`allow_periods_in_identifiers` set to false)
+  #   foo.html.erb → /foo/
   #
   # Note that it is possible for two different, separate files to have the
   # same identifier. It is recommended to avoid such situations.
   #
   # Some more examples:
   #
-  #     content/index.html          → /
-  #     content/foo.html            → /foo/
-  #     content/foo/index.html      → /foo/
-  #     content/foo/bar.html        → /foo/bar/
-  #     content/foo/bar.baz.html    → /foo/bar/ OR /foo/bar.baz/
-  #     content/foo/bar/index.html  → /foo/bar/
-  #     content/foo.bar/index.html  → /foo.bar/
+  #   content/index.html          → /
+  #   content/foo.html            → /foo/
+  #   content/foo/index.html      → /foo/
+  #   content/foo/bar.html        → /foo/bar/
+  #   content/foo/bar.baz.html    → /foo/bar/ OR /foo/bar.baz/
+  #   content/foo/bar/index.html  → /foo/bar/
+  #   content/foo.bar/index.html  → /foo.bar/
   #
   # The file extension does not determine the filters to run on items; the
   # Rules file is used to specify processing instructors for each item.
@@ -80,8 +80,11 @@ module Nanoc3::DataSources
       # Write item
       FileUtils.mkdir_p(parent_path)
       File.open(path, 'w') do |io|
-        io.write(YAML.dump(attributes.stringify_keys) + "\n")
-        io.write("---\n")
+        meta = attributes.stringify_keys
+        unless meta == {}
+          io.write(YAML.dump(meta).strip + "\n")
+          io.write("---\n\n")
+        end
         io.write(content)
       end
     end

data/lib/nanoc3/extra/auto_compiler.rb

@@ -2,14 +2,16 @@
 
 module Nanoc3::Extra
 
-  # Nanoc3::Extra::AutoCompiler is a web server that will automatically compile
-  # items as they are requested. It also serves static files such as
-  # stylesheets and images.
+  # A web server that will automatically compile items as they are requested.
+  # It also serves static files such as stylesheets and images.
   class AutoCompiler
 
+    # @return [Nanoc3::Site] The site this autocompiler belongs to
     attr_reader :site
 
     # Creates a new autocompiler for the given site.
+    #
+    # @param [String] site_path The path to the site to autocompile
     def initialize(site_path)
       require 'rack'
       require 'mime/types'
@@ -21,6 +23,13 @@ module Nanoc3::Extra
       @mutex = Mutex.new
     end
 
+    # Calls the autocompiler. The behaviour of this method is defined by the
+    # [Rack specification](http://rack.rubyforge.org/doc/files/SPEC.html).
+    #
+    # @param [Hash] env The environment, as defined by the Rack specification
+    #
+    # @return [Array] An array containing the status, the headers, and the
+    # body, as defined by the Rack specification
     def call(env)
       @mutex.synchronize do
         # Start with a new site

data/lib/nanoc3/extra/chick.rb

@@ -4,10 +4,14 @@ require 'rack/cache'
 
 module Nanoc3::Extra
 
-  # CHiCk is a caching HTTP client that uses Rack::Cache.
+  # @deprecated Use a HTTP library such as
+  # [Net::HTTP](http://ruby-doc.org/stdlib/libdoc/net/http/rdoc/) or
+  # [Curb](http://curb.rubyforge.org/) instead.
   module CHiCk
 
-    # CHiCk::Client provides a simple API for issuing HTTP requests.
+    # @deprecated Use a HTTP library such as
+    # [Net::HTTP](http://ruby-doc.org/stdlib/libdoc/net/http/rdoc/) or
+    # [Curb](http://curb.rubyforge.org/) instead.
     class Client
 
       DEFAULT_OPTIONS = {
@@ -54,8 +58,9 @@ module Nanoc3::Extra
 
     end
 
-    # CHiCk::CacheController sets the Cache-Control header (and more
-    # specifically, max-age) to limit the number of necessary requests.
+    # @deprecated Use a HTTP library such as
+    # [Net::HTTP](http://ruby-doc.org/stdlib/libdoc/net/http/rdoc/) or
+    # [Curb](http://curb.rubyforge.org/) instead.
     class CacheController
 
       def initialize(app, options={})
@@ -73,8 +78,9 @@ module Nanoc3::Extra
 
     end
 
-    # CHiCk::RackClient performs the actual HTTP requests. It does not perform
-    # any caching.
+    # @deprecated Use a HTTP library such as
+    # [Net::HTTP](http://ruby-doc.org/stdlib/libdoc/net/http/rdoc/) or
+    # [Curb](http://curb.rubyforge.org/) instead.
     class RackClient
 
       METHOD_TO_CLASS_MAPPING = {

data/lib/nanoc3/extra/deployers/rsync.rb

@@ -2,9 +2,10 @@
 
 module Nanoc3::Extra::Deployers
 
-  # Nanoc3::Extra::Deployers::Rsync is a deployer that deploys a site using rsync.
+  # A deployer that deploys a site using rsync.
   class Rsync
 
+    # Default rsync options
     DEFAULT_OPTIONS = [
       '-glpPrtvz',
       '--exclude=".hg"',
@@ -19,40 +20,40 @@ module Nanoc3::Extra::Deployers
     # The deployment configurations are stored like this in the site's
     # configuration file:
     #
-    #     deploy:
-    #       NAME:
-    #         options: [ OPTIONS ]
-    #         dst:     "DST"
+    #   deploy:
+    #     NAME:
+    #       options: [ OPTIONS ]
+    #       dst:     "DST"
     #
-    # +NAME+ is a unique name for the deployment configuration. By default,
-    # the deployer will use the deployment configuration named "default".
+    # `NAME` is a unique name for the deployment configuration. By default,
+    # the deployer will use the deployment configuration named `"default"`.
     #
-    # +OPTIONS+ is an array containing options to pass to the rsync
-    # executable. This is not required; by default, +-glpPrtvz+ and
-    # +--exclude+s for +.svn+, +.hg+ and +.git+ are used.
+    # `OPTIONS` is an array containing options to pass to the rsync
+    # executable. This is not required; by default, {DEFAULT_OPTIONS} options
+    # will be used.
     #
-    # +DST+ is a string containing the destination to where rsync should
-    # upload its data. It will likely be in +host:path+ format. For example,
-    # "example.com:/var/www/sites/mysite/html". It should not end with a
+    # `DST` is a string containing the destination to where rsync should
+    # upload its data. It will likely be in `host:path` format. For example,
+    # `"example.com:/var/www/sites/mysite/html"`. It should not end with a
     # trailing slash.
     #
     # Example: This deployment configuration defines a "default" and a
     # "staging" deployment configuration. The default options are used.
     #
-    #     deploy:
-    #       default:
-    #         dst: "ectype:sites/stoneship/public"
-    #       staging:
-    #         dst: "ectype:sites/stoneship-staging/public"
-    #         options: [ "-glpPrtvz" ]
+    #   deploy:
+    #     default:
+    #       dst: "ectype:sites/stoneship/public"
+    #     staging:
+    #       dst: "ectype:sites/stoneship-staging/public"
+    #       options: [ "-glpPrtvz" ]
     #
-    # When running the deployer with the "default" resp. "staging"
+    # When running the deployer with the `default` resp. `staging`
     # configurations, the following rsync commands will be executed:
     #
-    #     rsync -glpPrtvz --exclude=".hg" --exclude=".svn"
-    #       --exclude=".git" output ectype:sites/stoneship/public
+    #   rsync -glpPrtvz --exclude=".hg" --exclude=".svn"
+    #     --exclude=".git" output ectype:sites/stoneship/public
     #
-    #     rsync -glpPrtvz output ectype:sites/stoneship-staging/public
+    #   rsync -glpPrtvz output ectype:sites/stoneship-staging/public
     def initialize
       # Get site
       error 'No site configuration found' unless File.file?('config.yaml')
@@ -61,11 +62,13 @@ module Nanoc3::Extra::Deployers
 
     # Runs the task. Possible params:
     #
-    # +:dry_run+:: Set to true when the action itself should not be executed,
-    #              but still printed. Useful for debugging.
+    # @option params [Boolean] :dry_run (false) True if the action itself
+    # should not be executed, but still printed; false otherwise.
     #
-    # +:config_name+:: The name of the deployment configuration to use.
-    #                  Defaults to +:default+ (surprise!).
+    # @option params [String] :config_name (:default) The name of the
+    # deployment configuration to use.
+    #
+    # @return [void]
     def run(params={})
       # Extract params
       config_name = params.has_key?(:config_name) ? params[:config_name].to_sym : :default

data/lib/nanoc3/extra/deployers.rb

@@ -2,7 +2,6 @@
 
 module Nanoc3::Extra
 
-  # Nanoc3::Extra::Deployers is the name for all deployers.
   module Deployers
 
     autoload 'Rsync', 'nanoc3/extra/deployers/rsync'

data/lib/nanoc3/extra/file_proxy.rb

@@ -2,37 +2,24 @@
 
 module Nanoc3::Extra
 
-  # A FileProxy is a proxy for a File object. It is used to prevent a File
-  # object from being created until it is actually necessary.
-  #
-  # For example, a site with a few thousand items would fail to compile
-  # because the massive amount of file descriptors necessary, but the file
-  # proxy will make sure the File object is not created until it is used.
+  # @deprecated Create a File instance directly and use that instead.
   class FileProxy
 
     instance_methods.each { |m| undef_method m unless m =~ /^__/ || m.to_s == 'object_id' }
 
     @@deprecation_warning_shown = false
 
-    # Creates a new file proxy for the given path. This is similar to
-    # creating a File object with the same path, except that the File object
-    # will not be created until it is accessed.
     def initialize(path)
       @path = path
     end
 
-    # Returns true if File instances respond to the given method; false if
-    # they do not.
     def respond_to?(meth)
       File.instance_methods.any? { |m| m == meth.to_s || m == meth.to_sym }
     end
 
-    # Makes sure all method calls are relayed to a File object, which will
-    # be created right before the method call takes place and destroyed
-    # right after.
     def method_missing(sym, *args, &block)
       if !@@deprecation_warning_shown
-        $stderr.puts 'WARNING: The :file attribute is deprecated and will be removed in a future version of nanoc. Instead of using this :file attribute, consider manually creating a File object when it’s needed, using the :content_filename or :meta_filename attributes (for filesystem_verbose and filesystem_compact) or :filename (for filesystem_combined).'
+        $stderr.puts 'WARNING: The :file attribute is deprecated and will be removed in a future version of nanoc. Instead of using this :file attribute, consider manually creating a File object when it’s needed, using the :content_filename, :meta_filename or :filename attributes.'
         @@deprecation_warning_shown = true
       end