Closed Issue #8:

The *tethys gen apache* script would throw an error when executed as directed in the production docs:

::

    tethys gen apache -d /etc/apache2/site-available/tethys-default.conf
    ERROR: "{0}" is not a valid directory.

The instructions in the docs were bad, because the *-d* option takes the path to a directory, not the file to create. This line of the docs was updated as follows:

::

    tethys gen apache -d /etc/apache2/sites-available

The error message made this issue unclear, because the directory was not being injected into the error message. This has been resovled so that the error now would read:

::

    ERROR: "/etc/apache2/sites-available/tethys-default.conf" is not a valid directory.

.gitignore

@@ -7,4 +7,6 @@
 *.idea
 *.sqlite3
 *.db
-settings.py
+settings.py
+docs/_build
+docs/_static

docs/_build/html/.buildinfo

@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: 6aec7ef0521934f904746630a19206b7
+config: 0b590271dc7d9d7dc8f68b945afe5a8f
 tags: 645f666f9bcd5a90fca523b33c5a78b7

docs/_build/html/development/docker_env.html

@@ -16,7 +16,7 @@
 
 
 
-  <link href='https://fonts.googleapis.com/css?family=Lato:400,700,400italic,700italic|Roboto+Slab:400,700|Inconsolata:400,700' rel='stylesheet' type='text/css'>
+  <link href='https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700' rel='stylesheet' type='text/css'>
 
 
 
@@ -47,9 +47,7 @@
 
     <nav data-toggle="wy-nav-shift" class="wy-nav-side">
       <div class="wy-side-nav-search">
-
-          <a href="../index.html" class="fa fa-home"> Tethys Platform</a>
-
+        <a href="../index.html" class="fa fa-home"> Tethys Platform</a>
         <div role="search">
   <form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
     <input type="text" name="q" placeholder="Search docs" />
@@ -101,7 +99,7 @@
 <li class="toctree-l2"><a class="reference internal" href="../tethys_sdk/persistent_store.html">Persistent Stores API</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../tethys_sdk/spatial_persistent_store.html">Spatial Persistent Stores API</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../tethys_sdk/geoprocessing.html">Web Processing Services API</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../tethys_sdk/cloud_computing.html">Distributed Computing API !</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../tethys_sdk/cloud_computing.html">Distributed Computing API</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../tethys_sdk/tethys_cli.html">Command Line Interface</a></li>
 </ul>
 </li>
@@ -116,14 +114,13 @@
 <li class="toctree-l2"><a class="reference internal" href="../production.html#install-apache-and-dependencies">2. Install Apache and Dependencies</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../production.html#make-baseline-virtual-environment">3. Make BASELINE Virtual Environment</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../production.html#set-wsgi-python-home">4. Set WSGI Python Home</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../production.html#modify-wsgi-py-script">5. Modify <tt class="file docutils literal"><span class="pre">wsgi.py</span></tt> Script</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../production.html#make-directory-for-static-files">6. Make Directory for Static Files</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../production.html#set-secure-settings">7. Set Secure Settings</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../production.html#create-apache-site-configuration-file">8. Create Apache Site Configuration File</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../production.html#install-apps">11. Install Apps</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../production.html#setup-the-persistent-stores-for-apps">12. Setup the Persistent Stores for Apps</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../production.html#run-collect-static">13. Run Collect Static</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../production.html#enable-site-and-restart-apache">14. Enable Site and Restart Apache</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../production.html#make-directory-for-static-files">5. Make Directory for Static Files</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../production.html#set-secure-settings">6. Set Secure Settings</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../production.html#create-apache-site-configuration-file">7. Create Apache Site Configuration File</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../production.html#install-apps">8. Install Apps</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../production.html#setup-the-persistent-stores-for-apps">9. Setup the Persistent Stores for Apps</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../production.html#run-collect-static">10. Run Collect Static</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../production.html#enable-site-and-restart-apache">11. Enable Site and Restart Apache</a></li>
 </ul>
 </li>
 <li class="toctree-l1"><a class="reference internal" href="../repos.html">Source Code</a></li>
