Add option to disable live reload server during development (#766)

* add option to disable live reload server

* change live to watch, fix incorrect argument parsing code

* Update api-commands.md

docs/api-commands.md

@@ -145,6 +145,7 @@ This script will build the static website, apply translations if necessary, and
 | Options           | Default | Description                                                                                                                          |
 | ----------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------ |
 | `--port <number>` | `3000`  | The website will be served from port 3000 by default, but if the port is taken up, Docusaurus will attempt to find an available one. |
+| `--watch` | -  | Whether to watch the files and live reload the page when files are changed. Defaults to true. Disable this by using `--no-watch`. |
 
 ---
 

lib/server/server.js

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-function execute(port) {
+function execute(port, options) {
   const extractTranslations = require('../write-translations');
 
   const metadataUtils = require('./metadataUtils');
@@ -568,35 +568,38 @@ function execute(port) {
     });
   });
 
-  // Start LiveReload server.
+  if (options.watch) startLiveReload();
-  process.env.NODE_ENV = 'development';
-  const server = tinylr();
-  server.listen(constants.LIVE_RELOAD_PORT, function() {
-    console.log(
-      'LiveReload server started on port %d',
-      constants.LIVE_RELOAD_PORT
-    );
-  });
-
-  // gaze watches some specified dirs and triggers a callback when they change.
-  gaze(
-    [
-      '../' + readMetadata.getDocsPath() + '/**/*', // docs
-      '**/*', // website
-      '!node_modules/**/*', // node_modules
-    ],
-    function() {
-      // Listen for all kinds of file changes - modified/added/deleted.
-      this.on('all', function() {
-        // Notify LiveReload clients that there's a change.
-        // Typically, LiveReload will only refresh the changed paths,
-        // so we use / here to force a full-page reload.
-        server.notifyClients(['/']);
-      });
-    }
-  );
-
   app.listen(port);
+
+  function startLiveReload() {
+    // Start LiveReload server.
+    process.env.NODE_ENV = 'development';
+    const server = tinylr();
+    server.listen(constants.LIVE_RELOAD_PORT, function() {
+      console.log(
+        'LiveReload server started on port %d',
+        constants.LIVE_RELOAD_PORT
+      );
+    });
+
+    // gaze watches some specified dirs and triggers a callback when they change.
+    gaze(
+      [
+        '../' + readMetadata.getDocsPath() + '/**/*', // docs
+        '**/*', // website
+        '!node_modules/**/*', // node_modules
+      ],
+      function() {
+        // Listen for all kinds of file changes - modified/added/deleted.
+        this.on('all', function() {
+          // Notify LiveReload clients that there's a change.
+          // Typically, LiveReload will only refresh the changed paths,
+          // so we use / here to force a full-page reload.
+          server.notifyClients(['/']);
+        });
+      }
+    );
+  }
 }
 
 module.exports = execute;

lib/start-server.js

@@ -42,7 +42,10 @@ if (env.versioning.enabled && env.versioning.missingVersionsPage) {
 
 const program = require('commander');
 
-program.option('--port <number>', 'Specify port number').parse(process.argv);
+program
+  .option('--port <number>', 'Specify port number')
+  .option('--no-watch', 'Toggle live reload file watching')
+  .parse(process.argv);
 
 let port = parseInt(program.port, 10) || process.env.PORT || 3000;
 let numAttempts = 0;
@@ -68,7 +71,7 @@ function checkPort() {
       } else {
         // start local server on specified port
         const server = require('./server/server.js');
-        server(port);
+        server(port, program.opts());
         const host = `http://localhost:${port}`;
         console.log('Docusaurus server started on port %d', port);
         openBrowser(host);