NASA-IMPACT / NASA-IMPACT/veda-docs

Quarto + HTML repr of xarray.Dataset breaks page layout

Open
#141 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Jupyter Notebook
Stars
10
Forks
16
Avg merge
2d 31m
Merged PRs (30d)
4

Description

This is definitely not specific to veda-docs, but I'm not 100% sure where to report it. The cell immediately after the html repr of an xarra.Dataset (but not DataArray) breaks the page layout.

Screenshot from 2024-04-23 14-37-29

You can see this on the cloud-native geo page as well. Just keep scrolling: https://guide.cloudnativegeo.org/zarr/zarr-in-practice.html

I snooped a bit on the html and it looks like somehow the Indexes and Attributes are several layers up from where they should be:
image

So I imagine that is the root of the problem because if those are up 2 levels and then they close the div they are essentially closing the content page div. In jupyterlab they are in the proper place in the hierarchy:

image

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Reproduce the layout break on the cloud-native geo Zarr-in-practice page using an HTML repr of an xarray.Dataset followed by another cell, and compare its element hierarchy with the JupyterLab rendering shown in the issue. Trace whether the problem belongs in veda-docs, Quarto, or the xarray representation; done means the following cell and page layout remain intact.

Written by the indexing model from the issue text.

Assessment

Tech stack
html, jupyter
Domain
documentation, web-dev
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.