conf-boilerplate-v3.md

Over the last couple months we noticed some community stagnation and big performance issues with DocPad. Because of that, and few other problems that appeared to be far from being solved, we decided to move to a new stack #109.

What changed?

For backward compatibility purposes, we decided to keep all folders and all automated task commands with the exact same name.

New features should be expected in upcoming versions, this release is intended to be a 1:1 mapping.

Architecture

• Moved our static generator from DocPad to Metalsmith
  • Which also means moving away from CoffeeScript to Node only
• Moved our template engine from Eco to Handlebars
  • A much more popular engine with better community support

Configuration

• All the generation logic was moved from docpad.js to metalsmith.js
• All the conference data was put into conference.js

Why you should migrate?

• Faster workflow
  • Process duration is now under 1 second (tested in a Mac Pro)
• Prepare for the future
  • As mentioned before, this release is primarily a code refactoring. By updating your code, you'll be able to receive upcoming improvements

What do you have to do?

In src/documents/themes/yellow-swan/css

• Remove extra .css extension from main.css.less file

In src/documents, src/layouts, src/partials

• Remove .eco extensions from .html.eco files
• Update your files to use Handlebars instead of Eco
  • This will take a while, so I recommend taking it from our repo