feat: allow hljs to be run from command line

package.json

@@ -21,6 +21,9 @@
     "url": "git://github.com/highlightjs/highlight.js.git"
   },
   "main": "./lib/index.js",
+  "bin": {
+    "hljs": "./tools/build.js"
+  },
   "scripts": {
     "mocha": "mocha",
     "test": "mocha --globals document test",
@@ -29,18 +32,20 @@
   "engines": {
     "node": "*"
   },
-  "devDependencies": {
-    "bluebird": "^3.5.3",
+  "dependencies": {
     "commander": "^2.19.0",
+    "bluebird": "^3.5.3",
     "del": "^3.0.0",
     "gear": "^0.9.7",
     "gear-lib": "^0.9.2",
     "glob": "^7.1.3",
     "js-beautify": "^1.8.9",
     "jsdom": "^9.2.1",
     "lodash": "^4.17.11",
-    "mocha": "^5.2.0",
-    "should": "^13.2.3",
     "tiny-worker": "^2.1.2"
+  },
+  "devDependencies": {
+    "mocha": "^5.2.0",
+    "should": "^13.2.3"
   }
 }

tools/browser.js

@@ -8,10 +8,10 @@ let path     = require('path');
 let registry = require('./tasks');
 let utility  = require('./utility');
 
-let directory;
+let directory = {};
 
 function templateAllFunc(blobs) {
-  const name = path.join('demo', 'index.html');
+  const name = path.join(directory.root, 'demo/index.html');
 
   blobs = _.compact(blobs);
 
@@ -69,29 +69,29 @@ function generateDemo(filterCB, readArgs) {
     writeImages: { requires:'readImages', task: ['dest', destArgs] },
     readDemoJS: {
       requires: 'logStart',
-      task: ['read', path.join('demo', 'demo.js')]
+      task: ['read', path.join(directory.root, 'demo/demo.js')]
     },
     minifyDemoJS: { requires: 'readDemoJS', task: 'jsminify' },
     writeDemoJS: { requires: 'minifyDemoJS', task: ['dest', demoRoot] },
     readDemoCSS: {
       requires: 'logStart',
-      task: ['read', path.join('demo', 'style.css')]
+      task: ['read', path.join(directory.root, 'demo/style.css')]
     },
     minifyDemoCSS: { requires: 'readDemoCSS', task: 'cssminify' },
     writeDemoCSS: { requires: 'minifyDemoCSS', task: ['dest', demoRoot] }
   };
 }
 
 module.exports = function(commander, dir) {
-  directory = dir;
+  Object.assign(directory, dir);
 
   let hljsExt, output, requiresTask, tasks,
       replace           = utility.replace,
       regex             = utility.regex,
       replaceClassNames = utility.replaceClassNames,
 
-      coreFile     = path.join('src', 'highlight.js'),
-      languages    = utility.glob(path.join('src', 'languages', '*.js')),
+      coreFile     = path.join(directory.root, 'src/highlight.js'),
+      languages    = utility.glob(path.join(directory.root, 'src/languages', '*.js')),
       filterCB     = utility.buildFilterCallback(commander.args),
       replaceArgs  = replace(regex.header, ''),
       templateArgs =
@@ -152,7 +152,7 @@ module.exports = function(commander, dir) {
     task: ['write', output]
   };
 
-  tasks = (commander.target === 'browser')
+  tasks = (commander.target === 'browser' && commander.docs)
         ? [copyDocs(), generateDemo(filterCB, languages), tasks]
         : [tasks];
 

tools/build.js

@@ -1,3 +1,4 @@
+#!/usr/bin/env node
 // For the basic introductions on using this build script, see:
 //
 // <https://highlightjs.readthedocs.org/en/latest/building-testing.html>
@@ -12,9 +13,11 @@
 //
 //   The default target. This will package up the core `highlight.js` along
 //   with all the language definitions into the file `highlight.pack.js` --
-//   which will be compressed without including the option to disable it. It
-//   also builds the documentation for our readthedocs page, mentioned
-//   above, along with a local instance of the demo at:
+//   which will be compressed without including the option to disable it.
+//
+//   If the --docs options is set, it also builds the documentation for our
+//   readthedocs page, mentioned above, along with a local instance of the demo
+//   at:
 //
 //   <https://highlightjs.org/static/demo/>.
 //
@@ -65,25 +68,28 @@ let path      = require('path');
 let Queue     = require('gear').Queue;
 let registry  = require('./tasks');
 
-let build, dir = {};
+const defaultOutPath = path.resolve(__dirname, '../build');
 
 commander
   .usage('[options] [<language>...]')
+  .option('-d, --docs', 'Include documentation and demo (when target "browser")')
   .option('-n, --no-compress', 'Disable compression')
+  .option('-o, --output <path>', 'directory to output to', defaultOutPath)
   .option('-t, --target <name>', 'Build for target ' +
                                  '[all, browser, cdn, node]',
                                  /^(browser|cdn|node|all)$/i, 'browser')
   .parse(process.argv);
 
 commander.target = commander.target.toLowerCase();
 
-build     = require(`./${commander.target}`);
-dir.root  = path.dirname(__dirname);
-dir.build = path.join(dir.root, 'build');
+const build   = require(`./${commander.target}`);
+const dir = {
+  build: path.resolve(process.cwd(), commander.output),
+  root: path.resolve(__dirname, "../"),
+};
 
 new Queue({ registry: registry })
-  .clean(dir.build)
-  .log('Starting build.')
+  .log(`⚒ Starting build for "${commander.target}."`)
   .series(build(commander, dir))
-  .log('Finished build.')
+  .log('❤️ Finished build.')
   .run();

tools/node.js

@@ -82,7 +82,7 @@ function copyMetaFiles() {
       glob   = `{README.md,LICENSE,${docs}}`,
 
       input  = utility.glob(path.join(directory.root, glob)),
-      output = { dir: directory.build, base: '.' };
+      output = { dir: directory.build, base: directory.build };
 
   return {
     startLog: { task: ['log', 'Copying meta files.'] },