Metalsmith-links.md

https://github.com/metalsmith/metalsmith

https://github.com/evocode/metalsmith-base

https://www.sitepoint.com/create-static-site-metalsmith/

https://segment.com/blog/building-technical-documentation-with-metalsmith/

package.json

"handlebars": "^4.0.5",
"metalsmith": "^2.1.0",
"metalsmith-assets": "^0.1.0",
"metalsmith-in-place": "^1.4.4",
"metalsmith-layouts": "^1.6.5",
"metalsmith-markdown": "^0.2.1",
"metalsmith-permalinks": "^0.5.0"

plugins part of metalsmith.json

  "plugins": {
"metalsmith-markdown": {},
"metalsmith-permalinks": {
  "pattern": ":urlTitle"
},
"metalsmith-layouts": {
  "engine": "handlebars",
  "partials": "layouts/partials"
},
"metalsmith-in-place": {
  "engine": "handlebars"
},
"metalsmith-assets": {}

}

var gulp = require('gulp');
var uglify = require('gulp-uglify');
var concat = require('gulp-concat');
var pump = require('pump');

gulp.task('js', function (cb) {
    pump([
            gulp.src('public/assets/js/*.js'),
            concat('all.min.js'),
            uglify(),
            gulp.dest('dist')
        ],
        cb
    );
});