Use conf.json.EXAMPLE and .gitignore conf.json to changes don't affec…

…t repo status

To make it no impact, if JSDoc can't find a conf.json, it looks for conf.json.EXAMPLE and copies that over.

conf.json → conf.json.EXAMPLE

@@ -2,14 +2,10 @@
     "tags": {
         "allowUnknownTags": true
     },
-
     "source": {
         "includePattern": ".+\\.js(doc)?$",
         "excludePattern": "(^|\\/)_"
     },
-
-    "plugins": [
-    ],
-
+    "plugins": [],
     "jsVersion": 180
 }

jsdoc.js

@@ -144,17 +144,26 @@ function main() {
             }
         },
         resolver,
-        dictionary = require('jsdoc/tag/dictionary');
+        dictionary = require('jsdoc/tag/dictionary'),
+        fs = require('fs');
 
     env.opts = jsdoc.opts.parser.parse(env.args);
 
     try {
         env.conf = JSON.parse(
-            require('fs').readFileSync( env.opts.configure || __dirname + '/conf.json' )
+            fs.readFileSync( env.opts.configure || __dirname + '/conf.json' )
         );
     }
     catch (e) {
-        throw('Configuration file cannot be evaluated. '+e);
+        try {
+            //Try to copy over the example conf
+            var example = fs.readFileSync(__dirname + '/conf.json.EXAMPLE', 'utf8');
+            fs.writeFileSync(__dirname + '/conf.json', example, 'utf8');
+            env.conf = JSON.parse(example);
+        }
+        catch(e) {
+            throw('Configuration file cannot be evaluated. ' + e);    
+        }
     }
 
     // allow to pass arguments from configuration file