Erste Schritte#
:
Installation#
Herunterladen und Auspacken:
$ curl -O https://codeload.github.com/veit/jupyter-tutorial-de/zip/main $ unzip main Archive: main … creating: jupyter-tutorial-de-main/ …
Installieren der Python-Pakete
$ cd jupyter-tutorial-main $ pipenv install Creating a virtualenv for this project… …
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
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/
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
.