This is an automated email from the ASF dual-hosted git repository.
uros-b pushed a commit to branch branch-4.x
in repository https://gitbox.apache.org/repos/asf/spark.git
The following commit(s) were added to refs/heads/branch-4.x by this push:
new accb776c383f [SPARK-57362][DOC] Prevent content from overlapping left
navigation
accb776c383f is described below
commit accb776c383fdd543b6ee8c29ae05fe7a170bafb
Author: yueqingshu <[email protected]>
AuthorDate: Tue Jun 23 16:00:41 2026 +0200
[SPARK-57362][DOC] Prevent content from overlapping left navigation
### What changes were proposed in this pull request?
On documentation pages with a left navigation sidebar, wide content (long
inline code, wide tables, etc.) could push the page wider than the viewport.
Because the sidebar is position: fixed, horizontal page
scrolling then caused the main content to slide over / under the
navigation and visually overlap it.
This PR fixes that with two small CSS rules in docs/css/custom.css:
- .content-with-sidebar gets overflow-x: auto, so wide content scrolls
inside the content column instead of widening the whole page.
- .left-menu-wrapper gets an explicit z-index and an opaque background,
so the fixed navigation is never visually overlapped by content.
jira [SPARK-57362](https://issues.apache.org/jira/browse/SPARK-57362)
### Why are the changes needed?
On pages with long inline code or other wide content, horizontal page
scrolling can cause the main content to overlap the fixed left navigation
sidebar.
For example, this can be reproduced on the GROUP BY documentation page:
https://spark.apache.org/docs/latest/sql-ref-syntax-qry-select-groupby.html
<img width="2186" height="2074" alt="image"
src="https://github.com/user-attachments/assets/cbf67725-3186-4028-9766-21f1657cc0e0";
/>
<img width="2512" height="2388" alt="image"
src="https://github.com/user-attachments/assets/cb22cbb3-b6b6-4e14-baed-00c4c78b4f44";
/>
The left navigation should remain visible while wide content is scrolled.
### Does this PR introduce _any_ user-facing change?
Yes. This changes the documentation website layout behavior for pages with
a left navigation sidebar. Wide content is now horizontally scrolled within the
main content area instead of overlapping the left navigation.
### How was this patch tested?
Manually tested by serving the documentation locally:
```bash
SKIP_ERRORDOC=1 SKIP_API=1 bundle exec jekyll serve --host 127.0.0.1 --port
4000
Closes #56424 from llphxd/SPARK-57362-fix-sidebar-overlap.
Authored-by: yueqingshu <[email protected]>
Signed-off-by: Uros Bojanic <[email protected]>
(cherry picked from commit c70da16b5a40df2966f7756aa1bb29d79d8ce3ba)
Signed-off-by: Uros Bojanic <[email protected]>
---
docs/css/custom.css | 3 +++
1 file changed, 3 insertions(+)
diff --git a/docs/css/custom.css b/docs/css/custom.css
index bcee4a54a0cb..70dd94f2970d 100644
--- a/docs/css/custom.css
+++ b/docs/css/custom.css
@@ -834,6 +834,7 @@ blockquote {
line-height: 1.6;
padding-left: 30px;
min-height: 100vh;
+ overflow-x: auto;
}
.left-menu-wrapper {
@@ -850,6 +851,8 @@ blockquote {
overflow-y: scroll;
padding-right: 20px;
font-size: 0.9em !important;
+ z-index: 2;
+ background-color: #FFF;
}
.left-menu h3 {
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
