Kentzo / jupyter-tutorial

Training materials for setting up and using a research infrastructure based on Jupyter notebooks: https://cusy.io/en/seminars

Quick start

Status

Installation

1. Download and unpack:

   $ curl -O https://codeload.github.com/veit/jupyter-tutorial/zip/main
   $ unzip main
   Archive:  main
   …
      creating: jupyter-tutorial-main/
   …

2. Edit the Pipfile in the unpacked archive and enter your current Python version in this section:

[requires]
python_version = ""

1. Install Pipenv

   Refer to :doc:`Install Pipenv </productive/envs/pipenv/install>`

2. Install Python packages:

   $ 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

3. Install the Jupyter Notebook Extensions Javascript and CSS files:

   $ pipenv run 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
   Enabling notebook extension latex_envs/latex_envs...
         - Validating: OK

4. Create HTML documentation:

   Note that pandoc has to be installed. On Debian/Ubuntu you can just run

   $  sudo apt-get install pandoc
   
   To create the HTML documentation run these commands:

   $ 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/

5. Create a PDF:

   For the creation of a PDF file you need additional packages.

   For Debian/Ubuntu you get them with the following command:

   $ sudo apt-get install texlive-latex-recommended texlive-latex-extra texlive-fonts-recommended latexmk

   or for macOS with:

   $ brew cask install mactex
   …
   🍺  mactex was successfully installed!
   $ curl --remote-name https://www.tug.org/fonts/getnonfreefonts/install-getnonfreefonts
   $ sudo texlua install-getnonfreefonts
   …
   mktexlsr: Updating /usr/local/texlive/2020/texmf-dist/ls-R...
   mktexlsr: Done.

   Then you can generate a PDF with:

   $ cd docs/
   $ pipenv run make latexpdf
   …
   The LaTeX files are in _build/latex.
   Run 'make' in that directory to run these through (pdf)latex
   …

   You can find the PDF at docs/_build/latex/jupytertutorial.pdf.

6. Install vnd run ale to check spelling

   You can install Vale with:

   $ brew install vale

   You can install the parser for Restructuredtext with:

   $ brew install docutils

   .. seealso::
      * `Vale installation <https://docs.errata.ai/vale/install>`_
      * `Vale formats <https://docs.errata.ai/vale/scoping#formats>`_
   
   

   Now you can check the RestructuredText files with:

   $ cd jupyter-tutorial
   $ vale docs/
   ✔ 0 errors, 0 warnings and 0 suggestions in 201 files.

Follow us

• GitHub
• Twitter
• Mastodon

Pull-Requests

If you have suggestions for improvements and additions, I recommend that you create a Fork of my GitHub Repository and make your changes there. . You are also welcome to make a pull request. If the changes contained therein are small and atomic, I’ll be happy to look at your suggestions.