All Posts
Project Pythia Hackathon: Transitioning from JupyterBook to MyST Markdown
- 14 June 2024
This last week members of the ExecutableBooks team attended the Pythia Cook-off 2024 hackathon to help support and introduce MyST Markdown as the next generation infrastructure being used for Jupyter Book v2.
Project Pythia serves as an education and training hub for the geoscientific Python community, acting as the educational wing of the Pangeo initiative. It provides an extensive range of Python-centered learning resources that are open-source, community-owned, geoscience-focused, and of exceptional quality. These resources and tutorials or “Cookbooks” offer ways to onboard into the geoscientific Python ecosystem and demonstrate ways to process and understand vast amounts of numerical scientific data using tools that support open, reproducible science, while fostering an inclusive community of practice. The Project Pythia technical stack has been based on Jupyter Book, whose next release is undergoing significant development at the moment through the mystmd project. Members of the MyST team attended the hackathon and helped with onboarding, development of new features, and bug fixes throughout the week. It was an exciting event that showcased the power of the new tools that we aim to capture in this post.
Towards Jupyter Book 2 with MyST-MD
- 19 May 2024
Over the past four years, the Executable Book(s) (EB) project has been working to improve workflows for writing and publishing with Jupyter Notebooks, along with the broader open source science ecosystem.
Within this collaboration, much of the development effort has been spent on building Jupyter Book, which has been a tremendous success; there are at least 13,209 GitHub repositories using the tool according to the dependency graph for the project.[1] Furthermore, the reach of EB has grown to encompass documentation writers and package authors who use EB tools to provide a richer experience for their audiences. For example, six of the flagship scientific python projects[3] like NumPy, Pandas, and Dask make use of at least one of the Sphinx-based tools we’ve developed such as the PyData Sphinx Theme, the Sphinx Book Theme, MyST Markdown parser, or the Jupyter Notebook parser.[4]
Expanding our team and the next phase of Executable Books development
- 28 November 2023
Over the past three years, the Executable Books team has focused its efforts on building a Sphinx-based technical stack underlying the Jupyter Book project. This has been extremely successful, and Jupyter Book and the associated MyST ecosystem in Sphinx have gained adoption across both scientific and open source communities. The MyST Parser for Sphinx averages around 350,000 downloads a month, which makes up about 13% of all Sphinx downloads (https://www.pepy.tech/projects/myst-parser?versions=*). There are over 4000 Jupyter Books in public GitHub repositories (https://github.com/search?q=%22format%3A+jb-book%22&type=code), many of which are now featured at gallery.executablebooks.org.
Using MyST Markdown in JupyterLab
- 26 June 2023
Join the upcoming webinar (5th July 2023 @ 3pm UTC) and get started using MyST in JupyterLab and how it connects to other scientific writing workflows. The webinar is hosted by Rowan & Steve from Curvenote, and will be an hour walk-through of using MyST in JupyterLab.
Sign up for the webinar or watch the recording on YouTube after.
Call for MyST Templates for Open Science
- 07 March 2023
Interested in porting your first LaTeX template to a MyST template? Join the upcoming webinar (15th March 2023 @ 4pm UTC) and get started (and maybe finished) building your template during the session.
The webinar is hosted by Rowan & Steve from Curvenote, and will be a 2 hour walk-through at an easy pace of how to markup an existing LaTeX template or document for use with the MyST Markdown CLI.
Announcing MyST-JS: Bringing MyST to JavaScript and Jupyter
- 09 February 2023
MyST Markdown is an extensible, semantic, and community-driven flavor of markdown designed for scientific and computational narratives. It was created for Jupyter Book, and has gained wide adoption in Python’s Sphinx documentation ecosystem.
Executable Books Update (October 2022)
- 16 November 2022
This blog post provides an annual update for the Executable Books community. This post is an adaptation of an interim report provided to the Alfred P. Sloan Foundation. It shares how the project has been progressing relative to the initial grant success metrics, and concludes with a few comments about the future of Executable Books and our vision for the next 12 months.
Jupyter Book and MyST at AGU 2021
- 18 December 2021
The AGU 2021 conference just wrapped up, and Jupyter Book made a few appearances at the conference this year. Below are a few links to videos and Google Slides for each session.
Migrate your old Table of Contents to the new TOC structure
- 17 June 2021
In Jupyter Book v0.11, we introduced a new Table of Contents structure. The new structure is a bit more rigid and explicit, which should allow for a cleaner mapping of TOC structures onto book structures. It also introduces the concept of TOC formats, which allows you to specify different kinds of documents in the TOC (to start with, Books and Articles).
This is a short guide to explain the differences between the old and new Table of Contents structures, to help you update them.
🚀 RELEASE: Jupyter Book v0.11.1
- 05 June 2021
This is an experimental post to try solving two problems with one blog post. We often send out a flurry of tweets to talk about a new release in the Executable Books stack. We’d also like to blog about releases more often so it’s easier to track major updates. This post is an attempt at crafting a blog post entirely made out of tweets!
We’re pleased to announce a new version of Jupyter Book has just been released! You can check out the CHANGELOG here: https://jupyterbook.org/reference/_changelog.html#v0-11-0
Announcing the new Jupyter Book
- 07 August 2020
Note: this announcement is cross-posted between the Jupyter Blog and the Executable Book Project updates blog
Jupyter Book is an open source project for building beautiful, publication-quality books, websites, and documents from source material that contains computational content. With this post, we’re happy to announce that Jupyter Book has been re-written from the ground up, making it easier to install, faster to use, and able to create more complex publishing content in your books. It is now supported by the Executable Book Project, an open community that builds open source tools for interactive and executable documents in the Jupyter ecosystem and beyond.
Hello world
- 25 February 2020
Over the last several years, Jupyter Notebooks have become a staple in the data scientist’s toolkit. As both an interface for interactive computation and a document standard for structuring blocks of computational and narrative content, notebooks are ubiquitous, flexible, and powerful.