Comments (3)
I agree think the major drawback of Jupyter Book right now is the discrepancy between rendered notebooks on the website with lots of extra formatting compared to what is possible in Jupyter Lab. Numpy tutorials require only using CommonMark in notebook cells for this reason (https://github.com/numpy/numpy-tutorials#contributing)
My hunch is that the primary mode for consuming this material is on the website rather than Jupyter Lab, except for the case of workshops where everyone is on Jupyter Lab. And during workshops, the focus is on code cells (people can have the website open in another tab for the rendered version).
So I'm in favor of anything that makes for easier navigation on the website. Yet another convenience could be adding https://sphinx-hoverxref.readthedocs.io/en/latest/ https://blog.readthedocs.com/hoverxref-intersphinx.
from xarray-tutorial.
Nice idea @zmoon this would definitely be interesting to try! We're in the midst of a pretty big revamp leading up to a scipy workshop in July, and just switched to jupyterbook so there is a fair amount in flux at the moment.
from xarray-tutorial.
What do you think about intersphinx references in the text? Would be nice to have the links, and reduced maintenance vs manually putting the links in, though for people running the notebooks in Jupyter the texts becomes a bit uglier.
from xarray-tutorial.
Related Issues (20)
- SciPy 2023 tracking issue HOT 9
- Add more options to run interactively on the cloud HOT 20
- Add non-geoscience example datasets HOT 4
- Add CONTRIBUTING.md to website
- add rough logo
- Add general codespaces setup to README.md HOT 4
- Cartopy plot not rendering HOT 4
- Add sphinx-sitemap
- Review indexing material HOT 1
- A few points for improving the indexing notebooks HOT 3
- Tutorial on custom indexes
- Missing examples for the map and map_dataarray methods of FacetGrid objects
- Link needed for "Working with labeled data" tutorial HOT 2
- Remote access patterns using xarray. HOT 1
- Update to JupyterBook 1.0 HOT 1
- Update deprecated scipy.integrate.trapz to trapezoid
- Set navigation_with_keys=False explicitly
- Periodically check for broken links
- Generate website preview link even if build fails on PRs HOT 1
- Xarray tutorial with custom SSL cert? HOT 3
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from xarray-tutorial.