``nbviewer``
============

`nbviewer <https://github.com/jupyter/nbviewer>`_
    :doc:`nbconvert` als Web-Service: Rendert Jupyter Notebooks als statische
    Webseiten.

Installation
------------

#. Der Notebook Viewer benötigt mehrere Binärpakete, die auf unserem System
   installiert werden müssen:

.. tab:: Debian/Ubuntu

    .. code-block:: console

        $ sudo apt install libmemcached-dev libcurl4-openssl-dev pandoc libevent-dev

.. tab:: macOS

    .. code-block:: console

        $ brew install libmemcached openssl pandoc libevent

#. Anschließend kann der Jupyter Notebook Viewer in einer neuen virtuellen
   Umgebung installiert werden mit:

   .. code-block:: console

      $ mkdir nbviewer
      $ cd !$
      cd nbviewer

   Nun kann dann auch ``nbviewer`` installiert werden:

   .. code-block:: console

      $ uv add nbviewer

#. Zum Testen kann der Server gestartet werden mit:

   .. code-block:: console

      $ uv run python -m nbviewer --debug --no-cache

Erweitern des Notebook-Viewers
------------------------------

Der Notebook-Viewer lässt sich um Provider erweitern, :abbr:`s. (siehe)`
`Extending the Notebook Viewer
<https://github.com/jupyter/nbviewer#extending-the-notebook-viewer>`_.


Zugriffsbeschränkung
--------------------

Wenn der Viewer als :doc:`hub/nbviewer-service` ausgeführt wird, können
nur Benutzer, die sich am JupyterHub authentifiziert haben, auf die
Notebooks des ``nbviewer`` zugreifen.