feat(build): load passed in config option

Fixes #documentationjs/gulp-documentation#27

index.js

@@ -24,7 +24,8 @@ var fs = require('fs'),
   formatLint = require('./lib/lint').formatLint,
   garbageCollect = require('./lib/garbage_collect'),
   lintComments = require('./lib/lint').lintComments,
-  markdownAST = require('./lib/output/markdown_ast');
+  markdownAST = require('./lib/output/markdown_ast'),
+  loadConfig = require('./lib/load_config');
 
 /**
  * Build a pipeline of comment handlers.
@@ -137,6 +138,7 @@ function build(indexes, options, callback) {
  *
  * @param {Array<string>} indexes files to process
  * @param {Object} options options
+ * @param {string} config path to configuration file to load
  * @param {Array<string>} options.external a string regex / glob match pattern
  * that defines what external modules will be whitelisted and included in the
  * generated documentation.
@@ -172,6 +174,10 @@ function buildSync(indexes, options) {
   options = options || {};
   options.hljs = options.hljs || {};
 
+  if (typeof options.config === 'string') {
+    Object.assign(options, loadConfig(options.config));
+  }
+
   if (!options.access) {
     options.access = ['public', 'undefined', 'protected'];
   }

test/fixture/class.config.output.md

@@ -0,0 +1,29 @@
+<!-- Generated by documentation.js. Update this documentation by updating the source code. -->
+
+# MyClass
+
+This is my class, a demo thing.
+
+**Properties**
+
+-   `howMany` **[number](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number)** how many things it contains
+
+## getFoo
+
+Get the number 42
+
+**Parameters**
+
+-   `getIt` **[boolean](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean)** whether to get the number
+
+Returns **[number](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number)** forty-two
+
+## getUndefined
+
+Get undefined
+
+Returns **[undefined](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/undefined)** does not return anything.
+
+# Hello
+
+World

test/fixture/simple.config.yml

@@ -0,0 +1,4 @@
+toc:
+  - MyClass
+  - name: Hello
+    description: World

test/test.js

@@ -250,6 +250,22 @@ test('highlightAuto md output', function (t) {
   });
 });
 
+test('config', function (t) {
+  var file = path.join(__dirname, 'fixture', 'class.input.js');
+  var result = fs.readFileSync(path.join(__dirname, 'fixture', 'class.config.output.md')).toString();
+  documentation.build([file], {
+    config: path.join(__dirname, 'fixture', 'simple.config.yml')
+  }, function (err, out) {
+    t.ifError(err);
+    outputMarkdown(out, {}, function (err, md) {
+      t.ifError(err);
+
+      t.equal(md, result, 'rendered markdown is equal');
+      t.end();
+    });
+  });
+});
+
 test('multi-file input', function (t) {
   documentation.build([
     path.join(__dirname, 'fixture', 'simple.input.js'),