Skip to content

Better differentiate headings/sections #2164

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 8 commits into from
Oct 29, 2025
Merged

Better differentiate headings/sections #2164

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
b6623e9
Better differentiate headings/sections in top/extra content
DavidOliver Oct 24, 2025
980cb7b
Improve
DavidOliver Oct 27, 2025
0020833
Avoid confusing tools with implicit & in CSS
DavidOliver Oct 28, 2025
92f15b4
Switch to treating cheatsheet and admonition headings as the special …
DavidOliver Oct 28, 2025
760e79b
Add Module details list h1s to those presented with h2 styles
DavidOliver Oct 28, 2025
06bb361
Fix on-page signature margin
DavidOliver Oct 28, 2025
e173957
Add explicit &
DavidOliver Oct 29, 2025
a1a9363
More accurately target sections that require alt hx styling
DavidOliver Oct 29, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion assets/css/_html.css
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@
@import "keyboard-shortcuts.css";
@import "quick-switch.css";
@import "autocomplete.css";
@import "tooltips.css";
@import "tooltips.css"; /* must remain below functions */
@import "copy-button.css";
@import "settings.css";
@import "toast.css";
Expand Down
3 changes: 3 additions & 0 deletions assets/css/content/cheatsheet.css
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,7 @@
/* h2 */

.page-cheatmd .content-inner h2 {
font-size: 1.6rem;
margin: var(--vertical-space) 0;
column-span: all;
color: var(--gray700);
Expand All @@ -36,6 +37,7 @@
/* h3 */

.page-cheatmd .content-inner h3 {
font-size: 1.375rem;
margin: 0 0 1em;
font-weight: 400;
}
Expand Down Expand Up @@ -66,6 +68,7 @@
/* h4 */

.page-cheatmd .content-inner h4 {
font-size: 1rem;
display: block;
margin: 0;
padding: 0.25em var(--horizontal-space);
Expand Down
7 changes: 5 additions & 2 deletions assets/css/content/functions.css
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,11 +25,14 @@
position: relative;
}

/* !important used in order to beat main heading styles (which use #id selectors),
in both HTML and ePub. */
.content-inner .detail-header .signature {
font-family: var(--monoFontFamily);
font-size: 13px;
font-weight: 700;
line-height: 2em;
font-size: 13px !important;
line-height: 2em !important;
margin: 0 !important;
}

.content-inner .detail-header:hover a.detail-link,
Expand Down
67 changes: 49 additions & 18 deletions assets/css/content/general.css
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -62,15 +62,6 @@
color: var(--textHeaders);
}

.content-inner h1 {
font-size: 2em;
margin: 0.5em 0;
}

.content-inner h1.section-heading {
margin: 1.5em 0 0.5em;
}

.content-inner div.group-description {
margin: 0 0 3em;
}
Expand All @@ -79,15 +70,43 @@
font-weight: 400;
}

.content-inner h2 {
font-size: 1.6em;
padding-top: 1em;
margin-bottom: 0.5em;
}
/* Headings
Summary, Callbacks and Functions sections output h1 and h2,
which we style as h2 and h3. */

.content-inner {
& h1 {
font-size: 2rem;
margin-top: 1.75em;
}

& h2,
& :is(#summary, #callbacks, #functions) h1 {
font-size: 1.75rem;
margin-top: 1.5em;
margin-bottom: 0.5em;
}

& h3,
& :is(#summary, #callbacks, #functions) h2 {
font-size: 1.45rem;
margin-top: 1.5em;
margin-bottom: 0.5em;
}

.content-inner h3 {
font-size: 1.375em;
margin: 1em 0 0.5em;
& :is(h4, h5, h6) {
font-size: 1.15rem;
margin-top: 1.25em;
margin-bottom: 0.5em;
}

& :is(h5, h6) {
font-weight: normal;
}

& h6 {
font-size: 1rem;
}
}

.content-inner li + li {
Expand Down Expand Up @@ -140,6 +159,18 @@
overflow: auto;
border-radius: var(--borderRadius-base);

& :is(h1, h2, h3, h4, h5, h6) {
margin: 1.25rem 0;
}

& :is(h1, h2, h3) {
font-size: 1.375rem;
}

& :is(h4, h5, h6) {
font-size: 1rem;
}

& :is(code, pre code) {
background-color: var(--admCodeBackground);
border: 1px solid var(--admCodeBorder);
Expand All @@ -151,7 +182,7 @@
}

& :is(h1, h2, h3, h4, h5, h6):first-child {
padding-bottom: 1em;
padding-bottom: 1rem;
border-bottom: 2px solid hsl(from currentColor h s l / 15%);
}

Expand Down
4 changes: 3 additions & 1 deletion assets/css/tooltips.css
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -33,10 +33,12 @@ as it has absolute positioning, so doesn't impact the layout and click events pa
overflow: auto;
}

/* !important used in order to beat main heading and functions signature styles. */
.tooltip .tooltip-body .signature {
min-width: 320px;
width: 100%;
line-height: 1em;
line-height: 1em !important;
margin: .75em 0 !important;
}

.tooltip .tooltip-body .detail-header {
Expand Down