nanoc2 2.2.3

data/lib/nanoc2/cli/logger.rb

@@ -0,0 +1,72 @@
+require 'singleton'
+
+module Nanoc2::CLI
+
+  # Nanoc2::CLI::Logger is a singleton class responsible for generating
+  # feedback in the terminal.
+  class Logger
+
+    ACTION_COLORS = {
+      :create         => "\e[1m" + "\e[32m", # bold + green
+      :update         => "\e[1m" + "\e[33m", # bold + yellow
+      :identical      => "\e[1m",            # bold
+      :skip           => "\e[1m",            # bold
+      :'not written'  => "\e[1m"             # bold
+    }
+
+    include Singleton
+
+    # The log level, which can be :high, :low or :off (which will log all
+    # messages, only high-priority messages, or no messages at all,
+    # respectively).
+    attr_accessor :level
+
+    # Whether to use color in log messages or not
+    attr_accessor :color
+    alias_method :color?, :color
+
+    def initialize # :nodoc:
+      @level = :high
+      @color = true
+    end
+
+    # Logs a file-related action.
+    #
+    # +level+:: The importance of this action. Can be :high or :low.
+    #
+    # +action+:: The kind of file action. Can be :create, :update or
+    #            :identical.
+    #
+    # +path+:: The path to the file the action was performed on.
+    def file(level, action, path, duration=nil)
+      log(
+        level,
+        '%s%12s%s  %s%s' % [
+          color? ? ACTION_COLORS[action.to_sym] : '',
+          action,
+          color? ? "\e[0m" : '',
+          duration.nil? ? '' : "[%2.2fs]  " % [ duration ],
+          path
+        ]
+      )
+    end
+
+    # Logs a message.
+    #
+    # +level+:: The importance of this message. Can be :high or :low.
+    #
+    # +s+:: The message to be logged.
+    #
+    # +io+:: The IO instance to which the message will be written. Defaults to
+    #        standard output.
+    def log(level, s, io=$stdout)
+      # Don't log when logging is disabled
+      return if @level == :off
+
+      # Log when level permits it
+      io.puts(s) if (@level == :low or @level == level)
+    end
+
+  end
+
+end

data/lib/nanoc2/data_sources.rb

@@ -0,0 +1,2 @@
+require 'nanoc2/data_sources/filesystem'
+require 'nanoc2/data_sources/filesystem_combined'

data/lib/nanoc2/data_sources/filesystem.rb

