You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
stays the same in the downloaded notebook, even though page2.md doesn't necessarily exist in the same directory on their machine. Therefore, that link will be broken, which is confusing. I'm looking for a way to use internal references in my source notebooks/Markdown, but then have those links converted to absolute URLs for the notebook and PDF downloads. (Making all links on the site absolute as well would be acceptable, if that's easier.)
Ditto for images sources in Markdown files/cells.
Things I considered/tried
Workaround
Pros
Cons
Have them clone the Git repository (instead of downloading notebooks individually
Relative links would work; they can pull the latest
They need to learn / deal with Git, including merge conflicts
Have them download all course files as a ZIP
Relative links would work, easy on students
Students wouldn't get updates to the files as I make them
reacted with thumbs up emoji reacted with thumbs down emoji reacted with laugh emoji reacted with hooray emoji reacted with confused emoji reacted with heart emoji reacted with rocket emoji reacted with eyes emoji
-
I teach a class for people who are new to coding. The course sites is built with Jupyter Book, published on ReadTheDocs. To do their assignments / play with the lecture code, I have them download the notebooks from the site and then load them up in JupyterLab locally.
When using internal references with Markdown link syntax, the notebook (and PDF) downloads that Jupyter Book provide still use the relative paths. Example:
stays the same in the downloaded notebook, even though
page2.md
doesn't necessarily exist in the same directory on their machine. Therefore, that link will be broken, which is confusing. I'm looking for a way to use internal references in my source notebooks/Markdown, but then have those links converted to absolute URLs for the notebook and PDF downloads. (Making all links on the site absolute as well would be acceptable, if that's easier.)Ditto for images sources in Markdown files/cells.
Things I considered/tried
myst_all_links_external: true
*This is what I'm currently doing.
That all make sense? Thoughts?
Beta Was this translation helpful? Give feedback.
All reactions