v0.11.4-beta

• Fix - Ongoing work with IO abstraction layer (#123, #214) to resolve some file system errors on build

Note that you may need to right-click the zip file after download and select "Unblock" in the Security section of the properties dialog, otherwise you could get strange errors when using the application.

v0.11.3-beta

• Fix - Specifying input path(s) on the command line now correctly removes the default input path (#241 and #231)
• Fix - Correctly handle paths that contain single . chars (#244)
• Fix - Duplicate trace messages when config file is changed in watch mode (#243)
• Feature - New support for specifying global metadata on the command line and accessing it from config files, the engine, and the execution context (#233 and #237, thanks @miere43)
• Fix - Incorrect number of pipelines reported in output (#235 and #236, thanks @miere43)
• Fix - Exceptions are now highlighted in the CLI (#230 and #232, thanks @miere43)

Note that you may need to right-click the zip file after download and select "Unblock" in the Security section of the properties dialog, otherwise you could get strange errors when using the application.

v0.11.2-beta

• A special thanks to @deanebarker who contributed a ton of new functionality as well as generated lots of great ideas, discussion, and bug reports - this release wouldn't be what it was without his help and support
• Note that the I/O abstraction support is still under development and may continue to change in the next version
• Feature - Support for custom document types (#183)
• Feature - Support for reading from stdin, including a new ReadApplicationInput module (#226, thanks @deanebarker)
• Feature - New command-line switch --verify-config for validating the config file without actually running (#223, thanks @deanebarker)
• Feature - New ValidateMeta module for validating metadata (#220, thanks @deanebarker)
• Feature - New command-line switch --preview-root to set an alternate root path for the preview server (#213, thanks @deanebarker)
• Feature - New Merge module that merges the content and metadata from documents output by a module sequence into the input documents
• Refactoring - Breaking change: ReadFiles now outputs new documents and only reads the files once if supplying a search pattern, to replicate the old behavior where ReadFiles read the matching files for each input document wrap it in the new Merge module
• Feature - New GenerateCloudSearchData module to generate JSON data for AWS Cloud Search (#213, thanks @deanebarker)
• Feature - New Take module that only outputs the first N input documents (#208 and #211, thanks @deanebarker)
• Feature - New CopyMeta module to allow copying metadata from one key to another with optional formatting (#209 and #207, thanks @deanebarker)
• Feature - Added .WithGuidMetaKey() to the Rss module to specify a metadata item that has the GUID (#206, thanks @deanebarker)
• Feature - A tools NuGet package is now published that includes the CLI (#204)
• Feature - Added void delegates to Execute module so you no longer have to return a value (#194)
• Feature - Added .IsRegex() to Replace module (#201 and #203, thanks @deanebarker)
• Feature - New ModuleCollection module to wrap a sequence of child modules for reuse (#197)
• Feature - Added IMetadata.Documents() to return an IReadOnlyList<IDocument> from metadata (#200)
• Feature - Added IMetadata.Document() to return an IDocument from metadata
• Fix - Type conversions now properly take compatibility with enumerated item type into account (#198)
• Fix - Fixed possible race condition when cloning documents with different sources (#196)
• Feature - Breaking change: Implemented new IO framework and replaced all uses of strings for passing path information with new IO classes, Engine.RootFolder, Engine.InputFolder, and Engine.OutputFolder are now replaced by IFileSystem.RootPath, IFileSystem.InputPaths, IFileSystem.OutputPath (#123)
• Refactoring - Breaking change: Changed Trace to a static class to better support forthcoming parallel pipeline processing
• Refactoring - Breaking change: Metadata property in config file renamed to InitialMetadata to distinguish from run-time metadata
• Refactoring - Removed the need to pass Engine to many core classes since it was just needed for the Trace instance (which is now static)
• Refactoring - Split internal configuration classes for better separation of concerns and testability
• Refactoring - Added Wyam.Testing library with common testing classes
• Refactoring - Reorganized tests to better follow a specific convention
• Refactoring - Changed color of critical errors in the console to white on a red background for better readability (#182)
• Refactoring - Changed model type of Razor pages to IDocument instead of IMetadata (#188)
• Refactoring - Uncaught exceptions now cancel the build (#187)

Note that you may need to right-click the zip file after download and select "Unblock" in the Security section of the properties dialog, otherwise you could get strange errors when using the application.

v0.11.1-beta

• Refactoring - Changed the name of the release file from wyam.zip to wyam-[verson].zip - note that this is a breaking change if you download the release zip from a continuous integration script.
• Fix - Namespaces are now added for Engine.Configure() calls without a script (#147 and #148, thanks @heavenwing)
• Fix - CopyFiles was no returning a sequence for invalid folders (#166)
• Fix - Better documentation and small bug fixes for CopyFiles (#158)
• Fix - Excludes the output folder from watching (#156)
• Fix - Fixes some odd behavior with FileName used with WriteFiles (#159)
• Fix - Better failure handling to overcome locked file errors when watching (thanks @miere43)
• Fix - Implemented file operation retry for several modules (#167, #169)
• Feature - New Rss module (#174, thanks @miere43)
• Feature - Added support for unknown file types to preview server (#175)
• Feature - Added more specific error codes (#171)
• Refactoring - Small improvements to Yaml module (better error messages, parallel processing) (#177)
• Feature - New GitHub module (#145)
• Feature - Added Meta.IgnoreNull() to control if null values should still be added to metadata
• Feature - Added IMetadata.Dynamic() to return metadata values as dynamic objects
• Refactoring - Adds an extra optional key to the cache for use by module authors
• Feature - Added additional Markdown module constructor to render Markdown content in metadata
• Feature - New Json and GenerateJson modules to read and write JSON data (#5)
• Feature - Added support for setting input and output path from the configuration script
• Fix - Git module now correctly ascends folder hierarchy
• Refactoring - Migrated build system to Cake

v0.11.0-beta

This was a huge release that was almost 3 months in the making. The primary focus was on integrating code analysis support using Roslyn to enable the generation of documentation sites. It also set up some architecture for the next release, which will focus on better support for common use cases (and include the long-awaited recipe and theme functionality). Along the way many awesome contributors donated new modules, helped fix bugs, and generally made this is best, most stable release yet.

• Feature - New Download module for downloading content during generation (#68 and #75, thanks @dodyg)
• Feature - New AnalyzeCSharp module that performs code analysis on C# source files, including XML documentation comments (#70)
• Feature - New ReadProject module that loads all the source files referenced in an MSBuild project (#70)
• Feature - New ReadSolution module that loads all the source files referenced in an MSBuild solution (#70)
• Feature - Added WithoutExtensions() to CopyFiles to make it easier to specify which files to copy
• Feature - Added additional IExecutionContext.GetNewDocument() overloads
• Refactoring - Moved Crc32 to Wyam.Common so other module libraries can also use it
• Fix - NuGet support now considers .NET 4.6 packages when resolving libraries
• Fix - Console application now exists with a non-zero error code so automated builds can be aborted if something goes wrong
• Refactoring - Additional trace output for debugging, especially in NuGet resolve process
• Refactoring - Better example test fixture (thanks @yetanotherchris)
• Refactoring - Moved Wyam.Common types to appropriate nested namespaces
• Feature - Added WithMatchOnlyWholeWord() to AutoLink module (#80, thanks @LokiMidgard)
• Feature - New HtmlEscape module for escaping HTML characters (#81, thanks @LokiMidgard)
• Feature - Additional ToLookup(), ToDocumentDictionary(), and ToDictionary() extension methods for IDocumentCollection (#82)
• Feature - Added new Execute() constructor to Execute module that only gets evaluated once per pipeline (#83, thanks @LokiMidgard)
• Feature - New GitCommits and GitContributors modules for getting information from Git repositories (#84, thanks @LokiMidgard)
• Feature - New ConcatBranch module for branching and then concatenating the output (#87, thanks @LokiMidgard)
• Feature - New DirectoryMeta module for applying metadata supplied for an entire directory to all documents sourced from that directory (#86, thanks @LokiMidgard)
• Fix - Fixed several file locking issues (#92)
• Feature - Performance boost by using parallel disposal at the end of pipelines
• Feature - Added ThenBy() to OrderBy module (#101, thanks @LokiMidgard)
• Feature - Can now output the config script files the way Roslyn sees them (after adding modules, etc.) for debugging purposes using the --output-scripts flag (#99)
• Feature - New FileName module for generating SEO-friendly file names (#99, #104, and #107, thanks @yetanotherchris)
• Feature - Added UseWriteMetadata() to WriteFiles module to control if metadata values are used for file destination (#106)
• Feature - Default for FrontMatter module is now to ignore delimiter(s) if on the first line
• Feature - All configured namespaces are added as IExecutionContext.Namespaces for other code generating modules to use
• Feature - WriteFiles module now sets relative path information metadata (#111, thanks @reliak)
• Feature - New Sitemap module to generate standards-compliant sitemap files (#113, thanks @reliak)
• Feature - New Xmp module to import XMP encoded metadata (#114, thanks @LokiMidgard)
• Feature - Updates to CopyFiles for better path handling (#116, thanks @reliak)
• Feature - New SearchIndex module to generate Lunr.js compliant search indexes (#118, thanks @reliak)
• Feature - New Switch module to provide switch statement like control for a pipeline (#120, thanks @reliak)
• Feature - Added IgnoreEmptyContent() to WriteFiles module to ignore empty files (#117)
• Feature - New Xslt module to apply XSLT transformations (#126, thanks @LokiMidgard)
• Feature - New CsvToHtml and ExcelToCsv modules for working with tabular data (#132, thanks @LokiMidgard)
• Refactoring - Removed static helper methods in MetadataHelper and replaced with MetadataItem and MetadataItems classes to make working with metadata easier
• Refactoring - Renamed Wyam.Core.MetadataKeys to Keys and moved to Wyam.Common for common access (#131).

v0.10.0-beta

• Feature - Added additional overloads to the Documents module that allow you to create new documents from scratch
• Feature - New IExecutionContext.GetNewDocument(...) method that also allows you to create a new document from scratch from within your modules
• Feature - New GenerateMeta module that procedurally generates metadata text using a text template (#55)
• Feature - New GenerateContent module that procedurally generates document content using a text template (#55)
• Refactoring - Renamed several fluent methods to better follow accepted fluent method naming conventions (I.e., Xyz(...) to WithXyz(...)) - this may be a breaking change for some configuration files
• Fix - Resolved memory consumption problems with using a large number of Razor templates by caching referenced assemblies (#69)
• Feature - New UnwrittenFiles module that can prevent processing pipeline documents that have already been written to disk in a prior generation (#56)
• Feature - Added .WithExtensions(...) fluent method to the ReadFiles module that makes it easier to restrict file reads to a set of file extensions
• Feature - New HtmlQuery module that provides powerful querying of HTML content and sets result document content and/or metadata based on the results

v0.9.0-beta

This release was primarily aimed at improving support for module development and simplifying the code in configuration files to make it easier for non-.NET developers. Of course, there's also a few goodies for everyone.

• Feature - New Paginate module for partitioning documents into pages (#60)
• Feature - New GroupBy module for grouping documents
• Feature - New OrderBy module for ordering documents (#61)
• Feature - Several new constructor overloads to the Documents module that allow you get documents based on context.
• Fix - Errors in the config file now report the correct line numbers (you will never know the pain I felt trying to get this to work correctly) (#67)
• Refactoring - Changed IDocument.Stream to IDocument.GetStream() which now returns a wrapper stream that blocks on usage and must be disposed after use to prevent concurrent stream access for the same stream (#65)
• Feature - Added support for automatic lambda expansion of @doc and @ctx variables in the configuration file
• Feature - Added ContextConfig and DocumentConfig delegates to support the new automatic lambda expansion and encourage a standardized way of lazily configuring a module (#63)
• Feature - Added ConfigHelper to support the common module configuration pattern where a module has either a ContextConfig or a DocumentConfig
• Refactoring - Removed the ConcatDocuments module. The behavior can be easily represented by using other existing modules: Concat(Documents(...))
• Fix - Fixed a bug in the Execute module when returning null
• Fix - Fixed a bug in the ReadFiles module when no files match the specified pattern
• Fix - Fixed some bugs in automatic module constructor factory method generation for configuration files for generic modules
• Refactoring - now using more collections from System.Collections.Immutable for improved performance and safety

v0.8.0-beta

This is the biggest update of Wyam since the initial release. A special shout-out to @dodyg who, in addition to contributing the new image processing module, has worked on refining requirements and generating ideas for improvement. A significant chunk of the work is this release is related to discussions I've had with him.

• Feature - Improved caching support in multiple modules including Razor and Markdown
• Feature - New IDocument.Source property to uniquely identify the source of each document (#38)
• Feature - New AutoLink module for automatically generating links within HTML content (#36)
• Refactoring - Major changes to how Wyam handles the storage of content inside a document to include operating on streams and/or string buffers for increased performance (#42)
• Refactoring - Improvements to document and engine life cycle for proper disposal of resources
• Feature - New Images module for manipulation of images within a pipeline (#25 - thanks @dodyg)
• Refactoring - Renamed Wyam.Abstractions to Wyam.Common to reflect that it also contains non-abstract common code (#45)
• Feature - New ForEach module that allows processing child documents one at a time (#47)
• Fix - Fixes to how the Less module handles relative URLs (#49 - thanks @Rohansi)
• Refactoring - Made the cache thread-safe for parallel processing within a module (#50)
• Refactoring - Changed behavior of several modules including Razor, Less, Markdown, ReadFiles, and WriteFiles, to process documents in parallel resulting in significant performance improvements
• Feature - ASCII art FTW
• Refactoring - Moved PathHelper to Wyam.Common
• Feature - New Excerpt module that can excerpt the first specified element from HTML content and add it to metadata (#26)
• Feature - New processDocumentsOnce flag that can skip any documents previously processed by the pipeline (#56)
• Fix - Fixed a bug with Razor sections and IRazorPage instance reuse on subsequent pipeline executions (#58)

v0.7.0-beta

• Moved all the libraries from alpha to beta to reflect improving stability
• Refactoring - Updated all projects and solution to Visual Studio 2015 and .NET 4.6
• Feature - Added ability to specify alternate ViewStart paths for the Razor module (#37 - thanks @mschumaker)
• Feature - Added ability to specify file ignore prefixes for the Razor module, files prefixed with _ are now ignored by default (#37 - thanks @mschumaker)
• Feature - Added additional metadata to ReadFiles: SourceFilePathBase, RelativeFilePathBase, and RelativeFileDir
• Feature - Added additional metadata to WriteFiles: DestinationFileBase, DestinationFileExt, DestinationFileName, DestinationFileDir, and DestinationFilePathBase
• Fix - Better normalization of file paths
• Feature - Adds a new string IMetadata.Link(string key, string defaultValue = null) method for automatically formatting links for HTML use (I.e., replacing slashes)
• Refactoring - Updated to Roslyn 1.0
• Feature - Adds a new universal IExecutionCache for modules to use for caching data

v0.6.0-alpha

• Feature - Yaml module now maps simple scalar sequences to metadata when flattening
• Refactoring - Switched from Roslyn scripting engine to direct compilation for configuration files, improving capabilities of configuration file declarations (extension classes, etc.)
• Fix - Lots of fixes and updates for assembly locating and loading
• Feature - Implemented support for custom Razor base page types
• Feature - Added new Documents module that replaces the documents in the pipeline with alternate ones
• Feature - Added overload to the Execute module that allows use of the execution context
• Refactoring - Moved MetadataKeys class out of Wyam.Abstractions to Wyam.Core so that Wyam.Abstractions would be more stable, though this means user code will have to go back to strings for metadata keys
• Feature - Added ability to override write location in the WriteFiles module on a per-document basis by setting specific metadata
• Feature - IDocument now implements IMetadata so metadata can be retrieved directly from the document object
• Feature - Added a .String(...) method to IMetadata to make getting string values easier
• Refactoring - Created a new IDocumentCollection interface and implementations to provide a better API for getting documents during execution
• Feature - Implemented support for converting metadata between array types and between scalars and array types
• Feature - Implemented a .ToLookup<T>(...) extension method to generate a lookup table of metadata values to documents (for example, get all tags and the documents that define those tags)