Support blogs

Background

I totally get that this is the jupyter book project, and my first usage of this project has been to create online textbooks (which has been a fantastic experience). It occurred to me that all the great things about jupyter-book:

• jupyter notebook specific CSS
• Tufte-like features
• not relying on Jekyll engine
• MyST markdown
• glue to easily cross-reference images and figures Would also be great features for a python blog primarily built with jupyter notebooks.

So was I was just wondering if there’s a possibility for an adaption of the current jupyter book project to also support blog building? Perhaps with a specific blog html theme?

To Do

• Investigate blogging options with the Sphinx ecosystem (potentially ablog)
• Document how one could use ablog to blog with Jupyter Book (e.g., how to configure the config.yaml properly) (here’s how we use ablog in our website, which uses Sphinx directly, but this config could be used in Jupyter Book similarly)
• Decide if the documentation is complex enough that it warrants us building some kind of feature flag around.

[ddanieltan]

Hi thread, I’m the OP here. It’s been a while since I took a look at this thread and I’m pleasantly surprised to see that many others are also interested in building a blog from this library.

Since I didn’t see it mentioned in this thread, I want to point out that @choldgraf has documented how he rewrote his blog with Sphinx and EBP tools here: https://predictablynoisy.com/posts/2020/sphinx-blogging/

After reading his post, I kinda realized that to create a blog, I did not need new features to jupyter-book per se. Rather, I just needed to better understand how to use all the other libraries under the EBP’s (https://executablebooks.org/) ecosystem.

Lastly, I adapted Chris’s example for my own blog, and I just wrote a how-to post here. Writing that post is actually why I thought to dig up this thread again…

Hope these resources help you figure out the right tooling for your personal blog.

[ddanieltan]

@eidorb Thanks for calling this out!

As always I’m tinkering about with my blog at the moment, and in the interim I decided to take down my personal domain. Also as you rightly point out, the github.io version is still up.

For posterity, if I ever choose to reclaim my github.io namespace for my new blog project (pretty likely), my code on how to get an EBP-ecosystem blog up and running will continue to be accessible here: https://github.com/ddanieltan/blog_ebp_sphinx_starter