diff --git a/.binder/README b/.binder/README index f445232916..b373649ece 100644 --- a/.binder/README +++ b/.binder/README @@ -1,10 +1,10 @@ This directory holds configuration files for https://mybinder.org/. The interactive notebooks can be accessed with this link: -https://mybinder.org/v2/gh/jupyter-widgets/ipywidgets/master?filepath=docs/source/examples +https://mybinder.org/v2/gh/jupyter-widgets/ipywidgets/main?filepath=docs/source/examples -To check out a different version, just replace "master" with the desired +To check out a different version, just replace `main` with the desired branch/tag name or commit hash. To use JupyterLab, use: -https://mybinder.org/v2/gh/jupyter-widgets/ipywidgets/master?urlpath=lab/tree/docs/source/examples +https://mybinder.org/v2/gh/jupyter-widgets/ipywidgets/main?urlpath=lab/tree/docs/source/examples diff --git a/.github/workflows/binder-on-pr.yml b/.github/workflows/binder-on-pr.yml index 3693330d9a..6e56aaa482 100644 --- a/.github/workflows/binder-on-pr.yml +++ b/.github/workflows/binder-on-pr.yml @@ -18,7 +18,7 @@ jobs: script: | var PR_HEAD_USERREPO = process.env.PR_HEAD_USERREPO; var PR_HEAD_REF = process.env.PR_HEAD_REF; - github.issues.createComment({ + github.rest.issues.createComment({ issue_number: context.issue.number, owner: context.repo.owner, repo: context.repo.repo, diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index 142f6358a9..06a67de95c 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -2,7 +2,7 @@ name: Build jupyterlab_widgets on: push: - branches: master + branches: main pull_request: branches: '*' diff --git a/.github/workflows/devinstall.yml b/.github/workflows/devinstall.yml index 10093fb686..3451711e93 100644 --- a/.github/workflows/devinstall.yml +++ b/.github/workflows/devinstall.yml @@ -2,7 +2,7 @@ name: Run the dev-install script on: push: - branches: master + branches: main pull_request: branches: '*' diff --git a/.github/workflows/packaging.yml b/.github/workflows/packaging.yml index 22bd940acf..79381df58e 100644 --- a/.github/workflows/packaging.yml +++ b/.github/workflows/packaging.yml @@ -2,7 +2,8 @@ name: Packaging on: push: - branches: [master] + branches: + - main pull_request: branches: '*' diff --git a/README.md b/README.md index 7ead6d6bdb..0f413911e8 100644 --- a/README.md +++ b/README.md @@ -2,13 +2,13 @@ | Purpose | Badges | | ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **Latest (master: future 8.0)** | [![Test Status](https://github.com/jupyter-widgets/ipywidgets/actions/workflows/tests.yml/badge.svg?query=branch%3Amaster)](https://github.com/jupyter-widgets/ipywidgets/actions?query=branch%3Amaster) [![Documentation Status: latest](https://img.shields.io/readthedocs/ipywidgets?logo=read-the-docs)](https://ipywidgets.readthedocs.io/en/latest/?badge=latest) [![Binder:master](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/jupyter-widgets/ipywidgets/master?urlpath=lab/tree/docs%2Fsource%2Fexamples) | +| **Latest (`main`: future 8.0)** | [![Test Status](https://github.com/jupyter-widgets/ipywidgets/actions/workflows/tests.yml/badge.svg?query=branch%3Amain)](https://github.com/jupyter-widgets/ipywidgets/actions?query=branch%3Amain) [![Documentation Status: latest](https://img.shields.io/readthedocs/ipywidgets?logo=read-the-docs)](https://ipywidgets.readthedocs.io/en/latest/?badge=latest) [![Binder:main](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/jupyter-widgets/ipywidgets/main?urlpath=lab/tree/docs%2Fsource%2Fexamples) | | **Stable** | [![Version](https://img.shields.io/pypi/v/ipywidgets.svg?logo=pypi)](https://pypi.python.org/pypi/ipywidgets) [![Conda Version](https://img.shields.io/conda/vn/conda-forge/ipywidgets.svg?logo=conda-forge)](https://anaconda.org/conda-forge/ipywidgets) [![Documentation Status](https://img.shields.io/readthedocs/ipywidgets?logo=read-the-docs)](https://ipywidgets.readthedocs.io/en/stable/?badge=stable) [![Binder:7.x](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/jupyter-widgets/ipywidgets/7.x?urlpath=lab/tree/docs%2Fsource%2Fexamples) | | **Communication** | [![Join the chat at https://gitter.im/ipython/ipywidgets](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/jupyter-widgets/Lobby) [![Discourse](https://img.shields.io/badge/help_forum-discourse-blue?logo=discourse)](https://discourse.jupyter.org/c/widgets/46) | | | | **ipywidgets**, also known as jupyter-widgets or simply widgets, are -[interactive HTML widgets](https://github.com/jupyter-widgets/ipywidgets/blob/master/docs/source/examples/Index.ipynb) +[interactive HTML widgets](https://github.com/jupyter-widgets/ipywidgets/blob/main/docs/source/examples/Index.ipynb) for Jupyter notebooks and the IPython kernel. Notebooks come alive when interactive widgets are used. Users gain control of @@ -21,7 +21,7 @@ ipywidgets to your notebooks, and we're here to help you get started. ## Core Interactive Widgets The fundamental widgets provided by this library are called core interactive -widgets. A [demonstration notebook](https://github.com/jupyter-widgets/ipywidgets/blob/master/docs/source/examples/Index.ipynb) +widgets. A [demonstration notebook](https://github.com/jupyter-widgets/ipywidgets/blob/main/docs/source/examples/Index.ipynb) provides an overview of the core interactive widgets, including: - sliders @@ -87,14 +87,14 @@ see the detailed [developer install](docs/source/dev_install.md) instructions. If you want to install ipywidgets from source, **you will need the [yarn](https://yarnpkg.com/) package manager version 1.2.1 or later**. -To install the latest master version from the root directory of the source +To install the latest `main` version from the root directory of the source code, run `dev-install.sh`. To only build the Python package enter `pip install -e .`. ## Usage See the [examples](docs/source/examples.md) section of the documentation. The widgets are being used in a variety of ways; some uses can be seen in these notebooks: -[Demo notebook of interactive widgets](https://github.com/jupyter-widgets/ipywidgets/blob/master/docs/source/examples/Index.ipynb) +[Demo notebook of interactive widgets](https://github.com/jupyter-widgets/ipywidgets/blob/main/docs/source/examples/Index.ipynb) ## Change log @@ -106,13 +106,13 @@ Refer to change log for more detail. | ipywidgets | JupyterLab | [Classic Notebook](https://github.com/jupyter/notebook) | [nbclassic](https://github.com/jupyterlab/nbclassic) | | ---------- | :--------: | :-----------------------------------------------------: | :--------------------------------------------------: | -| master | | - | TBD | -| 7.6.3 | | | 0.2.6 | +| `main` | | - | TBD | +| `7.6.3` | | | 0.2.6 | | **Legacy** | | | | -| 6.x | | | - | -| 5.x | | 4.2 | - | -| 4.1.x | | 4.1 | - | -| 4.0.x | | 4.0 | - | +| `6.x` | | | - | +| `5.x` | | 4.2 | - | +| `4.1.x` | | 4.1 | - | +| `4.0.x` | | 4.0 | - | ## Contributing to ipywidgets diff --git a/docs/lite/jupyter_lite_config.json b/docs/lite/jupyter_lite_config.json index 3c450c8afd..0084492c6b 100644 --- a/docs/lite/jupyter_lite_config.json +++ b/docs/lite/jupyter_lite_config.json @@ -5,11 +5,13 @@ "Layout Templates\\.ipynb", "Variable Inspector\\.ipynb" ], - "contents": ["../source/examples"], + "contents": ["../source/examples"] + }, + "PipliteAddon": { "piplite_urls": [ - "../python/ipywidgets/dist", - "../python/widgetsnbextension/dist", - "../python/jupyterlab_widgets/dist" + "../../python/ipywidgets/dist", + "../../python/widgetsnbextension/dist", + "../../python/jupyterlab_widgets/dist" ] } } diff --git a/docs/source/_static/theme.css b/docs/source/_static/theme.css index f851ae6659..dca8dfe4e5 100644 --- a/docs/source/_static/theme.css +++ b/docs/source/_static/theme.css @@ -1,9 +1,31 @@ -.demo-sidebar .demo-title { - font-size: var(--pst-sidebar-header-font-size); - font-weight: var(--pst-sidebar-header-font-weight); - margin-bottom: 0.5rem; -} - +/* index */ table.indextable tr.cap { background-color: var(--pst-color-on-background) !important; } + +/* demo */ +#demo-sidebar { + margin: 0; +} + +#demo-sidebar .demo-app { + display: inline; + display: flex; + flex-direction: row; + align-items: baseline; + flex-wrap: wrap; + margin: 0.75rem 0.25rem 0 0.25rem; +} + +.demo-app > * { + flex: 1 auto; + white-space: nowrap; +} + +#demo-sidebar .admonition-title::after { + display: none; +} + +#demo-sidebar .admonition-title { + padding-left: 0.75rem; +} diff --git a/docs/source/_templates/demo.html b/docs/source/_templates/demo.html index bc18326f84..cb0c901f62 100644 --- a/docs/source/_templates/demo.html +++ b/docs/source/_templates/demo.html @@ -1,41 +1,41 @@ -
-

- Try Jupyter Widgets Now +

+

+ + Try Jupyter Widgets

-
-