Running list of Jupyter Book questions

[adowling2]

Questions:

• How to add "open in Colab" badge/button?
• What are best practices for storing data? How to get said data to load in Colab?
• What are the best practices for getting images to load in Colab?
• How to handle notebooks that should throw errors intentionally (e.g., illustrate syntax mistake)

[adowling2]

data -- similar approach to nbpages
images -- relative addresses work! not sure how it works behind the scenes
look for version of pytest for notebooks

[adowling2]

Always use double dollar signs for math
Look into different annotation styles in Jupter Book, see if it translates to nbpages
See if this translates to Colab okay:

• https://jupyterbook.org/en/stable/content/content-blocks.html
• https://jupyterbook.org/en/stable/content/content-blocks.html?highlight=admonitions#html-admonitions

[adowling2]

Here is how to remove content:
https://jupyterbook.org/en/stable/interactive/hiding.html

Easily edit tags in Jupyter Book:
https://jupyterbook.org/en/stable/content/metadata.html#jupyter-cell-tags

Finding: removing or hiding cells does NOT remove the content from the source notebooks; the hidden/removed content is still available in Colab

[jckantor]

"Open in Colab" menu items is configured in _config.yml

# Launch on Google Colab button
launch_buttons:
    notebook_interface: "classic"
    colab_url: "https://colab.research.google.com"

[jckantor]

See https://github.com/jckantor/nbpages/blob/master/notebooks/nb_lite.ipynb for examples of how to manipulated cells based on tags and content.

[adowling2]

@jckantor Thank you. This is super helpful.

[jckantor]

I updated https://github.com/jckantor/nbpages/blob/master/notebooks/nb_lite.ipynb to show how to execute a notebook from python, and to allow errors and save the result.

[adowling2]

Nice! I found the correct configuration option in the Jupyter Book documentation to keep executing a notebook after an error.

[jckantor]

Very nice!

…

On May 4, 2022, at 10:22 PM, Alex Dowling ***@***.***> wrote: Nice! I found the correct configuration option in the Jupyter Book documentation to keep executing a notebook after an error. — Reply to this email directly, view it on GitHub <#1 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AAYYECZ6WK3BSSF7UYWT27LVIMWIFANCNFSM5U4WTB7A>. You are receiving this because you were mentioned.

[E-Ream]

Two general repeated issues to look into further:

• Highlighted box markdowns don't correctly format the $ $ math once published on the Github website, despite formatting correctly in Jupyter Lab
  
• Images appear in the Github website notebooks but do not appear once the notebook is opened in Colab

[E-Ream]

@adowling2 @jkeane14
In looking more into the first of the two above issues...
The LaTeX math with $ and $$ seems to work sometimes in the published notebooks and not at other times, seemingly without reason as the code format is consistent throughout. I found this article that includes a script to run to allow MathJax to work its magic on the LaTeX for our GitHub pages website. I'm not sure if this is already being run but it could potentially solve this issue?

Suggested script to run:

<script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML" type="text/javascript"></script>

Edit (AD, July 5, 2022):

I am trying admonitions. Not sure if all of these are supported:
https://pradyunsg.me/furo/reference/admonitions/

[adowling2]

@jckantor Do you have any suggestions on getting images in a \media folder in Jupyter Book to load in Colab? The images are being included correctly in the HTML website. But they are missing when we hit the "open in Colab" button. Have you come up with a good workaround?

[jckantor]

@adowling2 I looked at this notebook ... https://ndcbe.github.io/data-and-computing/notebooks/02-publish/01-Modeling-Systems-of-Linear-Equations.html which has an image in the media folder. The reason the image is not opening on Colab is that the image uses a relative address for the media folder assuming the image is stored locally. It's not uploaded to Colab, so it is not local to Colab. The fix I've used is to reference the image with a URL referencing the book. In this case, changing

to

should do the trick.