From 6c329ad9c35de5a397e8726451332c2734ad5d59 Mon Sep 17 00:00:00 2001 From: Steven Silvester Date: Mon, 3 Feb 2020 10:24:58 -0600 Subject: [PATCH 1/2] Add changelog entry for jupyterhub --- docs/source/getting_started/changelog.rst | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/source/getting_started/changelog.rst b/docs/source/getting_started/changelog.rst index e70cd6fe18f1..1a0cf4f84d32 100644 --- a/docs/source/getting_started/changelog.rst +++ b/docs/source/getting_started/changelog.rst @@ -24,6 +24,7 @@ User-facing changes * Support for output search in notebooks (`#7258 `__) * Add commands to move to next/prev tab bar in shell (`#7673 `__) * Simplify user experience when selecting "No Kernel" for notebook (`#7647 `__) +* JupyterHub users should use ``c.Spawner.default_url = '/lab'`` instead of deprecated ``labhubapp`` (`#7724 `__) * Drop support for Vega 4 and Vega-lite 2 rendering (`#7650 `__, `#7523 `__) * Extra flags options for ``jupyter lab clean`` (`#7583 `__) * Global track timing setting for notebooks (`#7578 `__) @@ -37,12 +38,15 @@ User-facing changes For developers ^^^^^^^^^^^^^^ +Backward incompatible changes: * Switch from ``@phosphor`` to ``@lumino`` dependencies. (`#7582 `__, `#7534 `__) * Factor out the ``settingsregistry`` and ``statedb`` packages from coreutils (`#7681 `__, `#7615 `__) * Rework services architecture (sessions, kernels, terminals). Rename ``ClientSession`` to ``SessionContext`` (`#7252 `__, `#7674 `__) * Upgrade to TypeScript 3.7 (`#7522 `__) * Remove ``polling`` from coreutils in favor for ``@lumino/polling`` (`#7617 `__) * TypeScript strict null checking in core packages (`#7657 `__, `#7607 `__) + +Other changes: * New property inspector used to display the properties of the currently selected main area widget (`#7665 `__, `#7664 `__, `#7718 `__, `#7686 `__) * Allow metadata for launcher items (`#7654 `__, `#7652 `__) * Enable platform-aware key shortcuts (`#7589 `__) From 7e308c4e9ae20035dfffa1d03e325174053d5a0d Mon Sep 17 00:00:00 2001 From: Steven Silvester Date: Mon, 3 Feb 2020 10:31:00 -0600 Subject: [PATCH 2/2] Add JupyterHub note to installation and clean up change log --- docs/source/getting_started/changelog.rst | 6 ++++-- docs/source/getting_started/installation.rst | 14 ++++++++++++++ 2 files changed, 18 insertions(+), 2 deletions(-) diff --git a/docs/source/getting_started/changelog.rst b/docs/source/getting_started/changelog.rst index 1a0cf4f84d32..374062e36c09 100644 --- a/docs/source/getting_started/changelog.rst +++ b/docs/source/getting_started/changelog.rst @@ -38,7 +38,8 @@ User-facing changes For developers ^^^^^^^^^^^^^^ -Backward incompatible changes: +Backward incompatible changes +----------------------------- * Switch from ``@phosphor`` to ``@lumino`` dependencies. (`#7582 `__, `#7534 `__) * Factor out the ``settingsregistry`` and ``statedb`` packages from coreutils (`#7681 `__, `#7615 `__) * Rework services architecture (sessions, kernels, terminals). Rename ``ClientSession`` to ``SessionContext`` (`#7252 `__, `#7674 `__) @@ -46,7 +47,8 @@ Backward incompatible changes: * Remove ``polling`` from coreutils in favor for ``@lumino/polling`` (`#7617 `__) * TypeScript strict null checking in core packages (`#7657 `__, `#7607 `__) -Other changes: +Other changes +------------- * New property inspector used to display the properties of the currently selected main area widget (`#7665 `__, `#7664 `__, `#7718 `__, `#7686 `__) * Allow metadata for launcher items (`#7654 `__, `#7652 `__) * Enable platform-aware key shortcuts (`#7589 `__) diff --git a/docs/source/getting_started/installation.rst b/docs/source/getting_started/installation.rst index 700238cdf31c..ddaa8fe3c158 100644 --- a/docs/source/getting_started/installation.rst +++ b/docs/source/getting_started/installation.rst @@ -85,6 +85,17 @@ the version of the ``notebook`` package that you have installed: jupyter notebook --version + +Usage with JupyterHub +~~~~~~~~~~~~~~~~~~~~~ + +Install JupyterLab and JupyterHub. + +In ``jupyterhub_config.py``, configure the ``Spawner`` to tell the single-user notebook servers to default to JupyterLab: + +``c.Spawner.default_url = '/lab'`` + + Supported browsers ~~~~~~~~~~~~~~~~~~ @@ -101,3 +112,6 @@ minimum versions listed above. IE 11+ or Edge 14 do not support CSS Variables, and are not directly supported at this time. A tool like `postcss `__ can be used to convert the CSS files in the ``jupyterlab/build`` directory manually if desired. + + +