@@ -176,7 +173,7 @@
   </ul>
   <hr/>
 </div>
-          <div role="main" class="document">
+          <div role="main">
 
   <div class="section" id="docker-development-environment">
 <h1>Docker Development Environment<a class="headerlink" href="#docker-development-environment" title="Permalink to this headline">¶</a></h1>
@@ -337,7 +334,7 @@ <h2>Build Docker Images from Source<a class="headerlink" href="#build-docker-ima
 
     <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
 
-        <a href="setup_aptana.html" class="btn btn-neutral float-right" title="Using Aptana Studio 3 IDE">Next <span class="fa fa-arrow-circle-right"></span></a>
+        <a href="setup_aptana.html" class="btn btn-neutral float-right" title="Using Aptana Studio 3 IDE"/>Next <span class="fa fa-arrow-circle-right"></span></a>
 
 
         <a href="../supplementary/dev_environment.html" class="btn btn-neutral" title="Setup Development Environment !"><span class="fa fa-arrow-circle-left"></span> Previous</a>
@@ -353,8 +350,7 @@ <h2>Build Docker Images from Source<a class="headerlink" href="#build-docker-ima
     </p>
   </div>
 
-  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
-
+  <a href="https://github.com/snide/sphinx_rtd_theme">Sphinx theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>
 </footer>
         </div>
       </div>

docs/_build/html/development/setup_aptana.html

@@ -16,7 +16,7 @@
 
 
 
-  <link href='https://fonts.googleapis.com/css?family=Lato:400,700,400italic,700italic|Roboto+Slab:400,700|Inconsolata:400,700' rel='stylesheet' type='text/css'>
+  <link href='https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700' rel='stylesheet' type='text/css'>
 
 
 
@@ -47,9 +47,7 @@
 
     <nav data-toggle="wy-nav-shift" class="wy-nav-side">
       <div class="wy-side-nav-search">
-
-          <a href="../index.html" class="fa fa-home"> Tethys Platform</a>
-
+        <a href="../index.html" class="fa fa-home"> Tethys Platform</a>
         <div role="search">
   <form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
     <input type="text" name="q" placeholder="Search docs" />
@@ -101,7 +99,7 @@
 <li class="toctree-l2"><a class="reference internal" href="../tethys_sdk/persistent_store.html">Persistent Stores API</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../tethys_sdk/spatial_persistent_store.html">Spatial Persistent Stores API</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../tethys_sdk/geoprocessing.html">Web Processing Services API</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../tethys_sdk/cloud_computing.html">Distributed Computing API !</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../tethys_sdk/cloud_computing.html">Distributed Computing API</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../tethys_sdk/tethys_cli.html">Command Line Interface</a></li>
 </ul>
 </li>
@@ -116,14 +114,13 @@
 <li class="toctree-l2"><a class="reference internal" href="../production.html#install-apache-and-dependencies">2. Install Apache and Dependencies</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../production.html#make-baseline-virtual-environment">3. Make BASELINE Virtual Environment</a></li>
 <li class="toctree-l2"><a class="reference internal" href="../production.html#set-wsgi-python-home">4. Set WSGI Python Home</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../production.html#modify-wsgi-py-script">5. Modify <tt class="file docutils literal"><span class="pre">wsgi.py</span></tt> Script</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../production.html#make-directory-for-static-files">6. Make Directory for Static Files</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../production.html#set-secure-settings">7. Set Secure Settings</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../production.html#create-apache-site-configuration-file">8. Create Apache Site Configuration File</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../production.html#install-apps">11. Install Apps</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../production.html#setup-the-persistent-stores-for-apps">12. Setup the Persistent Stores for Apps</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../production.html#run-collect-static">13. Run Collect Static</a></li>
