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,6 +568,10 @@ function execute(port) {
     });
   });
 
+  if (options.watch) startLiveReload();
+  app.listen(port);
+
+  function startLiveReload() {
     // Start LiveReload server.
     process.env.NODE_ENV = 'development';
     const server = tinylr();
@@ -595,8 +599,7 @@ function execute(port) {
         });
       }
     );
-
-  app.listen(port);
+  }
 }
 
 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);