From b427cf204e6eacae6c04b5f3910ec8171c830496 Mon Sep 17 00:00:00 2001 From: Jeremy Tuloup Date: Wed, 23 Oct 2024 09:25:42 +0000 Subject: [PATCH 1/5] Add user facing changelog for `7.3.0` --- CHANGELOG.md | 58 ++++++++++++++++++++++++++++++++++------------------ 1 file changed, 38 insertions(+), 20 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 51fc2def55..3138df19e3 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -12,33 +12,23 @@ upgrading `notebook`. Use `pip install pip --upgrade` to upgrade pip. Check pip version with `pip --version`. -## v7.2 +## 7.3 -Jupyter Notebook 7.2 is based on JupyterLab 4.2, and includes a number of new features, bug fixes, and enhancements for extension developers. This release is compatible with extensions supporting JupyterLab 4.0. Extension authors are recommended to consult the [Extension Migration Guide](https://jupyterlab.readthedocs.io/en/latest/extension/extension_migration.html#jupyterlab-4-0-to-4-1) which lists deprecations and changes to the public API. - -Below are a few highlights for this new release. Most of the new features and improvements come from the update to JupyterLab 4.2, although they are not all supported in Notebook 7.2. +### Full Width Notebook -For reference you may have a look at the JupyterLab 4.2 changelog to learn more: https://jupyterlab.readthedocs.io/en/latest/getting_started/changelog.html#v4-2 +It is now possible to configure the notebook to take up the full width of the page via: -### Full notebook windowing mode by default +- a setting that can be defined by a user via the Settings Editor +- the `View > Enable Full Width Notebook` menu entry +- the command palette, searching for `Enable Full Width Notebook` -Notebooks in the `full` windowing mode only render the visible cells, significantly improving the performance of the application. One limitation of `full` mode is that the search function in your browser may produce false negatives; using the search function is recommended. To revert to the behaviour from Notebook 7.2, go to Settings → Settings Editor → Notebook, scroll to “Windowing mode”, and choose `defer`. +![a screenshot showing how to enable full width notebook via the menu](https://github.com/user-attachments/assets/148b227a-874a-4bb3-a4c6-c7350525ccc4) -### Improved Shortcuts Editor +This is particularly useful on large displays, or for those who prefer working with a wider notebook. -Among the numerous improvements and bug fixes for the keyboard shortcuts editor: +It is also still possible to use the JupyterLab interface for a more fully-featured interface, which allows for full-width notebooks too, and offers a "Simple Interface" mode for only showing a single notebook at a time. -- it is now possible to remove the default shortcuts, -- shortcuts are correctly sorted when using a language pack, -- shortcuts with different arguments are now correctly displayed as individual entries. - -A context menu opened over a keybinding in the Keyboard Shortcuts setting panel within the Settings widget - -### Dark high contrast theme - -A new theme, JupyterLab Dark High Contrast, which is intended to benefit users with the need for higher contrast, following the WCAG AAA accessibility standard for color contrast. To select this theme, from the menu bar, choose Settings → Theme → JupyterLab Dark High Contrast. Please provide feedback and suggestions on further improvements to this theme. - -A dark high contrast theme +You can open JupyterLab by clicking on `View > Open JupyterLab`. @@ -114,6 +104,34 @@ A new theme, JupyterLab Dark High Contrast, which is intended to benefit users w [@bluestealth](https://github.com/search?q=repo%3Ajupyter%2Fnotebook+involves%3Abluestealth+updated%3A2024-05-16..2024-05-31&type=Issues) | [@github-actions](https://github.com/search?q=repo%3Ajupyter%2Fnotebook+involves%3Agithub-actions+updated%3A2024-05-16..2024-05-31&type=Issues) | [@JasonWeill](https://github.com/search?q=repo%3Ajupyter%2Fnotebook+involves%3AJasonWeill+updated%3A2024-05-16..2024-05-31&type=Issues) | [@jtpio](https://github.com/search?q=repo%3Ajupyter%2Fnotebook+involves%3Ajtpio+updated%3A2024-05-16..2024-05-31&type=Issues) | [@martinRenou](https://github.com/search?q=repo%3Ajupyter%2Fnotebook+involves%3AmartinRenou+updated%3A2024-05-16..2024-05-31&type=Issues) +## 7.2 + +Jupyter Notebook 7.2 is based on JupyterLab 4.2, and includes a number of new features, bug fixes, and enhancements for extension developers. This release is compatible with extensions supporting JupyterLab 4.0. Extension authors are recommended to consult the [Extension Migration Guide](https://jupyterlab.readthedocs.io/en/latest/extension/extension_migration.html#jupyterlab-4-0-to-4-1) which lists deprecations and changes to the public API. + +Below are a few highlights for this new release. Most of the new features and improvements come from the update to JupyterLab 4.2, although they are not all supported in Notebook 7.2. + +For reference you may have a look at the JupyterLab 4.2 changelog to learn more: https://jupyterlab.readthedocs.io/en/latest/getting_started/changelog.html#v4-2 + +### Full notebook windowing mode by default + +Notebooks in the `full` windowing mode only render the visible cells, significantly improving the performance of the application. One limitation of `full` mode is that the search function in your browser may produce false negatives; using the search function is recommended. To revert to the behaviour from Notebook 7.2, go to Settings → Settings Editor → Notebook, scroll to “Windowing mode”, and choose `defer`. + +### Improved Shortcuts Editor + +Among the numerous improvements and bug fixes for the keyboard shortcuts editor: + +- it is now possible to remove the default shortcuts, +- shortcuts are correctly sorted when using a language pack, +- shortcuts with different arguments are now correctly displayed as individual entries. + +A context menu opened over a keybinding in the Keyboard Shortcuts setting panel within the Settings widget + +### Dark high contrast theme + +A new theme, JupyterLab Dark High Contrast, which is intended to benefit users with the need for higher contrast, following the WCAG AAA accessibility standard for color contrast. To select this theme, from the menu bar, choose Settings → Theme → JupyterLab Dark High Contrast. Please provide feedback and suggestions on further improvements to this theme. + +A dark high contrast theme + ## 7.2.0 ([Full Changelog](https://github.com/jupyter/notebook/compare/@jupyter-notebook/application-extension@7.1.2...31bf294e85175bbf39816a90dc8858dedaf73bde)) From fa60fb559d9c8d07b86b4beb707d1e1550b0f913 Mon Sep 17 00:00:00 2001 From: Jeremy Tuloup Date: Wed, 23 Oct 2024 12:58:40 +0000 Subject: [PATCH 2/5] add more content --- CHANGELOG.md | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 3138df19e3..82b78996be 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -14,6 +14,41 @@ Use `pip install pip --upgrade` to upgrade pip. Check pip version with ## 7.3 +## Minimap + +The virtual scrollbar now acts as a minimap and exposes information on whether a cell: + +- is running/scheduled (`[*]`), idle (`[ ]`) or was already run (e.g. `[1]`) +- was modified since it was last executed (“dirty”) - orange background +- has an output that contains an error - red background +- is markdown/code (`[ ]`/`[*]`/`[1]` for code, nothing for markdown) +- how much text/code it contains + +![a screenshot showing the notebook minimap](https://raw.githubusercontent.com/jupyterlab/jupyterlab/main/docs/source/getting_started/changelog_assets/4.3-minimap.png) + +To enable the minimap, click on the hamburger icon (≡) which appears in the notebook’s toolbar. If you do not see the hamburger icon, go to `Settings → Notebook → Windowing mode` and choose “full”. + +## File browser enhancements + +The file browser now: + +- supports resizing the columns and remembers the column sizes after reloading JupyterLab +- supports uploading folders by drag-and-drop +- supports navigation with a single click (opt-in) +- adds a file filter collapsed by default (funnel icon) + +![a screenshot showing that it's now possible to resize the file browser columns](https://github.com/user-attachments/assets/b0d9cd0a-2828-43f7-a922-e8b271e5f7fc) + +## Improved kernel and server interactions + +The previous release enabled connecting to external kernels, such as those spawned by a third-party application like Blender. In this release the kernel selector dialog was improved to also show the external kernels. + +The previous release improved the awareness of the kernel/kernel specification distinction by providing both tree and list view in the kernels sidebar panel, but only the tree view featured the kernel identifiers. In this release both the list and tree view show the kernel identifier stub. + +A new toolbar button was added in the kernel allowing to shut down unused kernels (kernels with no widget attached). + +![a screenshot showing the list view of the kernels in the sidebar](https://github.com/user-attachments/assets/c7f958c5-4054-4b09-8fad-4df6db8c9b58) + ### Full Width Notebook It is now possible to configure the notebook to take up the full width of the page via: From 33f213123a6086cedc20f415af78eca51feb1090 Mon Sep 17 00:00:00 2001 From: Jeremy Tuloup Date: Wed, 23 Oct 2024 13:14:23 +0000 Subject: [PATCH 3/5] fix headings --- CHANGELOG.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 82b78996be..69fd87dad1 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -14,7 +14,7 @@ Use `pip install pip --upgrade` to upgrade pip. Check pip version with ## 7.3 -## Minimap +### Minimap The virtual scrollbar now acts as a minimap and exposes information on whether a cell: @@ -28,7 +28,7 @@ The virtual scrollbar now acts as a minimap and exposes information on whether a To enable the minimap, click on the hamburger icon (≡) which appears in the notebook’s toolbar. If you do not see the hamburger icon, go to `Settings → Notebook → Windowing mode` and choose “full”. -## File browser enhancements +### File browser enhancements The file browser now: @@ -39,7 +39,7 @@ The file browser now: ![a screenshot showing that it's now possible to resize the file browser columns](https://github.com/user-attachments/assets/b0d9cd0a-2828-43f7-a922-e8b271e5f7fc) -## Improved kernel and server interactions +### Improved kernel and server interactions The previous release enabled connecting to external kernels, such as those spawned by a third-party application like Blender. In this release the kernel selector dialog was improved to also show the external kernels. From a846395f9920c976699bd1b3ebf45d00d8ca4453 Mon Sep 17 00:00:00 2001 From: Jeremy Tuloup Date: Wed, 23 Oct 2024 15:37:18 +0200 Subject: [PATCH 4/5] Update CHANGELOG.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Michał Krassowski <5832902+krassowski@users.noreply.github.com> --- CHANGELOG.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 69fd87dad1..17b7fb2a28 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -61,7 +61,7 @@ It is now possible to configure the notebook to take up the full width of the pa This is particularly useful on large displays, or for those who prefer working with a wider notebook. -It is also still possible to use the JupyterLab interface for a more fully-featured interface, which allows for full-width notebooks too, and offers a "Simple Interface" mode for only showing a single notebook at a time. +It is also possible to use the JupyterLab interface for a more fully-featured experience, which allows for full-width notebooks too, and offers a "Simple Interface" mode for only showing a single notebook at a time. You can open JupyterLab by clicking on `View > Open JupyterLab`. From f1fefb103e1f80328e392c8a67b7367141ab2b52 Mon Sep 17 00:00:00 2001 From: Jeremy Tuloup Date: Wed, 23 Oct 2024 14:23:42 +0000 Subject: [PATCH 5/5] mention JupyterLab 4.3 in the changelog --- CHANGELOG.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 17b7fb2a28..412836d758 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -14,6 +14,12 @@ Use `pip install pip --upgrade` to upgrade pip. Check pip version with ## 7.3 +Jupyter Notebook 7.3 is based on JupyterLab 4.3, and includes a number of new features, bug fixes, and enhancements for extension developers. This release is compatible with extensions supporting JupyterLab 4.0. Extension authors are recommended to consult the [Extension Migration Guide](https://jupyterlab.readthedocs.io/en/latest/extension/extension_migration.html#jupyterlab-4-2-to-4-3) which lists deprecations and changes to the public API. + +Below are a few highlights for this new release. Most of the new features and improvements come from the update to JupyterLab 4.3, although they may not all be supported in Notebook 7.3. + +For reference you may have a look at the JupyterLab 4.3 changelog to learn more: https://jupyterlab.readthedocs.io/en/latest/getting_started/changelog.html#v4-3 + ### Minimap The virtual scrollbar now acts as a minimap and exposes information on whether a cell: