funcunit/site/node_modules/documentjs/lib/generators/html/generate.js

<!-- @hide title

var build = require("./build/build"),
	write = require("./write/write"),
	Q = require("q"),
	fs = require("fs-extra"),
	mkdirs = Q.denodeify(fs.mkdirs),
	Handlebars = require("handlebars");

/**
 * @function documentjs.generators.html.generate
 * @parent documentjs.generators.html.methods
 * 
 * Generates an HTML site for a [documentjs.process.docMap docMap]
 * given configuration options.
 * 
 * @signature `.generate(docMapPromise, options)`
 * 
 * @param {Promise<documentjs.process.docMap>} docMapPromise A promise that 
 * contains a `docMap` created by [documentjs.process.files].
 * @param {Object} options Configuration options.
 * 
 * @return {Promise} A promise that resolves when the site has been built.
 */
module.exports = function(docMapPromise, options){
	// 1. Copies everything from site/default/static to site/static/build
	// 2. Overwrites site/static/build with content in `options.static`
	// 3. Runs site/static/build/build.js
	//    A. Builds itself and copies everything to site/static/dist
	var staticPromise = build.staticDist(options).then(function(){
		// copies statics to documentation location.
		return write.staticDist(options);
	});
	
	var buildTemplatesPromise = build.templates(options).then(function(){
		return Handlebars.create();
	});
	buildTemplatesPromise["catch"](function(){
		console.log("problem building templates");
	});
	
	var currentDocObject;
	var getCurrent = function(){
		return currentDocObject;
	};
	var setCurrent = function(current){
		currentDocObject = current;
	};
	var helpersReadyPromise = docMapPromise.then(function(docMap){
		return build.helpers(buildTemplatesPromise, docMap, options, getCurrent);
	});
		
	var docsPromise = Q.all([
			docMapPromise,
			build.renderer(buildTemplatesPromise, options),
			helpersReadyPromise,
			mkdirs(options.dest)
	]).then(function(results){
		var docMap = results[0],
			renderer = results[1];
		return write.docMap(docMap, renderer, options, setCurrent);
	});
	return Q.all([staticPromise, docsPromise]);
};