Jupyter-book

([full changelog](https://github.com/executablebooks/jupyter-book/compare/v0.15.1...a8b7cf6517188ca837d948ca1f86858e2bb86097))

Bugs fixed

- FIX: update `output_scroll` tag [2050](https://github.com/executablebooks/jupyter-book/pull/2050) ([agoose77](https://github.com/agoose77))

([full changelog](https://github.com/executablebooks/jupyter-book/compare/v0.15.0...aa0eedbc40691b5f0ea0dd5e80fdfb572e0ee91d))

Bug

This release is a minor update to alert users of `jupyter-book` to [sphinxcontrib-bibtex 322](https://github.com/mcmtroffaes/sphinxcontrib-bibtex/issues/322) when building bibliographies with `docutils>=0.18,<0.20` installed.

- [1965](https://github.com/executablebooks/jupyter-book/pull/1965)

**Bug:** Using `docutils>=0.18` results in breaking the page `html` layout when using `sphinx-book-theme` on pages
that include a `bibliography` directive.

([full changelog](https://github.com/executablebooks/jupyter-book/compare/v0.14.0...c0d3d0c640a709f84c23ef58b25c65d2e5a6e816))

This release updates [sphinx-book-theme](https://sphinx-book-theme.readthedocs.io/en/latest/index.html) to version `1.0.0`

- [1953](https://github.com/executablebooks/jupyter-book/pull/1953)

The full release notes for [sphinx-book-theme==1.0.0 can be found here](https://sphinx-book-theme.readthedocs.io/en/latest/changelog.html#v1-0-0-2023-03-01)

Thanks to [all the contributors](https://github.com/executablebooks/sphinx-book-theme/graphs/contributors?from=2022-07-17&to=2023-02-19&type=c) that worked on this major update to [sphinx-book-theme](https://sphinx-book-theme.readthedocs.io/en/latest/index.html)

([full changelog](https://github.com/executablebooks/jupyter-book/compare/v0.13.2...e52689156deeace6a34c8e27f77dfa7ec65720ab))

This release updates many of the underlying software packages used by `jupyter-book` including major updates to [myst-nb](https://github.com/executablebooks/myst-nb) and [myst-parser](https://github.com/executablebooks/myst-parser) which power `jupyter-book`. This release also brings compatibility with `sphinx v5`.

A big **thank you** to all contributors and maintainers of these underlying packages. There have been many major updates that will flow through to `jupyter-book` with this release.

A [migration assistance page](https://jupyterbook.org/en/stable/explain/migration.html) has been setup to assist users with updates to your `configuration` and highlights a few of the common `breaking changes` which are discussed with examples.

Package Updates

- [1842](https://github.com/executablebooks/jupyter-book/pull/1842) updates [myst-nb](https://github.com/executablebooks/MyST-NB) moving from `myst-nb~=0.13.1` to `myst-nb~=0.17.1`. This incorporates three major updates to [myst-nb](https://github.com/executablebooks/MyST-NB/releases) which in turn incorporates changes to the underlying [myst-parser](https://github.com/executablebooks/MyST-Parser/releases) moving from `myst-parser~=0.15` to `myst-parser~=0.18`.
- [1842](https://github.com/executablebooks/jupyter-book/pull/1842) enables compatibility with `docutils>=0.15,<0.19`
- [1842](https://github.com/executablebooks/jupyter-book/pull/1842) supports `sphinx5`
- [1842](https://github.com/executablebooks/jupyter-book/pull/1842) incorporates updates for `sphinx-design`, `sphinx-thebe` and `sphinx-book-theme`.

Docs

- DOCS: Fix gallery URL [1933](https://github.com/executablebooks/jupyter-book/pull/1933) and [1937](https://github.com/executablebooks/jupyter-book/pull/1937)

Contributors to this release

([GitHub contributors page for this release](https://github.com/executablebooks/jupyter-book/graphs/contributors?from=2023-02-07&to=2023-02-28&type=c))

However this excludes the many major contributions in underlying projects which are documented in the table below.

| Package | Contributions |
|---------|---------------|
| [myst-nb](https://github.com/executablebooks/MyST-NB) | [contributors](https://github.com/executablebooks/MyST-NB/graphs/contributors?from=2022-02-11&to=2023-02-28&type=c) |
| [myst-parser](https://github.com/executablebooks/myst-parser) | [contributors](https://github.com/executablebooks/myst-parser/graphs/contributors?from=2021-06-13&to=2023-02-28&type=c) |
| [sphinx-design](https://github.com/executablebooks/sphinx-design) | [contributors](https://github.com/executablebooks/sphinx-design/graphs/contributors?from=2022-04-21&to=2023-02-28&type=c) |
| [sphinx-thebe](https://github.com/executablebooks/sphinx-thebe) | [contributors](https://github.com/executablebooks/sphinx-thebe/graphs/contributors?from=2022-04-30&to=2023-02-28&type=c) |
| [sphinx-book-theme](https://github.com/executablebooks/sphinx-book-theme) | [contributors](https://github.com/executablebooks/sphinx-book-theme/graphs/contributors?from=2022-03-28&to=2023-01-05&type=c) |

([full changelog](https://github.com/executablebooks/jupyter-book/compare/v0.13.1...e52689156deeace6a34c8e27f77dfa7ec65720ab))

Bugs fixed

- FIX: Address typo in docs [1841](https://github.com/executablebooks/jupyter-book/pull/1841) ([mmcky](https://github.com/mmcky))

Maintenance and upkeep improvements

- MAINT: Remove `cell_metadata_filter: -all` from template [1910](https://github.com/executablebooks/jupyter-book/pull/1910) ([maxbane](https://github.com/maxbane))
- MAINT: Move pypi publish to dedicated workflow [1878](https://github.com/executablebooks/jupyter-book/pull/1878) ([choldgraf](https://github.com/choldgraf))

Documentation improvements

- DOCS: Fix typo [1879](https://github.com/executablebooks/jupyter-book/pull/1879) ([fortierq](https://github.com/fortierq))
- DOCS: Add copybutton console prefix [1877](https://github.com/executablebooks/jupyter-book/pull/1877) ([choldgraf](https://github.com/choldgraf))
- DOCS: Fix broken link in pdf.md [1876](https://github.com/executablebooks/jupyter-book/pull/1876) ([stoffprof](https://github.com/stoffprof))
- DOCS: document an easier method of plausible analytics [1867](https://github.com/executablebooks/jupyter-book/pull/1867) ([rkdarst](https://github.com/rkdarst))
- DOCS: Clarify toc update tip [1861](https://github.com/executablebooks/jupyter-book/pull/1861) ([root-11](https://github.com/root-11))
- DOC: Add guidance for configuring gh-pages [1859](https://github.com/executablebooks/jupyter-book/pull/1859) ([rafmudaf](https://github.com/rafmudaf))
- DOCS: Remove incomplete documentation section on adding metadata [1854](https://github.com/executablebooks/jupyter-book/pull/1854) ([MaxGhenis](https://github.com/MaxGhenis))
- DOCS: Updates to Read the Docs instructions [1849](https://github.com/executablebooks/jupyter-book/pull/1849) ([benjaoming](https://github.com/benjaoming))
- DOCS: Add an example of admonition with warning style [1834](https://github.com/executablebooks/jupyter-book/pull/1834) ([paugier](https://github.com/paugier))
- DOCS: Add documentation on enabling Plausible Analytics [1814](https://github.com/executablebooks/jupyter-book/pull/1814) ([firasm](https://github.com/firasm))
- DOCS: Improve custom admonitions documentation [1777](https://github.com/executablebooks/jupyter-book/pull/1777) ([leodrivera](https://github.com/leodrivera))
- DOCS: Change syntax highlighting example [1752](https://github.com/executablebooks/jupyter-book/pull/1752) ([fmaussion](https://github.com/fmaussion))
- DOCS: Add link to default myst extensions [1908](https://github.com/executablebooks/jupyter-book/pull/1908) ([jbusecke](https://github.com/jbusecke))


Contributors

mmcky
maxbane
choldgraf
fortierq
stoffprof
rkdarst
root
rafmudaf
MaxGhenis
benjaoming
paugier
firasm
leodrivera
fmaussion
jbusecke

([full changelog](https://github.com/executablebooks/jupyter-book/compare/v0.13.0...8a74127748066eac5e0e788a584cb31d18b66058))

This minor release includes improvements to the project documentation and includes the following fixes:

Fixes and Maintenance

1. [1750](https://github.com/executablebooks/jupyter-book/pull/1750) improves compatibility with sphinx>=5.
2. [1774](https://github.com/executablebooks/jupyter-book/pull/1774) fixes an issue that enables math when using the `singlehtml` builder