Use console syntax highlighting

README.rst

@@ -28,15 +28,15 @@ Get it now
 macOS with `Homebrew <http://brew.sh/>`_:
 *****************************************
 
-.. code-block:: bash
+.. code-block:: console
 
     $ brew update
     $ brew install doitlive
 
 With pip:
 *********
 
-.. code-block:: bash
+.. code-block:: console
 
     $ pip install doitlive
 
@@ -49,7 +49,7 @@ Quickstart
 1. Create a file called ``session.sh``. Fill it with bash commands.
 2. Run ``doitlive play session.sh``.
 
-.. code-block:: bash
+.. code-block:: console
 
     $ doitlive play session.sh
 

docs/index.rst

@@ -24,15 +24,15 @@ Get it now
 macOS with `Homebrew <http://brew.sh/>`_:
 *****************************************
 
-.. code-block:: bash
+.. code-block:: console
 
     $ brew update
     $ brew install doitlive
 
 With pip:
 *********
 
-.. code-block:: bash
+.. code-block:: console
 
     $ pip install doitlive
 
@@ -45,7 +45,7 @@ Quickstart
 1. Create a file called ``session.sh``. Fill it with bash commands.
 2. Run ``doitlive play session.sh``.
 
-.. code-block:: bash
+.. code-block:: console
 
     $ doitlive play session.sh
 
@@ -56,7 +56,7 @@ Quickstart
 Examples
 --------
 
-.. code-block:: bash
+.. code-block:: console
 
     # Use the "sorin" prompt theme
     $ doitlive play session.sh -p sorin
@@ -72,7 +72,7 @@ Using the recorder
 
 You can record session files using the built-in recorder command.
 
-.. code-block:: bash
+.. code-block:: console
 
     $ doitlive record
 
@@ -86,7 +86,7 @@ Themes
 
 doitlive comes with many prompt themes. To use a theme:
 
-.. code-block:: bash
+.. code-block:: console
 
     $ doitlive play session.sh -p <theme_name>
 
@@ -272,14 +272,14 @@ More
 
 For more options, run
 
-.. code-block:: bash
+.. code-block:: console
 
     $ doitlive --help
 
 
 You can also get help with subcommands.
 
-.. code-block:: bash
+.. code-block:: console
 
     $ doitlive play --help
 

tasks.py

@@ -47,16 +47,40 @@ def clean(ctx):
 
 @task
 def clean_docs(ctx):
-    ctx.run("rm -rf %s" % build_dir)
+    ctx.run('rm -rf %s' % build_dir, echo=True)
 
 @task
 def browse_docs(ctx):
-    ctx.run("open %s" % os.path.join(build_dir, 'index.html'))
+    path = os.path.join(build_dir, 'index.html')
+    webbrowser.open_new_tab(path)
+
+def build_docs(ctx, browse):
+    ctx.run('sphinx-build %s %s' % (docs_dir, build_dir), echo=True)
+    if browse:
+        browse_docs(ctx)
 
 @task
-def docs(ctx, clean=False, browse=False):
+def docs(ctx, clean=False, browse=False, watch=False):
+    """Build the docs."""
     if clean:
         clean_docs(ctx)
-    ctx.run("sphinx-build %s %s" % (docs_dir, build_dir), pty=True)
-    if browse:
-        browse_docs(ctx)
+    if watch:
+        watch_docs(ctx, browse=browse)
+    else:
+        build_docs(ctx, browse=browse)
+
+@task
+def watch_docs(ctx, browse=False):
+    """Run build the docs when a file changes."""
+    try:
+        import sphinx_autobuild  # noqa
+    except ImportError:
+        print('ERROR: watch task requires the sphinx_autobuild package.')
+        print('Install it with:')
+        print('    pip install sphinx-autobuild')
+        sys.exit(1)
+    ctx.run(
+        'sphinx-autobuild {0} {1} {2} -z doitlive'.format(
+            '--open-browser' if browse else '', docs_dir, build_dir,
+        ), echo=True, pty=True,
+    )