-<li class="toctree-l2"><a class="reference internal" href="../production.html#enable-site-and-restart-apache">14. Enable Site and Restart Apache</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../production.html#make-directory-for-static-files">5. Make Directory for Static Files</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../production.html#set-secure-settings">6. Set Secure Settings</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../production.html#create-apache-site-configuration-file">7. Create Apache Site Configuration File</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../production.html#install-apps">8. Install Apps</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../production.html#setup-the-persistent-stores-for-apps">9. Setup the Persistent Stores for Apps</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../production.html#run-collect-static">10. Run Collect Static</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../production.html#enable-site-and-restart-apache">11. Enable Site and Restart Apache</a></li>
 </ul>
 </li>
 <li class="toctree-l1"><a class="reference internal" href="../repos.html">Source Code</a></li>
@@ -176,7 +173,7 @@
   </ul>
   <hr/>
 </div>
-          <div role="main" class="document">
+          <div role="main">
 
   <div class="section" id="using-aptana-studio-3-ide">
 <h1>Using Aptana Studio 3 IDE<a class="headerlink" href="#using-aptana-studio-3-ide" title="Permalink to this headline">¶</a></h1>
@@ -381,7 +378,7 @@ <h3>Running Python Scripts<a class="headerlink" href="#running-python-scripts" t
 
     <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
 
-        <a href="../summary.html" class="btn btn-neutral float-right" title="Summary of References">Next <span class="fa fa-arrow-circle-right"></span></a>
+        <a href="../summary.html" class="btn btn-neutral float-right" title="Summary of References"/>Next <span class="fa fa-arrow-circle-right"></span></a>
 
 
         <a href="docker_env.html" class="btn btn-neutral" title="Docker Development Environment"><span class="fa fa-arrow-circle-left"></span> Previous</a>
@@ -397,8 +394,7 @@ <h3>Running Python Scripts<a class="headerlink" href="#running-python-scripts" t
     </p>
   </div>
 
-  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
-
+  <a href="https://github.com/snide/sphinx_rtd_theme">Sphinx theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>
 </footer>
         </div>
       </div>

docs/_build/html/features.html

@@ -16,7 +16,7 @@
 
 
 
-  <link href='https://fonts.googleapis.com/css?family=Lato:400,700,400italic,700italic|Roboto+Slab:400,700|Inconsolata:400,700' rel='stylesheet' type='text/css'>
+  <link href='https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700' rel='stylesheet' type='text/css'>
 
 
 
@@ -46,9 +46,7 @@
 
     <nav data-toggle="wy-nav-shift" class="wy-nav-side">
       <div class="wy-side-nav-search">
-
-          <a href="index.html" class="fa fa-home"> Tethys Platform</a>
-
+        <a href="index.html" class="fa fa-home"> Tethys Platform</a>
         <div role="search">
   <form id ="rtd-search-form" class="wy-form" action="search.html" method="get">
     <input type="text" name="q" placeholder="Search docs" />
@@ -100,7 +98,7 @@
 <li class="toctree-l2"><a class="reference internal" href="tethys_sdk/persistent_store.html">Persistent Stores API</a></li>
 <li class="toctree-l2"><a class="reference internal" href="tethys_sdk/spatial_persistent_store.html">Spatial Persistent Stores API</a></li>
 <li class="toctree-l2"><a class="reference internal" href="tethys_sdk/geoprocessing.html">Web Processing Services API</a></li>
-<li class="toctree-l2"><a class="reference internal" href="tethys_sdk/cloud_computing.html">Distributed Computing API !</a></li>
+<li class="toctree-l2"><a class="reference internal" href="tethys_sdk/cloud_computing.html">Distributed Computing API</a></li>
 <li class="toctree-l2"><a class="reference internal" href="tethys_sdk/tethys_cli.html">Command Line Interface</a></li>
 </ul>
 </li>
@@ -115,14 +113,13 @@
 <li class="toctree-l2"><a class="reference internal" href="production.html#install-apache-and-dependencies">2. Install Apache and Dependencies</a></li>
 <li class="toctree-l2"><a class="reference internal" href="production.html#make-baseline-virtual-environment">3. Make BASELINE Virtual Environment</a></li>
 <li class="toctree-l2"><a class="reference internal" href="production.html#set-wsgi-python-home">4. Set WSGI Python Home</a></li>
