Metalsmith step-by-step

debuggingHandlebars

Use `log` from handlebars v3 onwards:

http://stackoverflow.com/a/32218903

index1-Simple.js

/* pre-setup for this file:
npm init
npm install metalsmith --save-dev
edit index.js and add the code below:
*/

var Metalsmith = require('metalsmith');

Metalsmith(__dirname)    // src by default
  .destination('./build')
  .build(function(err) {
    if(err) throw err;
    console.log('Build finished');
  })
  
/* test:
Edit src/index.md and add:
## Hello, world!
Testing 1 2 3

Run
node index.js

Output:
You should see index.md, as is, inside build/
*/
  
  

index2-AddMarkdown.js

/*
Now we are going to transform our markdown into html
Pre-setup: 
npm install metalsmith-markdown --save-dev
*/

/* pre-setup for this file:
npm init
npm install metalsmith --save-dev
edit index.js and add the code below:
*/

var Metalsmith = require('metalsmith');

Metalsmith(__dirname)    // src by default
  .destination('./build')
  .use(markdown())
  .build(function(err) {
    if(err) throw err;
    console.log('Build finished');
  })
  
/* test:
Edit src/index.md and add:
## Hello, world!
Testing 1 2 3

Run
node index.js

Output:
You should see index.html, correctly parsed, inside build/
*/
  
  

index3-AddLayout.js

Metalsmith(__dirname)
  .destination('./build')
  .use(markdown())
  .use(layouts({
    engine: 'handlebars',
    directory: 'layouts'
  }))
  .build(function(err) {
    if(err) throw err;
    console.log('Build finished');
});

index4-simpleLogger.js

function myLogger(files, metalsmith, done) {
 console.log('Files: ');
 console.log(files);
 console.log('\nMetalsmith: ');
 console.log(metalsmith);
 done();
}