Erste Schritte

:

Installation

1. Herunterladen und Auspacken:

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

2. Installieren der Python-Pakete

   $ cd jupyter-tutorial-main
   $ pipenv install
   Creating a virtualenv for this project…
   …
   

3. Installieren der Jupyter Notebook Extensions:

   $ 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. HTML-Dokumentation erstellen:

   $ 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. PDF erstellen:

   Für die Erstellung von PDFs benötigt ihr weitere Pakete.

   Für Debian/Ubuntu erhaltet ihr diese mit:

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

   oder für macOS mit:

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

   Anschließend könnt ihr ein PDF generieren mit:

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

   Das PDF findet ihr anschließend in docs/_build/latex/jupytertutorial.pdf.