You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@sedona.apache.org by "jiayuasu (via GitHub)" <gi...@apache.org> on 2026/06/12 17:22:40 UTC
[PR] [DOCS] Fix Queries page rendering raw notebook JSON [sedona-spatialbench]
jiayuasu opened a new pull request, #112:
URL: https://github.com/apache/sedona-spatialbench/pull/112
## What changes were proposed in this PR?
The published Queries page at https://sedona.apache.org/spatialbench/queries/ shows the raw JSON of `docs/queries.ipynb` instead of the rendered documentation.
Both `docs/queries.ipynb` and `docs/queries.md` built to the same `/queries/` URL. With the `mkdocs-jupyter` plugin enabled alongside the `i18n` plugin (`docs_structure: suffix`), the i18n plugin copies the notebook into the site as-is over the rendered markdown page, so the raw notebook JSON wins the collision. This reproduces locally with `mkdocs build` on `main`, even with `mkdocs-jupyter` properly installed.
This PR:
- Moves `docs/queries.ipynb` to `notebooks/queries.ipynb` so it stays in the repo as a runnable artifact but is no longer a buildable docs page
- Removes the `mkdocs-jupyter` plugin from `mkdocs.yml` and `docs/requirements.txt` (the notebook was the only `.ipynb` under `docs/`), so the collision cannot recur
Verified locally: `mkdocs build` succeeds and the queries page now renders the proper markdown (Q1–Q12 with descriptions, SQL, and result tables) in both English and Chinese, with no notebook JSON on the page.
Fixes #111
## How was this change tested?
Built the site locally with `mkdocs build`:
- On `main`, `queries/index.html` contains 32 occurrences of raw `"cell_type"` JSON (bug reproduced)
- With this change, the page contains the rendered markdown and zero notebook JSON; `zh/queries/` builds correctly too
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@sedona.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] [DOCS] Fix Queries page rendering raw notebook JSON [sedona-spatialbench]
Posted by "jiayuasu (via GitHub)" <gi...@apache.org>.
jiayuasu merged PR #112:
URL: https://github.com/apache/sedona-spatialbench/pull/112
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@sedona.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org