MUYSC.png

See merge request !1

* pin docutils < 0.18 (https://github.com/mcmtroffaes/sphinxcontrib-bibtex/issues/322)

* Prep for v0.15.1

* rework, issue warning rather than force version pin on docutils

* only test html if no warnings

* doc: add entry for citations page

* update changelog

Co-authored-by: Chris Holdgraf <choldgraf@gmail.com>

* RELEASE: v0.15.0

* review docs related to theme keyword

* Update requirement sphinx-book-theme to ~=1.0.0

* Fixes CI by changing saved outputs (for sphinx 4 and 5)

* DOCS: fix minor table formatting issue in CHANGELOG

* update to format

This PR updates `jupyter-book` to enable `myst-nb~=0.17.1` and `sphinx5` support. It also includes new versions of `sphinx-design`, `sphinx-thebe`, and `sphinx-book-theme`

Updates the requirements on [pre-commit](https://github.com/pre-commit/pre-commit) to permit the latest version.
- [Release notes](https://github.com/pre-commit/pre-commit/releases)
- [Changelog](https://github.com/pre-commit/pre-commit/blob/main/CHANGELOG.md)
- [Commits](https://github.com/pre-commit/pre-commit/compare/v2.12.0...v3.1.0

)

---
updated-dependencies:
- dependency-name: pre-commit
  dependency-type: direct:production
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Change default for launch_buttons.binderhub_url to "" (thus no launch buttons)

* Try to fix tests after changing default_config.yml

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Chris Holdgraf <choldgraf@berkeley.edu>

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Chris Holdgraf <choldgraf@berkeley.edu>

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Chris Holdgraf <choldgraf@berkeley.edu>

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

closes undefined

- More direct injection of plausible.io analytics, using nothing but
  a standard Sphinx option.
- I have tested this in the jupyter-book docs.  This solution uses `<script
  defer="defer" ...>` instead of `<script defer ...>`, but the
  plausible people say it should be the same.  The advantage here is
  that the configuration is more simple and stardard.
- Apparently this will also be possible by the pydata sphinx theme,
  it's up to you all if you prefer theme-based or standard config
  based.  Feel free to close this PR if you would rather sphinx-based.

* Improve custom admonitions documentation

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci



* Apply suggestions from code review

Co-authored-by: Chris Holdgraf <choldgraf@gmail.com>

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: Chris Holdgraf <choldgraf@gmail.com>

* Add guidance for configuring gh-pages

Adds instructions to configure GitHub Pages to correctly find and deploy the built files.

* Update docs/publish/gh-pages.md

Co-authored-by: Chris Holdgraf <choldgraf@gmail.com>

I didn't find this useful tip (change the class of an admonition) in the documentation. See https://jupyterbook.org/en/stable/interactive/hiding.html?highlight=admonition#toggle-admonition-content-with-dropdowns and https://jupyterbook.org/en/stable/advanced/html.html?highlight=admonition#an-example-custom-admonitions for related but different things.