Create a gist now

Instantly share code, notes, and snippets.

What would you like to do?
build bootstrap docs
//
// 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
}
})
};
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');
};
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment