🔧 Moving the Data Science content into Python4DataScience

* /docs/first-steps/index.html -> /notebook/index.html
* /docs/first-steps/create-notebook.html -> /notebook/create-notebook.html
* /docs/first-steps/install.html -> /notebook/install.html
* /docs/workspace/jupyter/$rest -> /
* /docs/workspace/first-steps/$rest -> /notebook/
* /docs/workspace/ipython/$rest -> Python4DataScience/docs/workspace/ipython/
* /docs/workspace/numpy/$rest -> Python4DataScience/docs/workspace/numpy/
* /docs/workspace/pandas/$rest -> Python4DataScience/docs/workspace/pandas/
* docs/data-processing/
* docs/clean-prep
* docs/parameterise/$rest -> docs/notebook/parameterise/
* docs/performance/ipyparallel//$rest -> docs/hub/ipyparallel/
* docs/performance/ -> Python4DataScience/docs/performance/
* docs/productive/ -> Python4DataScience/docs/productive/
* docs/testing/$rest ->  docs/notebook/testing/
* docs/web/dashboards/$rest ->  docs/dashboards/

README.rst

@@ -44,46 +44,30 @@ Installation
        creating: jupyter-tutorial-main/
     …
 
-#. Edit the ``Pipfile`` in the unpacked archive and enter your current Python version in this section:
-
-  .. code-block:: console
-
-    [requires]
-    python_version = ""
-
-#. Install Pipenv
-
-   Refer to :doc:`Install Pipenv </productive/envs/pipenv/install>`
-
 #. Install Python packages:
 
    .. code-block:: console
 
     $ cd jupyter-tutorial-main
-    $ pipenv install
-    Creating a virtualenv for this project…
-    …
-    Installing dependencies from Pipfile.lock (fbb457)…
-    …
-    $ pipenv run jupyter nbextension enable highlighter/highlighter
-        Enabling notebook extension highlighter/highlighter...
-              - Validating: OK
+    $ python3 -m venv .
+    $ . bin/activate
+    $ python -m pip install -r docs/requirements.txt
 
 #. Install the `Jupyter Notebook Extensions
    <https://jupyter-contrib-nbextensions.readthedocs.io/>`_ Javascript and CSS
    files:
 
    .. code-block:: console
 
-    $ pipenv run jupyter contrib nbextension install --user
+    $ jupyter contrib nbextension install --user
     jupyter contrib nbextension install --user
     Installing jupyter_contrib_nbextensions nbextension files to jupyter data directory
     …
     Successfully installed jupyter-contrib-core-0.3.3 jupyter-contrib-nbextensions-0.5.1
     jupyter-highlight-selected-word-0.2.0 jupyter-latex-envs-1.4.6
     jupyter-nbextensions-configurator-0.4.1
     …
-    $ pipenv run jupyter nbextension enable latex_envs --user --py
+    $ jupyter nbextension enable latex_envs --user --py
     Enabling notebook extension latex_envs/latex_envs...
           - Validating: OK
 
@@ -93,16 +77,14 @@ Installation
 
    .. code-block:: console
 
-    $  sudo apt-get install pandoc
+    $  sudo apt install pandoc
 
-    To create the HTML documentation run these commands:
+   To create the HTML documentation run these commands:
 
    .. code-block:: console
 
-    $ python3 -m venv .
-    $ bin/python -m pip install --upgrade pip
-    $ bin/python -m pip install -r docs/constraints.txt
-    $ bin/sphinx-build -ab html docs/ docs/_build/
+    $ cd docs/
+    $ make html
 
 #. Create a PDF:
 
@@ -112,7 +94,7 @@ Installation
 
    .. code-block:: console
 
-    $ sudo apt-get install texlive-latex-recommended texlive-latex-extra texlive-fonts-recommended latexmk
+    $ sudo apt install texlive-latex-recommended texlive-latex-extra texlive-fonts-recommended latexmk
 
    or for macOS with:
 
@@ -131,8 +113,7 @@ Installation
 
    .. code-block:: console
 
-    $ cd docs/
-    $ pipenv run make latexpdf
+    $ make latexpdf
     …
     The LaTeX files are in _build/latex.
     Run 'make' in that directory to run these through (pdf)latex
@@ -162,8 +143,7 @@ Installation
 
    .. code-block:: console
 
-    $ cd jupyter-tutorial
-    $ vale docs/
+    $ vale .
     ✔ 0 errors, 0 warnings and 0 suggestions in 201 files.
 
 .. _follow-us:

docs/conf.py

@@ -161,6 +161,10 @@
         "https://python-basics-tutorial.readthedocs.io/en/latest/",
         None,
     ),
+    "python4datascience": (
+        "https://python4datascience.readthedocs.io/en/latest/",
+        None,
+    ),
 }
 
 

docs/workspace/jupyter/hub/index.rst → docs/hub/index.rst

@@ -14,3 +14,4 @@ Jupyter Notebooks and which acts as a proxy.
     config
     systemdspawner
     nbviewer-service
+    ipyparallel/index