search

fatiando / tutorials

Tutorials that integrate the Fatiando a Terra software to solve data problems in geoscience
https://www.fatiando.org/tutorials/
Other
13 stars 6 forks source link

Make a Jupyter Book for the tutorials #4

Closed leouieda closed 2 years ago

leouieda commented 2 years ago

JupyterBook is an easy way to build a very nice sphinx website from Jupyter notebooks or even plain markdown files. The website includes links to download the content as notebooks and even run them on Binder. The setup is not very difficult and we could run it on CI and have the website served under fatiando.org/tutorials or tutorials.fatiando.org.

This could be a way to keep the tutorials in Markdown for easier development and still have the notebook for use in a live teaching setting.

Any thoughts in favour or against this?

cc @santisoler @aguspesce @andieie @MGomezN @LL-Geo

Some of these issues were raised in #3 by @MGomezN.

MGomezN commented 2 years ago

After checking the Quantitative Economics with Python example... 😮 I'm "A favor!"

leouieda commented 2 years ago

Hadn't seen that one before. It looks awesome! I really liked this one as well: https://inria.github.io/scikit-learn-mooc/index.html

aguspesce commented 2 years ago

It is a good idea!

LL-Geo commented 2 years ago

I like this as well!!!

santisoler commented 2 years ago

Great idea! JupyterBooks might be a great tool for uploading courses material, so implementing it on Fatiando tutorials is a great excuse to learn how do they work.

MGomezN commented 2 years ago

The Jupyter Book is alive! https://www.fatiando.org/tutorials/ As usual, I broke many things and had more questions than certainties. Stories for the next meeting :)

MGomezN commented 2 years ago

Fixed. See commit. Improvement is needed. Specific features will be raised on the following issues.