-<li class="toctree-l2"><a class="reference internal" href="production.html#modify-wsgi-py-script">5. Modify <tt class="file docutils literal"><span class="pre">wsgi.py</span></tt> Script</a></li>
-<li class="toctree-l2"><a class="reference internal" href="production.html#make-directory-for-static-files">6. Make Directory for Static Files</a></li>
-<li class="toctree-l2"><a class="reference internal" href="production.html#set-secure-settings">7. Set Secure Settings</a></li>
-<li class="toctree-l2"><a class="reference internal" href="production.html#create-apache-site-configuration-file">8. Create Apache Site Configuration File</a></li>
-<li class="toctree-l2"><a class="reference internal" href="production.html#install-apps">11. Install Apps</a></li>
-<li class="toctree-l2"><a class="reference internal" href="production.html#setup-the-persistent-stores-for-apps">12. Setup the Persistent Stores for Apps</a></li>
-<li class="toctree-l2"><a class="reference internal" href="production.html#run-collect-static">13. Run Collect Static</a></li>
-<li class="toctree-l2"><a class="reference internal" href="production.html#enable-site-and-restart-apache">14. Enable Site and Restart Apache</a></li>
+<li class="toctree-l2"><a class="reference internal" href="production.html#make-directory-for-static-files">5. Make Directory for Static Files</a></li>
+<li class="toctree-l2"><a class="reference internal" href="production.html#set-secure-settings">6. Set Secure Settings</a></li>
+<li class="toctree-l2"><a class="reference internal" href="production.html#create-apache-site-configuration-file">7. Create Apache Site Configuration File</a></li>
+<li class="toctree-l2"><a class="reference internal" href="production.html#install-apps">8. Install Apps</a></li>
+<li class="toctree-l2"><a class="reference internal" href="production.html#setup-the-persistent-stores-for-apps">9. Setup the Persistent Stores for Apps</a></li>
+<li class="toctree-l2"><a class="reference internal" href="production.html#run-collect-static">10. Run Collect Static</a></li>
+<li class="toctree-l2"><a class="reference internal" href="production.html#enable-site-and-restart-apache">11. Enable Site and Restart Apache</a></li>
 </ul>
 </li>
 <li class="toctree-l1"><a class="reference internal" href="repos.html">Source Code</a></li>
@@ -171,7 +168,7 @@
   </ul>
   <hr/>
 </div>
-          <div role="main" class="document">
+          <div role="main">
 
   <div class="section" id="features">
 <h1>Features<a class="headerlink" href="#features" title="Permalink to this headline">¶</a></h1>
@@ -254,7 +251,7 @@ <h2>Computing<a class="headerlink" href="#computing" title="Permalink to this he
 </div>
 <div class="admonition note">
 <p class="first admonition-title">Note</p>
-<p class="last">To learn more, read the <a class="reference internal" href="tethys_sdk/cloud_computing.html"><em>Distributed Computing API !</em></a>.</p>
+<p class="last">To learn more, read the <a class="reference internal" href="tethys_sdk/cloud_computing.html"><em>Distributed Computing API</em></a>.</p>
 </div>
 </div>
 <div class="section" id="production-ready">
@@ -297,7 +294,7 @@ <h2>Acknowledgements<a class="headerlink" href="#acknowledgements" title="Permal
 
     <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
 
-        <a href="installation.html" class="btn btn-neutral float-right" title="Installation">Next <span class="fa fa-arrow-circle-right"></span></a>
+        <a href="installation.html" class="btn btn-neutral float-right" title="Installation"/>Next <span class="fa fa-arrow-circle-right"></span></a>
 
 
         <a href="index.html" class="btn btn-neutral" title="Tethys Platform"><span class="fa fa-arrow-circle-left"></span> Previous</a>
@@ -313,8 +310,7 @@ <h2>Acknowledgements<a class="headerlink" href="#acknowledgements" title="Permal
     </p>
   </div>
 
-  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
-
+  <a href="https://github.com/snide/sphinx_rtd_theme">Sphinx theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>
 </footer>
         </div>
       </div>