Fetching contributors…
Cannot retrieve contributors at this time
665 lines (464 sloc) 23.7 KB

nanoc news

3.6.3 (???)


  • Added support for growlnotify on Windows (#253, #267)
  • Fixed bug which caused the external links checker to ignore the query string (#279, #297)
  • Removed weird treatment of DOCTYPEs in the relativize_paths filter (#296)
  • Fixed CodeRay syntax coloring on Ruby 2.0
  • Silenced "Could not find files for the given pattern(s)" message on Windows (#298)
  • Fixed issue which could cause output.diff not to be generated correctly (#255, #301)
  • Let filesystem and static data sources follow symlinks (#299, #302)

3.6.2 (2013-03-23)


  • Removed the list of available deployers from the deploy help text and moved them into a new --list-deployers option [Damien Pollet]
  • Fixed warning about __send__and object_id being redefined on Ruby 1.8.x [Justin Hileman]


  • Added possible alternative names for the Checks file for consistency with the Rules file: Checks.rb, checks, checks.rb [Damien Pollet]
  • Made sure unchanged files never have their mtime updated [Justin Hileman]
  • Made link checker retry 405 Method Not Allowed results with GET instead of HEAD [Daniel Hofstetter]

3.6.1 (2013-02-25)


  • Fixed bug which could cause the Sass filter to raise a load error [Damien Pollet]
  • Fixed warnings about __send__ and object_id being redefined [Justin Hileman]
  • Made files_to_watch contain nanoc.yaml, not config.yaml by default

3.6 (2013-02-24)


  • Added sync command, allowing data sources to update local caches of external data [Justin Hileman]
  • Added #ignore compiler DSL method
  • Allowed accessing items by identifier using e.g. @items['/about/']
  • Added shell command


  • Renamed the nanoc configuration file from config.yaml to nanoc.yaml


  • Updated references to old web site and old repository
  • Made require errors mention Bundler if appropriate
  • Fixed bug which caused pruner not to delete directories in some cases [@reima]
  • Made check command exit with the proper exit status
  • Added support for the HTML_TOC Redcarpet renderer
  • Made stale check honor files excluded by the pruner

3.5 (2013-01-27)

Major changes:

  • Added checks

Minor changes:

  • Added #include_rules for modularising Rules files [Justin Hileman]
  • Replaced FSSM with Listen [Takashi Uchibe]
  • Made USR1 print stack trace (not on Windows)
  • Added ability to configure autocompiler host/port in config.yaml [Stuart Montgomery]
  • Added static data source
  • Added :rep_select parameter to XML sitemap to allow filtering reps
  • Removed use of bright/bold colors for compatibility with Solarized


  • Added support for parameters in Less filter [Ruben Verborgh]
  • Added support for icon and logo in Atom feed [Ruben Verborgh]


  • Made syntax colorizer only use the first non-empty line when extracting the language comment
  • Fixed XSL filter

3.4.3 (2012-12-09)


  • Item reps are now accessible in a consistent way: in Rules and during compilation, they can be accessed using both @rep and @item_rep


  • Made cleaning streams (stdout/stderr as used by nanoc) compatible with Ruby’s built-in Logger
  • Made prune work when the output directory is a symlink
  • Made Handlebars filter compatible with the latest version
  • Made show-data command show more accurate dependencies [Stefan Bühler]
  • Restored compatibility with Sass 3.2.2

3.4.2 (2012-11-01)


  • Made passthrough rules be inserted in the right place [Gregory Pakosz]
  • Fixed crashes in the progress indicator when compiling
  • Made auto-pruning honor excluded files [Greg Karékinian]
  • Made lack of which/where not crash watch command


  • Fixed constant reinitialization warnings [Damien Pollet]
  • Made UTF-8 not be decomposed when outputting to a file from a non-UTF-8 terminal
  • Made syntax colorizer wrap CodeRay output in required CodeRay divs
  • Made fog delete after upload, not before [Go Maeda]
  • Made requesting compiled content of binary item impossible

3.4.1 (2012-09-22)


  • Fixed auto-pruning
  • Made slim filter work with the capturing helper [Bil Bas]


  • Made several speed improvements
  • Added prune configuration to config.yaml
  • Made nanoc check for presence of nanoc in Gemfile
  • Made compile command not show identicals (use --verbose if you want them)
  • Made relativize_paths filter recognise more paths to relativize [Arnau Siches]
  • Fixed #passthrough for items without extensions [Justin Hileman]
  • Added more IO/File proxy methods to cleaning streams

3.4 (2012-06-09)

  • Improved error output and added crash log
  • Renamed debug and info commands to show-data and show-plugins, respectively
  • Added show-rules command (aka explain)


  • Added :yield key for Mustache filter
  • Added Handebars filter
  • Added Pandoc filter
  • Made the deployer use the default target if no target is specified
  • Converted HTML/CSS/link validation tasks to commands
  • Made link validator follow relative redirects

3.3.7 (2012-05-28)

  • Added filename to YAML parser errors
  • Fixed issue which caused extra dependencies to be generated
  • Made timing information take filtering helper into account

3.3.6 (2012-04-27)

  • Fixed issue with relative_link_to stripping HTML boilerplate

3.3.5 (2012-04-23)

  • Fixed issue with relative_link_to not working properly

3.3.4 (2012-04-23)

  • Fixed bug which caused the compilation stack to be empty
  • Restored Ruby 1.8 compatibility

3.3.3 (2012-04-11)

  • Fixed directed graph implementation on Rubinius
  • Made capturing helper not remember content between runs
  • Fixed Date#freeze issue on Ruby 1.8.x
  • Made it possible to have any kind of object as parameters in the Rules file
  • Fixed bug which caused changed routes not to cause a recompile

3.3.2 (2012-03-16)

  • Removed bin/nanoc3 (use nanoc3 gem if you want it)
  • Fixed wrong “no such snapshot” errors
  • Made deployer default to rsync for backwards compatibility
  • Fixed missing Nanoc::CLI in deployment tasks
  • Fixed “unrecognised kind” deployer error

3.3.1 (2012-02-18)

  • Fixed issue with long paths on Windows
  • Fixed a few deployer crashes
  • Added nanoc3.rb, nanoc3/tasks.rb, … for compatibility with older versions
  • Made nanoc setup Bundler at startup [John Nishinaga]

3.3 (2012-02-12)


  • Dropped the “3” suffix on nanoc3/Nanoc3
  • Turned Rake tasks into proper nanoc commands
  • Improved dependency tracking
  • Added support for locals in filters and layouts


  • Added support for deployment using Fog [Jack Chu]
  • Added CoffeeScript filter [Riley Goodside]
  • Added XSL filter [Arnau Siches]
  • Added YUICompress filter [Matt Keveney]
  • Added pygments.rb to supported syntax colorizers
  • Allowed syntax colorizer to colorize outside pre elements [Kevin Lynagh]
  • Added support for HTTPS link validation [Fabian Buch]
  • Added support for (automatically) pruning stray output files [Justin Hileman]
  • Added deploy command

3.2.4 (2012-01-09)

  • Fixed bug which would cause some reps not to be compiled when invoking nanoc programmatically
  • Made data source configuration location a bit more obvious
  • Fixed watch command under Windows
  • Made filesystem data source ignore UTF-8 BOM
  • Improved compatibility of colorize_syntax filter with older libxml versions

3.2.3 (2011-10-31)

  • Made syntax colorizer only strip trailing blank lines instead of all blanks
  • Improved Ruby 1.9.x compatibility
  • Made default rakefile require rubygems if necessary
  • Made filename/content argument of Nanoc3::Item#initialize mandatory

3.2.2 (2011-09-04)

  • Fixed command usage printing
  • Made relativize_paths filter handle Windows network paths [Ruben Verborgh]
  • Made watcher use correct configuration
  • Allowed code blocks to start with a non-language shebang line

3.2.1 (2011-07-27)

  • Made @config available in rules file
  • Fixed #readpartial issue on JRuby [Matt Keveney]
  • Fixed possible @cache name clash in memoization module
  • Fixed options with required arguments (such as --port and --host)
  • Fixed broken #check_availability
  • Fixed error handling in watch command

3.2 (2011-07-24)


  • Sped up nanoc quite a bit
  • Added progress indicator for long-running filters
  • Made all source data, such as item attributes, frozen during compilation
  • Added --color option to force color on
  • Cleaned up internals, deprecating several parts and/or marking them as private in the progress
  • Allowed custom commands in commands/


  • Added AsciiDoc filter
  • Added Redcarpet filter [Peter Aronoff]
  • Added Slim filter [Zaiste de Grengolada]
  • Added Typogruby filter
  • Added UglifyJS filter [Justin Hileman]
  • Added :items parameter for the XML site map [Justin Hileman]
  • Added support for params to ERB
  • Added :default_colorizer parameter to the :colorize_syntax filter
  • Allowed for passing arbitrary options to pygmentize [Matthias Vallentin]
  • Exposed RedCloth parameters in the filter [Vincent Driessen]

3.1.9 (2011-06-30)

  • Really fixed dependency generation between Sass partials this time
  • Updated Less filter to 2.0
  • Made colorize_syntax filter throw an error if pygmentize is not available

3.1.8 (2011-06-25)

  • Made link validator accept https: URLs
  • Fixed erroneous handling of layouts with names ending in index
  • Fixed dependency generation between Sass partials
  • Fixed errors related to thread requires
  • Fixed crash while handling load errors
  • Improved encoding handling while reading files

3.1.7 (2011-05-03)

  • Restored compatibility with Sass 3.1

3.1.6 (2010-11-21)

  • Fixed issues with incompatible encodings

3.1.5 (2010-08-24)

  • Improved #render documentation
  • Improved metadata section check so that e.g. raw diffs are handled properly
  • Deprecated using Nanoc3::Site#initialize with a non-"." argument
  • Added Ruby engine to version string
  • Allowed the created_at and updated_at attributes used in the Blogging helper to be Date instances

3.1.4 (2010-07-25)

  • Made INT and TERM signals always quit the CLI
  • Allowed relative imports in LESS
  • Made sure modification times are unchanged for identical recompiled items
  • Improved link validator error handling
  • Made pygmentize not output extra divs and pres
  • Allowed colorizers to be specified using symbols instead of strings
  • Added scss to the default list of text extensions

3.1.3 (2010-04-25)

  • Removed annoying win32console warning [Eric Sunshine]
  • Removed color codes when not writing to a terminal, or when writing to Windows’ console when win32console is not installed [Eric Sunshine]
  • Added .xhtml and .xml to list of text extensions
  • Improved support for relative Sass @imports [Chris Eppstein]

3.1.2 (2010-04-07)

  • Fixed bug which could cause incorrect output when compilation of an item is delayed due to an unmet dependency

3.1.1 (2010-04-05)

  • Sass @imports now work for files not managed by nanoc
  • Rake tasks now have their Unicode description decomposed if necessary

3.1 (2010-04-03)


  • An Item#rep_named(name) function for quickly getting a certain rep
  • An Item#compiled_content function for quickly getting compiled content
  • An Item#path function for quickly getting the path of an item rep
  • A new “+” wildcard in rule patterns that matches one or more characters
  • A view command that starts a web server in the output directory
  • A debug command that shows information about the items, reps and layouts
  • A kramdown filter (kramdown site)
  • A diff between the previously compiled content and the last compiled content is now written to output.diff if the enable_output_diff site configuration attribute is true
  • Assigns, such as @items, @layouts, @item, … are accessible without @
  • Support for binary items


  • New sites now come with a stylesheet item instead of a style.css file in the output directory
  • The deploy:rsync task now use sensible default options
  • The deploy:rsync task now accepts a config environment variable
  • The deploy:rsync task now uses a lowercase dry_run environment variable
  • The maruku filter now accepts parameters
  • The rainpress filter now accepts parameters
  • The filesystem data source is now known as filesystem_verbose
  • Meta files and content files are now optional
  • The filesystem_compact and filesystem_combined data sources have been merged into a new filesystem_unified data source
  • The metadata section in filesystem_unified is now optional [Christopher Eppstein]
  • The --server autocompile option is now known as --handler
  • Assigns in filters are now available as instance variables and methods
  • The #breadcrumbs_trail function now allows missing parents
  • The sass filter now properly handles @import dependencies


  • Nanoc3::FileProxy; use one of the filename attributes instead
  • ItemRep#content_at_snapshot; use #compiled_content instead
  • The last_fm, delicious and twitter data sources; fetch online content into a cache by a rake task and load data from this cache instead

3.0.9 (2010-02-24)

  • Fixed 1.8.x parsing bug due to lack of parens which could cause “undefined method to_iso8601_time for #String:0x…” errors

3.0.8 (2010-02-24)

  • #atom_tag_for now works with base_urls that contain a path [Eric Sunshine]
  • Generated root URLs in #atom_feed now end with a slash [Eric Sunshine]
  • Autocompiler now recognises requests to index files
  • Blogging helper now allows created_at to be a Time instance

3.0.7 (2010-01-29)

  • Fixed bug which could cause layout rules not be matched in order

3.0.6 (2010-01-17)

  • Error checking in filesystem_combined has been improved [Brian Candler]
  • Generated HTML files now have a default encoding of UTF-8
  • Periods in identifiers for layouts now behave correctly
  • The relativize_paths filter now correctly handles “/” [Eric Sunshine]

3.0.5 (2010-01-12)

  • Restored pre-3.0.3 behaviour of periods in identifiers. By default, a file can have multiple extensions (e.g. content/foo.html.erb will have the identifier /foo/), but if allow_periods_in_identifiers in the site configuration is true, a file can have only one extension (e.g. content/blog/stuff.entry.html will have the identifier /blog/stuff.entry/).

3.0.4 (2010-01-07)

  • Fixed a bug which would cause the filesystem_compact data source to incorrectly determine the content filename, leading to weird “Expected 1 content file but found 3” errors [Eric Sunshine]

3.0.3 (2010-01-06)

  • The Blogging helper now properly handles item reps without paths
  • The relativize_paths filter now only operates inside tags
  • The autocompiler now handles escaped paths
  • The LinkTo and Tagging helpers now output escaped HTML
  • Fixed played_at attribute assignment in the LastFM data source for tracks playing now, and added a now_playing attribute [Nicky Peeters]
  • The filesystem_* data sources can now handle dots in identifiers
  • Required enumerator to make sure #enum_with_index always works
  • Array#stringify_keys now properly recurses

3.0.2 (2009-11-07)

  • Children-only identifier patterns no longer erroneously also match parent (e.g./foo/*/ no longer matches /foo/)
  • The create_site command no longer uses those ugly HTML entities
  • Install message now mentions the IRC channel

3.0.1 (2009-10-05)

  • The proper exception is now raised when no matching compilation rules can be found
  • The autocompile command no longer has a duplicate --port option
  • The #url_for and #feed_url methods now check the presence of the base_url site configuration attribute
  • Several outdated URLs are now up-to-date
  • Error handling has been improved in general

3.0 (2009-08-14)


  • Multiple data sources
  • Dependency tracking between items
  • Filters can now optionally take arguments
  • #create_page and #create_layout methods in data sources
  • A new way to specify compilation/routing rules using a Rules file
  • A coderay filter (CodeRay site)
  • A filesystem_compact data source which uses less directories


  • Pages and textual assets are now known as “items”


  • Support for drafts
  • Support for binary assets
  • Support for templates
  • Everything that was deprecated in nanoc 2.x
  • save_*, move_* and delete_* methods in data sources
  • Processing instructions in metadata

2.2.2 (2009-05-18)

  • Removed relativize_paths filter; use relativize_paths_in_html or relativize_paths_in_css instead
  • Fixed bug which could cause nanoc to eat massive amounts of memory when an exception occurs
  • Fixed bug which would cause nanoc to complain about the open file limit being reached when using a large amount of assets

2.2.1 (2009-04-08)

  • Fixed bug which prevented relative_path_to from working
  • Split relativize_paths filter into two filter: relativize_paths_in_html and relativize_paths_in_css
  • Removed bundled mime-types library

2.2 (2009-04-06)


  • --pages and --assets compiler options
  • --no-color commandline option
  • Filtering helper
  • #relative_path_to function in LinkTo helper
  • rainpress filter (Rainpress site)
  • relativize_paths filter
  • The current layout is now accessible through the @layout variable
  • Much more informative stack traces when something goes wrong


  • The commandline option parser is now a lot more reliable
  • #atom_feed now takes optional :content_proc, :excerpt_proc and :articles parameters
  • The compile command show non-written items (those with skip_output: true)
  • The compile command compiles everything by default
  • Added --only-outdated option to compile only outdated pages


  • deprecated extension-based code

2.1.6 (2009-02-28)

  • The filesystem_combined data source now supports empty metadata sections
  • The rdoc filter now works for both RDoc 1.x and 2.x
  • The autocompiler now serves a 500 when an exception occurs outside compilation
  • The autocompiler no longer serves index files when the request path does not end with a slash
  • The autocompiler now always serves asset content correctly

2.1.5 (2009-02-01)

  • Added Ruby 1.9 compatibility
  • The filesystem and filesystem_combined data sources now preserve custom extensions

2.1.4 (2008-11-15)

  • Fixed an issue where the autocompiler in Windows would serve broken assets

2.1.3 (2008-09-27)

  • The haml and sass filters now correctly take their options from assets
  • The autocompiler now serves index files instead of 404s
  • Layouts named “index” are now handled correctly
  • The filesystem_combined data source now properly handles assets

2.1.2 (2008-09-08)

  • The utocompiler now compiles assets as well
  • The sass filter now takes options (just like the haml filter)
  • Haml/Sass options are now taken from the page rep instead of the page

2.1.1 (2008-08-18)

  • Fixed issue which would cause files not to be required in the right order

2.1 (2008-08-17)

This is only a short summary of all changes in 2.1. For details, see the nanoc web site. Especially the blog and the updated manual will be useful.


  • New rdiscount filter (RDiscount site)
  • New maruku filter (Maruku site)
  • New erubis filter (Erubis site)
  • A better commandline frontend
  • A new filesystem data source named filesystem_combined
  • Routers, which decide where compiled pages should be written to
  • Page/layout mtimes can now be retrieved through page.mtime/layout.mtime


  • Already compiled pages will no longer be re-compiled unless outdated
  • Layout processors and filters have been merged
  • Layouts no longer rely on file extensions to determine the layout processor
  • Greatly improved source code documentation
  • Greatly improved unit test suite


  • Several filters have been removed and replaced by newer filters:
    • eruby: use erb or erubis instead
    • markdown: use bluecloth, rdiscount or maruku instead
    • textile: use redcloth instead

2.0.4 (2008-05-04)

  • Fixed default.rb’s #html_escape
  • Updated Haml filter and layout processor so that @page, @pages and @config are now available as instance variables instead of local variables

2.0.3 (2008-03-25)

  • The autocompiler now honors custom paths
  • The autocompiler now attempts to serve pages with the most appropriate MIME type, instead of always serving everything as text/html

2.0.2 (2008-01-26)

  • nanoc now requires Ruby 1.8.5 instead of 1.8.6

2.0.1 (2008-01-21)

  • Fixed a “too many open files” error that could appear during (auto)compiling

2.0 (2007-12-25)


  • Support for custom layout processors
  • Support for custom data sources
  • Database data source
  • An auto-compiler
  • Pages have parent and children


  • The source has been restructured and cleaned up a great deal
  • Filters are defined in a different way now
  • The eruby filter now uses ERB instead of Erubis


  • The filters property; use filters_pre instead
  • Support for Liquid

1.6.2 (2007-10-23)

  • Fixed an issue which prevented the content capturing plugin from working

1.6.1 (2007-10-14)

  • Removed a stray debug message

1.6 (2007-10-13)

  • Added support for post-layout filters
  • Added support for getting a File object for the page, so you can now e.g. easily get the modification time for a given page (@page.file.mtime)
  • Cleaned up the source code a lot
  • Removed deprecated asset-copying functionality

1.5 (2007-09-10)

  • Added support for custom filters
  • Improved Liquid support -- Liquid is now a first-class nanoc citizen
  • Deprecated assets -- use something like rsync instead
  • Added eruby_engine option, which can be erb or erubis

1.4 (2007-07-06)

  • nanoc now supports ERB (as well as Erubis); Erubis no longer is a dependency
  • meta.yaml can now have haml_options property, which is passed to Haml
  • Pages can now have a filename property, which defaults to index [Dennis Sutch]
  • Pages now know in what order they should be compiled, eliminating the need for custom page ordering [Dennis Sutch]

1.3.1 (2007-06-30)

  • The contents of the assets directory are now copied into the output directory specified in config.yaml

1.3 (2007-06-24)

  • The @pages array now also contains uncompiled pages
  • Pages with skip_output set to true will not be outputted
  • Added new filters
    • Textile/RedCloth
    • Sass
  • nanoc now warns before overwriting in create_site, create_page and create_template (but not in compile)

1.2 (2007-06-05)

  • Sites now have an assets directory, whose contents are copied to the output directory when compiling [Soryu]
  • Added support for non-eRuby layouts (Markaby, Haml, Liquid, …)
  • Added more filters (Markaby, Haml, Liquid, RDoc [Dmitry Bilunov])
  • Improved error reporting
  • Accessing page attributes using instance variables, and not through @page, is no longer possible
  • Page attributes can now be accessed using dot notation, i.e. @page.title as well as @page[:title]

1.1.3 (2007-05-18)

  • Fixed bug which would cause layoutless pages to be outputted incorrectly

1.1.2 (2007-05-17)

  • Backup files (files ending with a “~”) are now ignored
  • Fixed bug which would cause subpages not to be generated correctly

1.1 (2007-05-08)

  • Added support for nested layouts
  • Added coloured logging
  • @page now hold the page that is currently being processed
  • Index files are now called “content” files and are now named after the directory they are in [Colin Barrett]
  • It is now possible to access @page in the page’s content file

1.0.1 (2007-05-05)

  • Fixed a bug which would cause a “no such template” error to be displayed when the template existed but compiling it would raise an exception
  • Fixed bug which would cause pages not to be sorted by order before compiling

1.0 (2007-05-03)

  • Initial release