@@ -0,0 +1,707 @@
+module Nanoc2::DataSources
+
+  # The filesystem data source is the default data source for a new nanoc
+  # site. It stores all data as files on the hard disk.
+  #
+  # None of the methods are documented in this file. See Nanoc2::DataSource for
+  # documentation on the overridden methods instead.
+  #
+  # = Pages
+  #
+  # The filesystem data source stores its pages in nested directories. Each
+  # directory represents a single page. The root directory is the 'content'
+  # directory.
+  #
+  # Every directory has a content file and a meta file. The content file
+  # contains the actual page content, while the meta file contains the page's
+  # metadata, formatted as YAML.
+  #
+  # Both content files and meta files are named after its parent directory
+  # (i.e. page). For example, a page named 'foo' will have a directorynamed
+  # 'foo', with e.g. a 'foo.markdown' content file and a 'foo.yaml' meta file.
+  #
+  # Content file extensions are not used for determining the filter that
+  # should be run; the meta file defines the list of filters. The meta file
+  # extension must always be 'yaml', though.
+  #
+  # Content files can also have the 'index' basename. Similarly, meta files
+  # can have the 'meta' basename. For example, a parent directory named 'foo'
+  # can have an 'index.txt' content file and a 'meta.yaml' meta file. This is
+  # to preserve backward compatibility.
+  #
+  # = Page defaults
+  #
+  # The page defaults are loaded from a YAML-formatted file named
+  # 'page_defaults.yaml' at the top level of the nanoc site directory. For
+  # backward compatibility, the file can also be named 'meta.yaml'.
+  #
+  # = Assets
+  #
+  # Assets are stored in the 'assets' directory (surprise!). The structure is
+  # very similar to the structure of the 'content' directory, so see the Pages
+  # section for details on how this directory is structured.
+  #
+  # = Asset defaults
+  #
+  # The asset defaults are stored similar to the way page defaults are stored,
+  # except that the asset defaults file is named 'asset_defaults.yaml'
+  # instead.
+  #
+  # = Layouts
+  #
+  # Layouts are stored as directories in the 'layouts' directory. Each layout
+  # contains a content file and a meta file. The content file contain the
+  # actual layout, and the meta file describes how the page should be handled
+  # (contains the filter that should be used).
+  #
+  # For backward compatibility, a layout can also be a single file in the
+  # 'layouts' directory. Such a layout cannot have any metadata; the filter
+  # used for this layout is determined from the file extension.
+  #
+  # = Templates
+  #
+  # Templates are located in the 'templates' directroy. Every template is a
+  # directory consisting of a content file and a meta file, both named after
+  # the template. This is very similar to the way pages are stored, except
+  # that templates cannot be nested.
+  #
+  # = Code
+  #
+  # Code is stored in '.rb' files in the 'lib' directory. Code can reside in
+  # sub-directories.
+  class Filesystem < Nanoc2::DataSource
+
+    PAGE_DEFAULTS_FILENAME     = 'page_defaults.yaml'
+    PAGE_DEFAULTS_FILENAME_OLD = 'meta.yaml'
+    ASSET_DEFAULTS_FILENAME    = 'asset_defaults.yaml'
+
+    ########## Attributes ##########
+
+    identifier :filesystem
+
+    ########## VCSes ##########
+
+    attr_accessor :vcs
+
+    def vcs
+      @vcs ||= Nanoc2::Extra::VCSes::Dummy.new
+    end
+
+    ########## Preparation ##########
+
+    def up # :nodoc:
+    end
+
+    def down # :nodoc:
+    end
+
+    def setup # :nodoc:
+      # Create directories
+      %w( assets content templates layouts lib ).each do |dir|
+        FileUtils.mkdir_p(dir)
+        vcs.add(dir)
+      end
+    end
+
+    def destroy # :nodoc:
+      # Remove files
+      vcs.remove(ASSET_DEFAULTS_FILENAME)    if File.file?(ASSET_DEFAULTS_FILENAME)
+      vcs.remove(PAGE_DEFAULTS_FILENAME)     if File.file?(PAGE_DEFAULTS_FILENAME)
+      vcs.remove(PAGE_DEFAULTS_FILENAME_OLD) if File.file?(PAGE_DEFAULTS_FILENAME_OLD)
+
+      # Remove directories
+      vcs.remove('assets')
+      vcs.remove('content')
+      vcs.remove('templates')
+      vcs.remove('layouts')
+      vcs.remove('lib')
+    end
+
+    def update # :nodoc:
+      update_page_defaults
+      update_pages
+      update_templates
+    end
+
+    ########## Pages ##########
+
+    def pages # :nodoc:
+      meta_filenames('content').map do |meta_filename|
+        # Read metadata
+        meta = YAML.load_file(meta_filename) || {}
+
+        if meta['is_draft']
+          # Skip drafts
+          nil
+        else
+          # Get content
+          content_filename = content_filename_for_dir(File.dirname(meta_filename))
+          content = File.read(content_filename)
+
+          # Get attributes
+          attributes = meta.merge(:file => Nanoc2::Extra::FileProxy.new(content_filename))
+
+          # Get path
+          path = meta_filename.sub(/^content/, '').sub(/[^\/]+\.yaml$/, '')
+
+          # Get modification times
+          meta_mtime    = File.stat(meta_filename).mtime
+          content_mtime = File.stat(content_filename).mtime
+          mtime         = meta_mtime > content_mtime ? meta_mtime : content_mtime
+
+          # Create page object
+          Nanoc2::Page.new(content, attributes, path, mtime)
+        end
+      end.compact
+    end
+
+    def save_page(page) # :nodoc:
+      # Determine possible meta file paths
+      last_component = page.path.split('/')[-1]
+      meta_filename_worst = 'content' + page.path + 'index.yaml'
+      meta_filename_best  = 'content' + page.path + (last_component || 'content') + '.yaml'
+
+      # Get existing path
+      existing_path = nil
+      existing_path = meta_filename_best  if File.file?(meta_filename_best)
+      existing_path = meta_filename_worst if File.file?(meta_filename_worst)
+
+      if existing_path.nil?
+        # Get filenames
+        dir_path         = 'content' + page.path
+        meta_filename    = meta_filename_best
+        content_filename = 'content' + page.path + (last_component || 'content') + '.html'
+
+        # Notify
+        Nanoc2::NotificationCenter.post(:file_created, meta_filename)
+        Nanoc2::NotificationCenter.post(:file_created, content_filename)
+
+        # Create directories if necessary
+        FileUtils.mkdir_p(dir_path)
+      else
+        # Get filenames
+        meta_filename    = existing_path
+        content_filename = content_filename_for_dir(File.dirname(existing_path))
+
+        # Notify
+        Nanoc2::NotificationCenter.post(:file_updated, meta_filename)
+        Nanoc2::NotificationCenter.post(:file_updated, content_filename)
+      end
+
+      # Write files
+      File.open(meta_filename,    'w') { |io| io.write(page.attributes.to_split_yaml) }
+      File.open(content_filename, 'w') { |io| io.write(page.content) }
+
+      # Add to working copy if possible
+      if existing_path.nil?
+        vcs.add(meta_filename)
+        vcs.add(content_filename)
+      end
+    end
+
+    def move_page(page, new_path) # :nodoc:
+      # TODO implement
+    end
+
+    def delete_page(page) # :nodoc:
+      # TODO implement
+    end
+
+    ########## Assets ##########
+
+    def assets # :nodoc:
+      meta_filenames('assets').map do |meta_filename|
+        # Read metadata
+        meta = YAML.load_file(meta_filename) || {}
+
+        # Get content file
+        content_filename = content_filename_for_dir(File.dirname(meta_filename))
+        content_file = Nanoc2::Extra::FileProxy.new(content_filename)
+
+        # Get attributes
+        attributes = { 'extension' => File.extname(content_filename)[1..-1] }.merge(meta)
+
+        # Get path
+        path = meta_filename.sub(/^assets/, '').sub(/[^\/]+\.yaml$/, '')
+
+        # Get modification times
+        meta_mtime    = File.stat(meta_filename).mtime
+        content_mtime = File.stat(content_filename).mtime
+        mtime         = meta_mtime > content_mtime ? meta_mtime : content_mtime
+
+        # Create asset object
+        Nanoc2::Asset.new(content_file, attributes, path, mtime)
+      end
+    end
+
+    def save_asset(asset) # :nodoc:
+      # Determine meta file path
+      last_component = asset.path.split('/')[-1]
+      meta_filename  = 'assets' + asset.path + last_component + '.yaml'
+
+      # Get existing path
+      existing_path = nil
+      existing_path = meta_filename_best  if File.file?(meta_filename_best)
+      existing_path = meta_filename_worst if File.file?(meta_filename_worst)
+
+      if meta_filename.nil?
+        # Get filenames
+        dir_path         = 'assets' + asset.path
+        content_filename = 'assets' + asset.path + last_component + '.dat'
+
+        # Notify
+        Nanoc2::NotificationCenter.post(:file_created, meta_filename)
+        Nanoc2::NotificationCenter.post(:file_created, content_filename)
+
+        # Create directories if necessary
+        FileUtils.mkdir_p(dir_path)
+      else
+        # Get filenames
+        content_filename = content_filename_for_dir(File.dirname(meta_filename))
+
+        # Notify
+        Nanoc2::NotificationCenter.post(:file_updated, meta_filename)
+        Nanoc2::NotificationCenter.post(:file_updated, content_filename)
+      end
+
+      # Write files
+      File.open(meta_filename,    'w') { |io| io.write(asset.attributes.to_split_yaml) }
+      File.open(content_filename, 'w') { }
+
+      # Add to working copy if possible
+      if meta_filename.nil?
+        vcs.add(meta_filename)
+        vcs.add(content_filename)
+      end
+    end
+
+    def move_asset(asset, new_path) # :nodoc:
+      # TODO implement
+    end
+
+    def delete_asset(asset) # :nodoc:
+      # TODO implement
+    end
+
+    ########## Page Defaults ##########
+
+    def page_defaults # :nodoc:
+      # Get attributes
+      filename = File.file?(PAGE_DEFAULTS_FILENAME) ? PAGE_DEFAULTS_FILENAME : PAGE_DEFAULTS_FILENAME_OLD
+      attributes = YAML.load_file(filename) || {}
+
+      # Get mtime
+      mtime = File.stat(filename).mtime
+
+      # Build page defaults
+      Nanoc2::PageDefaults.new(attributes, mtime)
+    end
+
+    def save_page_defaults(page_defaults) # :nodoc:
+      # Notify
+      if File.file?(PAGE_DEFAULTS_FILENAME)
+        filename = PAGE_DEFAULTS_FILENAME
+        created  = false
+        Nanoc2::NotificationCenter.post(:file_updated, filename)
+      elsif File.file?(PAGE_DEFAULTS_FILENAME_OLD)
+        filename = PAGE_DEFAULTS_FILENAME_OLD
+        created  = false
+        Nanoc2::NotificationCenter.post(:file_updated, filename)
+      else
+        filename = PAGE_DEFAULTS_FILENAME
+        created  = true
+        Nanoc2::NotificationCenter.post(:file_created, filename)
+      end
+
+      # Write
+      File.open(filename, 'w') do |io|
+        io.write(page_defaults.attributes.to_split_yaml)
+      end
+
+      # Add to working copy if possible
+      vcs.add(filename) if created
+    end
+
+    ########## Asset Defaults ##########
+
+    def asset_defaults # :nodoc:
+      if File.file?(ASSET_DEFAULTS_FILENAME)
+        # Get attributes
+        attributes = YAML.load_file(ASSET_DEFAULTS_FILENAME) || {}
+
+        # Get mtime
+        mtime = File.stat(ASSET_DEFAULTS_FILENAME).mtime
+
+        # Build asset defaults
+        Nanoc2::AssetDefaults.new(attributes, mtime)
+      else
+        Nanoc2::AssetDefaults.new({})
+      end
+    end
+
+    def save_asset_defaults(asset_defaults) # :nodoc:
+      # Notify
+      if File.file?(ASSET_DEFAULTS_FILENAME)
+        Nanoc2::NotificationCenter.post(:file_updated, ASSET_DEFAULTS_FILENAME)
+        created  = false
+      else
+        Nanoc2::NotificationCenter.post(:file_created, ASSET_DEFAULTS_FILENAME)
+        created  = true
+      end
+
+      # Write
+      File.open(ASSET_DEFAULTS_FILENAME, 'w') do |io|
+        io.write(asset_defaults.attributes.to_split_yaml)
+      end
+
+      # Add to working copy if possible
+      vcs.add(ASSET_DEFAULTS_FILENAME) if created
+    end
+
+    ########## Layouts ##########
+
+    def layouts # :nodoc:
+      # Determine what layout directory structure is being used
+      is_old_school = (Dir['layouts/*'].select { |f| File.file?(f) }.size > 0)
+
+      if is_old_school
+        # Warn about deprecation
+        warn(
+          'DEPRECATION WARNING: nanoc 2.1 changes the way layouts are ' +
+          'stored. Future versions will not support these outdated sites. ' +
+          'To update your site, issue \'nanoc update\'.'
+        )
+
+        Dir[File.join('layouts', '*')].reject { |f| f =~ /~$/ }.map do |filename|
+          # Get content
+          content = File.read(filename)
+
+          # Get attributes
+          attributes = { :extension => File.extname(filename)}
+
+          # Get path
+          path = File.basename(filename, attributes[:extension])
+
+          # Get modification time
+          mtime = File.stat(filename).mtime
+
+          # Create layout object
+          Nanoc2::Layout.new(content, attributes, path, mtime)
+        end
+      else
+        meta_filenames('layouts').map do |meta_filename|
+          # Get content
+          content_filename  = content_filename_for_dir(File.dirname(meta_filename))
+          content           = File.read(content_filename)
+
+          # Get attributes
+          attributes = YAML.load_file(meta_filename) || {}
+
+          # Get path
+          path = meta_filename.sub(/^layouts\//, '').sub(/\/[^\/]+\.yaml$/, '')
+
+          # Get modification times
+          meta_mtime    = File.stat(meta_filename).mtime
+          content_mtime = File.stat(content_filename).mtime
+          mtime         = meta_mtime > content_mtime ? meta_mtime : content_mtime
+
+          # Create layout object
+          Nanoc2::Layout.new(content, attributes, path, mtime)
+        end
+      end
+    end
+
+    def save_layout(layout) # :nodoc:
+      # Determine what layout directory structure is being used
+      is_old_school = (Dir['layouts/*'].select { |f| File.file?(f) }.size > 0)
+      error_outdated if is_old_school
+
+      # Get paths
+      last_component    = layout.path.split('/')[-1]
+      dir_path          = 'layouts' + layout.path
+      meta_filename     = dir_path + last_component + '.yaml'
+      content_filename  = Dir[dir_path + last_component + '.*'][0]
+
+      if File.file?(meta_filename)
+        created = false
+
+        # Notify
+        Nanoc2::NotificationCenter.post(:file_updated, meta_filename)
+        Nanoc2::NotificationCenter.post(:file_updated, content_filename)
+      else
+        created = true
+
+        # Create dir
+        FileUtils.mkdir_p(dir_path)
+
+        # Get content filename
+        content_filename = dir_path + last_component + '.html'
+
+        # Notify
+        Nanoc2::NotificationCenter.post(:file_created, meta_filename)
+        Nanoc2::NotificationCenter.post(:file_created, content_filename)
+      end
+
+      # Write files
+      File.open(meta_filename,    'w') { |io| io.write(layout.attributes.to_split_yaml) }
+      File.open(content_filename, 'w') { |io| io.write(layout.content) }
+
+      # Add to working copy if possible
+      if created
+        vcs.add(meta_filename)
+        vcs.add(content_filename)
+      end
+    end
+
+    def move_layout(layout, new_path) # :nodoc:
+      # TODO implement
+    end
+
+    def delete_layout(layout) # :nodoc:
+      # TODO implement
+    end
+
+    ########## Templates ##########
+
+    def templates # :nodoc:
+      meta_filenames('templates').map do |meta_filename|
+        # Get name
+        name = meta_filename.sub(/^templates\/(.*)\/[^\/]+\.yaml$/, '\1')
+
+        # Get content
+        content_filename  = content_filename_for_dir(File.dirname(meta_filename))
+        content           = File.read(content_filename)
+
+        # Get attributes
+        attributes = YAML.load_file(meta_filename) || {}
+
+        # Build template
+        Nanoc2::Template.new(content, attributes, name)
+      end
+    end
+
+    def save_template(template) # :nodoc:
+      # Determine possible meta file paths
+      meta_filename_worst = 'templates/' + template.name + '/index.yaml'
+      meta_filename_best  = 'templates/' + template.name + '/' + template.name + '.yaml'
+
+      # Get existing path
+      existing_path = nil
+      existing_path = meta_filename_best  if File.file?(meta_filename_best)
+      existing_path = meta_filename_worst if File.file?(meta_filename_worst)
+
+      if existing_path.nil?
+        # Get filenames
+        dir_path         = 'templates/' + template.name
+        meta_filename    = meta_filename_best
+        content_filename = 'templates/' + template.name + '/' + template.name + '.html'
+
+        # Notify
+        Nanoc2::NotificationCenter.post(:file_created, meta_filename)
+        Nanoc2::NotificationCenter.post(:file_created, content_filename)
+
+        # Create directories if necessary
+        FileUtils.mkdir_p(dir_path)
+      else
+        # Get filenames
+        meta_filename    = existing_path
+        content_filename = content_filename_for_dir(File.dirname(existing_path))
+
+        # Notify
+        Nanoc2::NotificationCenter.post(:file_updated, meta_filename)
+        Nanoc2::NotificationCenter.post(:file_updated, content_filename)
+      end
+
+      # Write files
+      File.open(meta_filename,    'w') { |io| io.write(template.page_attributes.to_split_yaml) }
+      File.open(content_filename, 'w') { |io| io.write(template.page_content) }
+
+      # Add to working copy if possible
+      if existing_path.nil?
+        vcs.add(meta_filename)
+        vcs.add(content_filename)
+      end
+    end
+
+    def move_template(template, new_name) # :nodoc:
+      # TODO implement
+    end
+
+    def delete_template(template) # :nodoc:
+      # TODO implement
+    end
+
+    ########## Code ##########
+
+    def code # :nodoc:
+      # Get files
+      filenames = Dir['lib/**/*.rb'].sort
+
+      # Get data
+      data = filenames.map { |filename| File.read(filename) + "\n" }.join('')
+
+      # Get modification time
+      mtimes = filenames.map { |filename| File.stat(filename).mtime }
+      mtime = mtimes.inject { |memo, mtime| memo > mtime ? mtime : memo }
+
+      # Build code
+      Nanoc2::Code.new(data, mtime)
+    end
+
+    def save_code(code) # :nodoc:
+      # Check whether code existed
+      existed = File.file?('lib/default.rb')
+
+      # Remove all existing code files
+      Dir['lib/**/*.rb'].each do |file|
+        vcs.remove(file) unless file == 'lib/default.rb'
+      end
+
+      # Notify
+      if existed
+        Nanoc2::NotificationCenter.post(:file_updated, 'lib/default.rb')
+      else
+        Nanoc2::NotificationCenter.post(:file_created, 'lib/default.rb')
+      end
+
+      # Write new code
+      File.open('lib/default.rb', 'w') do |io|
+        io.write(code.data)
+      end
+
+      # Add to working copy if possible
+      vcs.add('lib/default.rb') unless existed
+    end
+
+  private
+
+    ########## Custom functions ##########
+
+    # Returns the list of all meta files in the given base directory as well
+    # as its subdirectories.
+    def meta_filenames(base)
+      # Find all possible meta file names
+      filenames = Dir[base + '/**/*.yaml']
+
+      # Filter out invalid meta files
+      good_filenames = []
+      bad_filenames  = []
+      filenames.each do |filename|
+        if filename =~ /meta\.yaml$/ or filename =~ /([^\/]+)\/\1\.yaml$/
+          good_filenames << filename
+        else
+          bad_filenames << filename
+        end
+      end
+
+      # Warn about bad filenames
+      unless bad_filenames.empty?
+        raise RuntimeError.new(
+          "The following files appear to be meta files, " +
+          "but have an invalid name:\n  - " +
+          bad_filenames.join("\n  - ")
+        )
+      end
+
+      good_filenames
+    end
+
+    # Returns the filename of the content file in the given directory,
+    # ignoring any unwanted files (files that end with '~', '.orig', '.rej' or
+    # '.bak')
+    def content_filename_for_dir(dir)
+      # Find all files
+      filename_glob_1 = dir.sub(/([^\/]+)$/, '\1/\1.*')
+      filename_glob_2 = dir.sub(/([^\/]+)$/, '\1/index.*')
+      filenames = (Dir[filename_glob_1] + Dir[filename_glob_2]).uniq
+
+      # Reject meta files
+      filenames.reject! { |f| f =~ /\.yaml$/ }
+
+      # Reject backups
+      filenames.reject! { |f| f =~ /(~|\.orig|\.rej|\.bak)$/ }
+
+      # Make sure there is only one content file
+      if filenames.size != 1
+        raise RuntimeError.new(
+          "Expected 1 content file in #{dir} but found #{filenames.size}"
+        )
+      end
+
+      # Return content filename
+      filenames.first
+    end
+
+    # Raises an "outdated data format" error.
+    def error_outdated
+      raise RuntimeError.new(
+        'This site\'s data is stored in an old format and must be updated. ' +
+        'To do so, issue the \'nanoc update\' command. For help on ' +
+        'updating a site\'s data, issue \'nanoc help update\'.'
+      )
+    end
+
+    # Updated outdated page defaults (renames page defaults file)
+    def update_page_defaults
+      return unless File.file?(PAGE_DEFAULTS_FILENAME_OLD)
+
+      vcs.move(PAGE_DEFAULTS_FILENAME_OLD, PAGE_DEFAULTS_FILENAME)
+    end
+
+    # Updates outdated pages (both content and meta file names).
+    def update_pages
+      # Update content files
+      # content/foo/bar/baz/index.ext -> content/foo/bar/baz/baz.ext
+      Dir['content/**/index.*'].select { |f| File.file?(f) }.each do |old_filename|
+        # Determine new name
+        if old_filename =~ /^content\/index\./
+          new_filename = old_filename.sub(/^content\/index\./, 'content/content.')
+        else
+          new_filename = old_filename.sub(/([^\/]+)\/index\.([^\/]+)$/, '\1/\1.\2')
+        end
+
+        # Move
+        vcs.move(old_filename, new_filename)
+      end
+
+      # Update meta files
+      # content/foo/bar/baz/meta.yaml -> content/foo/bar/baz/baz.yaml
+      Dir['content/**/meta.yaml'].select { |f| File.file?(f) }.each do |old_filename|
+        # Determine new name
+        if old_filename == 'content/meta.yaml'
+          new_filename = 'content/content.yaml'
+        else
+          new_filename = old_filename.sub(/([^\/]+)\/meta.yaml$/, '\1/\1.yaml')
+        end
+
+        # Move
+        vcs.move(old_filename, new_filename)
+      end
+    end
+
+    # Updates outdated templates (both content and meta file names).
+    def update_templates
+      # Update content files
+      # templates/foo/index.ext -> templates/foo/foo.ext
+      Dir['templates/**/index.*'].select { |f| File.file?(f) }.each do |old_filename|
+        # Determine new name
+        new_filename = old_filename.sub(/([^\/]+)\/index\.([^\/]+)$/, '\1/\1.\2')
+
+        # Move
+        vcs.move(old_filename, new_filename)
+      end
+
+      # Update meta files
+      # templates/foo/meta.yaml -> templates/foo/foo.yaml
+      Dir['templates/**/meta.yaml'].select { |f| File.file?(f) }.each do |old_filename|
+        # Determine new name
+        new_filename = old_filename.sub(/([^\/]+)\/meta.yaml$/, '\1/\1.yaml')
+
+        # Move
+        vcs.move(old_filename, new_filename)
+      end
+    end
+
+  end
+
+end