Combining multiple repos into one site at jupyterbook.org

As part of an initiative to improve jupyterbook.org’s documentation, we refactored the site so that multiple repositories are served under one domain. We wrote up the details on the Jupyter Book blog.

Read the full post here:

How we combine multiple repositories into one website at jupyterbook.org.

Along the way we made several upstream improvements to the MyST Engine and the MyST theme:

• parts: support for extends: and URL support as well so we can share a footer / navbar configuration across repositories
• internal_domains option so that links to another repository’s content could still be treated as internal
• Less aggressive citation parsing so that text like @githubhandle weren’t parsed as a citation
• Several mobile and UX fixes (that’s one, there were many others!)

These all felt particularly relevant for documentation that our member communities manage, where you have content split across multiple repositories but served at a single domain.

Acknowledgements #

Thanks to Project Pythia and EarthScope for collaboration and feedback that helped shape this work. And thanks to our member communities whose memberships fund upstream contributions like these.