Overhaul docs toolchain

[bollwyvl]

References

• fixes Overhaul docs build chain #3656

Changes

• replace nbsphinx with myst-nb
• replace sphinx-rtd-theme with pydata-sphinx-theme
• use jupyterlite directly
• update prettier
  • apply to .md, .ya?ml
• move index.rst to .md
• update lerna
• update eslint
• update typescript
• update CI action versions
• add sphinx-autodoc-typehints
• add intersphinx
• add sphinx-copy-button
• add typedoc
• add jupyterlab-myst
• reorganize docs structure around 4 kinds of docs
• clean up broken markdown links
• fix galata tests

Future Work

• add dark theme variables
• add docs for integrating with myst-nb (and potentially pydata-sphinx-theme and downstreams)
• hoist preferred CDN URL (ick) to API somewhere
• probably ship a known-good requirejs somewhere
• add anchor-level pytest-check-links (especially for internal URLs)
• squash more sphinx warnings, ideally getting to "fail on warning"
• update prettier to consistently apply printWidth: 88 and proseWrap: always

[github-actions]

👈 Launch a binder notebook on branch bollwyvl/ipywidgets/gh-3656-update-docs

[bollwyvl]

This is ready for a look on the RTD preview.

The galata stuff is broken, but at least installs... wouldn't see that as significant blocker.

[bollwyvl]

Additionally, this could be teased into a series of PRs, but given there's no docs building right now, it would take a while to figure it out piecemeal.

[maartenbreddels]

Thanks a lot for this Nick!

[bollwyvl]

HA!. All ✔️.

[bollwyvl]

Thanks all.

[jtpio]

Shouldn't this be moved under PipliteAddon now with the latest lite releases?

[bollwyvl]

Good catch!

…

On Mon, Jan 23, 2023, 17:06 Jeremy Tuloup ***@***.***> wrote: ***@***.**** commented on this pull request. ------------------------------ In docs/lite/jupyter_lite_config.json <#3673 (comment)> : > @@ -0,0 +1,15 @@ +{ + "LiteBuildConfig": { + "extra_ignore_contents": [ + "Layout Example\\.ipynb", + "Layout Templates\\.ipynb", + "Variable Inspector\\.ipynb" + ], + "contents": ["../source/examples"], + "piplite_urls": [ Shouldn't this be moved under PipliteAddon now with the latest lite releases? — Reply to this email directly, view it on GitHub <#3673 (review)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AAALCREL5Y626YHZPE5E6T3WT4FHPANCNFSM6AAAAAAUCV7A7E> . You are receiving this because you authored the thread.Message ID: ***@***.***>