build bootstrap docs

docs.js

//
// Build Bootstrap Docs
// ---------------------------------------------
// Credit: inspired by @ctalkington

module.exports = function(grunt) {

  // Grunt utilities.
  var task   = grunt.task,
    file     = grunt.file,
    utils    = grunt.util,
    log      = grunt.log,
    verbose  = grunt.verbose,
    fail     = grunt.fail,
    option   = grunt.option,
    config   = grunt.config,
    template = grunt.template,
    _        = utils._

  // external dependencies
  var fs  = require('fs'),
    hogan = require('hogan.js')


  // ==========================================================================
  // TASKS
  // ==========================================================================
  grunt.registerMultiTask('docs', 'Compile mustache files to HTML with hogan.js', function() {

    var data     = this.data,
      src        = grunt.file.expandFiles(this.file.src),
      dest       = grunt.template.process(data.dest),

      // Options
      defaults   = {
        production: false,
        title: 'Bootstrap',
        layout: 'docs/templates/layout.mustache'
      },
      options = _.extend(defaults, this.data.options || {})

      !src && grunt.warn('Missing src property.')
      if(!src) return false

      !dest && grunt.warn('Missing dest property')
      if(!dest) return false

    var done = this.async()
    var srcFiles     = file.expandFiles(src)

    try {
      options.layout = fs.readFileSync(options.layout, 'utf8')
      options.layout = hogan.compile(options.layout, {
        sectionTags: [{
          o: '_i',
          c: 'i'
        }]
      })
    } catch(err) {
      grunt.warn(err) && done(false)
      return
    }

    srcFiles.forEach(function(filepath) {
      var filename = _.first(filepath.match(/[^\\\/:*?"<>|\r\n]+$/i)).replace(/\.mustache$/, '')

      grunt.helper('hogan', filepath, filename, options, function(err, result) {
        err && grunt.warn(err) && done(false)
        if(err) return

        file.write(dest.replace('FILE', filename), result)
      })
    })

    done()
  })

  // ==========================================================================
  // HELPERS
  // ==========================================================================
  grunt.registerHelper('hogan', function(src, filename, options, callback) {
    log.writeln('Compiling ' + src)

    var page = fs.readFileSync(src, 'utf8'),
      html = null,
      layout = options.layout,
      context = {}

    context[filename] = 'active'
    context._i = true
    context.production = options.production

    var title = _.template("<%= page == 'Index' ? site : page + ' - ' + site %>")
    context.title = title({
      page: _(filename).humanize().replace('css', 'CSS'),
      site: options.title
    })

    try {
      page = hogan.compile(page, {
        sectionTags: [{
          o: '_i',
          c: 'i'
        }]
      })
      page = layout.render(context, {
        body: page
      })
      callback(null, page)
    } catch(err) {
      callback(err)
      return
    }
  })
};

grunt.js

module.exports = function(grunt) {

  'use strict';

  // Project configuration
  grunt.initConfig({
 
    docs: {
      dev: {
        src: 'docs/templates/pages/*.mustache',
        dest: 'docs/FILE.html'
      },
      pages: {
        src: 'docs/templates/pages/*.mustache',
        dest: 'docs/FILE.html',
        options: {
          production: true,
          title: 'Bootstrap',
          layout: 'docs/templates/layout.mustache'
        }
      }
    }
  });

  grunt.loadNpmTasks('grunt-contrib');

  // Load local tasks.
  grunt.loadTasks('tasks');

  // Default task.
  grunt.registerTask('default','docs');

};