From 1b3c4f26514d6201062513629df0ef715f375e9f Mon Sep 17 00:00:00 2001 From: jnywong Date: Mon, 18 Nov 2024 10:54:19 +0000 Subject: [PATCH 1/3] Add cross-post --- content/blog/2024/jupyter-book-2/index.md | 100 ++++++++++++++++++++++ 1 file changed, 100 insertions(+) create mode 100644 content/blog/2024/jupyter-book-2/index.md diff --git a/content/blog/2024/jupyter-book-2/index.md b/content/blog/2024/jupyter-book-2/index.md new file mode 100644 index 000000000..f3ddfef97 --- /dev/null +++ b/content/blog/2024/jupyter-book-2/index.md @@ -0,0 +1,100 @@ +--- +title: Announcing the Jupyter Book 2 alpha +date: "2024-11-18" +banner: + image: "featured.png" +authors: ["Jenny Wong"] +tags: [open-source] +categories: [] +featured: false +draft: false +--- + +*Cross-posted from the [Jupyter Book blog](blog.jupyterbook.org/). Note that some MyST functionality is not supported on the 2i2c website – please see the original post for previews.* + +Over the last ten months, the Jupyter Book team have been hard at work; Jupyter Book has [become a Jupyter subproject](https://github.com/jupyter/governance/pull/229), and the team[^jb-eb] announced a [plan to release Jupyter Book 2][plan]. This post announces the **alpha release of Jupyter Book 2.0**, which has been re-written from the ground up to use the new MyST-MD engine. + +Over the next few months, we will work in preparation for the full release of Jupyter Book 2. Stay tuned for more! The initial documentation for the alpha release can be found at: + + + +## Install the Jupyter Book 2 Alpha + +The Jupyter Book 2 alpha is available from PyPI.org. You can install it with `pip`, using + +```shell +pip install -U jupyter-book==2.0.0a0 +``` + +If you use `pipx`, it's recommened to run Jupyter Book 2 using + +```shell +pipx run jupyter-book==2.0.0a0 +``` + +Jupyter Book 2 needs Node.js installed on your computer. If this is not the case, running `jupyter book` will prompt you to install it using the `nodeenv` package that ships with Jupyter Book 2: + +``` +❗ Node.js (node) is required to run Jupyter Book, but could not be found`. +❔ Install Node.js in '...'? (y/N): +``` + +Press `y` and `Enter` to proceed. + +{{% callout note %}} +The Jupyter Book 2 project is a complete re-write of Jupyter Book. We expect there to be bugs and breakages! Please use our support channels to keep us up to date with your findings! + +- [Discord](https://discord.mystmd.org/) +- [GitHub Issues](https://github.com/jupyter-book/jupyter-book/issues/new?template=prerelease.yml) +{{% /callout %}} + +## New Features in `2.0 alpha` + +### Rich Hover Previews + +Try hovering over [this tooltip about tooltips!](https://en.wikipedia.org/wiki/Tooltip). The new MyST book and article themes provide useful hover previews for links to other MyST content, Wikipedia, GitHub issues, and many more. + + + +### Share & Embed Content + +Content from other websites built with the MyST engine can be embedded in your own sites and PDFs: + +![](https://cdn.curvenote.com/0192bff5-9c9d-722f-92bf-e702aa8e1f46/public/c8830546aa82907becb6cd46c414a80c.webp "Cross-referenced content can easily be embedded and re-captioned into other pages and projects, such as this figure to .") + +### Simple Instant Search + +A new client-side search uses a simple, modern algorithm for fast _local_ search that finds the results that you care about. + +![](https://github.com/jupyter-book/blog/blob/main/media/search.png?raw=true "Client-side search uses simple, modern, [Algolia](https://algolia.com)-inspired search algorithm to provide _useful_ search results. We will be iterating on this in the near future for even richer search results!") + +### High Quality PDFs + +PDF documents can now be built with Typst, a high-quality typesetting engine that produces readable error messages and beautiful documents. This feature was the basis for the 2024 [SciPy proceedings][proceedings], which is now built on MyST Markdown and will be accepting Jupyter Notebooks in 2025. + +![](https://raw.githubusercontent.com/rowanc1/LaPreprint/68f5ccbf1e1e26819149bcea1d547dfdfc5ceecd/example/files/screenshot.png "Example of the LaPreprint Typst template for rendering PDFs from Jupyter Book (via the MyST Engine).") + +## Coming Soon in `2.0 beta` + +### Custom Styles & Scrips + +Jupyter Book 2 will make it easy to tweak your website styles, and add new website behaviors. + +### Generate Markdown from Code Cells + +The MyST engine is on-track to support the inclusion of references and other markup features generated by code cells. + +### Control Cell Visibility with Tags + +In the beta release, Jupyter Book 2 will once-again be able to show and hide content according to cell tags. + +## Jupyter Book 2 vs MyST-MD + +At this early stage, the new Jupyter Book application `jupyter book` behaves identically to the `mystmd` engine that it is built upon; as outlined in [our Jupyter Book 2 plan][plan], we intend for Jupyter Book to be an "opinionated distribution" of `mystmd` that shares the same configuration format and CLI. This contrasts with Jupyter Book 1, which was built on top of the Sphinx documentation engine, but offered its own CLI and configuration files. In future, the `jupyter book` and `mystmd` CLIs may diverge from one another, but we expect that this will be handled in a graceful manner: `mystmd` commands should always be compatible with the `jupyter book` application. + +[proceedings]: https://proceedings.scipy.org +[plan]: https://executablebooks.org/en/latest/blog/2024-05-20-jupyter-book-myst/ + +[^jb-eb]: Jupyter Book project has historically been a _technical_ project of the Executable Books organisation. In 2024, the establishment of a Jupyter subproject means that the Jupyter Book project now has its own identity outside of Executable Books. From a9c999671491467112957162d893348e27cda55e Mon Sep 17 00:00:00 2001 From: jnywong Date: Mon, 18 Nov 2024 11:06:37 +0000 Subject: [PATCH 2/3] Add feature image --- content/blog/2024/jupyter-book-2/featured.png | Bin 0 -> 9963 bytes 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 content/blog/2024/jupyter-book-2/featured.png diff --git a/content/blog/2024/jupyter-book-2/featured.png b/content/blog/2024/jupyter-book-2/featured.png new file mode 100644 index 0000000000000000000000000000000000000000..5be01b98345ee2731b59b2564845fab1d60fd423 GIT binary patch literal 9963 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 literal 0 HcmV?d00001 From af9aa95a1f2e4c60c5e2dba936c7ece0c5d18dc5 Mon Sep 17 00:00:00 2001 From: jnywong Date: Mon, 18 Nov 2024 11:06:49 +0000 Subject: [PATCH 3/3] Add alt text --- content/blog/2024/jupyter-book-2/index.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/content/blog/2024/jupyter-book-2/index.md b/content/blog/2024/jupyter-book-2/index.md index f3ddfef97..b00cc97f0 100644 --- a/content/blog/2024/jupyter-book-2/index.md +++ b/content/blog/2024/jupyter-book-2/index.md @@ -12,6 +12,8 @@ draft: false *Cross-posted from the [Jupyter Book blog](blog.jupyterbook.org/). Note that some MyST functionality is not supported on the 2i2c website – please see the original post for previews.* +![Jupyter Book 2 logo](featured.png) + Over the last ten months, the Jupyter Book team have been hard at work; Jupyter Book has [become a Jupyter subproject](https://github.com/jupyter/governance/pull/229), and the team[^jb-eb] announced a [plan to release Jupyter Book 2][plan]. This post announces the **alpha release of Jupyter Book 2.0**, which has been re-written from the ground up to use the new MyST-MD engine. Over the next few months, we will work in preparation for the full release of Jupyter Book 2. Stay tuned for more! The initial documentation for the alpha release can be found at: @@ -62,19 +64,19 @@ Try hovering over [this tooltip about tooltips!](https://en.wikipedia.org/wiki/T Content from other websites built with the MyST engine can be embedded in your own sites and PDFs: -![](https://cdn.curvenote.com/0192bff5-9c9d-722f-92bf-e702aa8e1f46/public/c8830546aa82907becb6cd46c414a80c.webp "Cross-referenced content can easily be embedded and re-captioned into other pages and projects, such as this figure to .") +![Image of a mountain range.](https://cdn.curvenote.com/0192bff5-9c9d-722f-92bf-e702aa8e1f46/public/c8830546aa82907becb6cd46c414a80c.webp "Cross-referenced content can easily be embedded and re-captioned into other pages and projects, such as this figure to .") ### Simple Instant Search A new client-side search uses a simple, modern algorithm for fast _local_ search that finds the results that you care about. -![](https://github.com/jupyter-book/blog/blob/main/media/search.png?raw=true "Client-side search uses simple, modern, [Algolia](https://algolia.com)-inspired search algorithm to provide _useful_ search results. We will be iterating on this in the near future for even richer search results!") +![Screenshot of a search bar.](https://github.com/jupyter-book/blog/blob/main/media/search.png?raw=true "Client-side search uses simple, modern, [Algolia](https://algolia.com)-inspired search algorithm to provide _useful_ search results. We will be iterating on this in the near future for even richer search results!") ### High Quality PDFs PDF documents can now be built with Typst, a high-quality typesetting engine that produces readable error messages and beautiful documents. This feature was the basis for the 2024 [SciPy proceedings][proceedings], which is now built on MyST Markdown and will be accepting Jupyter Notebooks in 2025. -![](https://raw.githubusercontent.com/rowanc1/LaPreprint/68f5ccbf1e1e26819149bcea1d547dfdfc5ceecd/example/files/screenshot.png "Example of the LaPreprint Typst template for rendering PDFs from Jupyter Book (via the MyST Engine).") +![An example preprint using the LaPreprint template.](https://raw.githubusercontent.com/rowanc1/LaPreprint/68f5ccbf1e1e26819149bcea1d547dfdfc5ceecd/example/files/screenshot.png "Example of the LaPreprint Typst template for rendering PDFs from Jupyter Book (via the MyST Engine).") ## Coming Soon in `2.0 beta`