Skip to content

fix(doc-page): restore deep-link scrolling and show AsciiDoc section anchor icons #484

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
rdmueller merged 1 commit into from
May 15, 2026
+65 −0
Merged

fix(doc-page): restore deep-link scrolling and show AsciiDoc section anchor icons #484

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
12 changes: 12 additions & 0 deletions website/src/components/doc-page.js
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -64,6 +64,18 @@ export async function loadDocContent(docPath) {
// Attach click-to-load handlers for any YouTube placeholders in the doc.
// Keeps us DSGVO-compliant: YouTube is only contacted after user consent.
hydrateYouTubeFacades(contentEl)

// Restore deep-link scrolling: if the URL has a hash (e.g. #phase-0-5),
// the browser tried to scroll there before the SPA replaced #doc-content
// with this newly fetched HTML. Re-scroll to the target now that the
// section exists in the DOM.
if (window.location.hash) {
const id = decodeURIComponent(window.location.hash.slice(1))
const target = document.getElementById(id)
if (target) {
target.scrollIntoView({ behavior: 'auto', block: 'start' })
}
}
} catch (error) {
console.error('Failed to load documentation:', error)
contentEl.innerHTML = `
Expand Down
53 changes: 53 additions & 0 deletions website/src/styles/main.css
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -520,3 +520,56 @@ body {
height: 100%;
border: 0;
}

/* AsciiDoc section anchors: visible chain icon on hover, like the default
Asciidoctor stylesheet. Asciidoctor renders <a class="anchor" href="#id">
before each heading when sectanchors:true is set in render-docs.js. */
.asciidoc-content h1,
.asciidoc-content h2,
.asciidoc-content h3,
.asciidoc-content h4,
.asciidoc-content h5,
.asciidoc-content h6 {
position: relative;
scroll-margin-top: 5rem;
}

.asciidoc-content h1 > a.anchor,
.asciidoc-content h2 > a.anchor,
.asciidoc-content h3 > a.anchor,
.asciidoc-content h4 > a.anchor,
.asciidoc-content h5 > a.anchor,
.asciidoc-content h6 > a.anchor {
position: absolute;
left: -1.25rem;
top: 0;
bottom: 0;
display: flex;
align-items: center;
width: 1.25rem;
opacity: 0;
text-decoration: none;
color: var(--color-text-secondary, #6b7280);
transition: opacity 0.15s ease-in-out;
}

.asciidoc-content h1:hover > a.anchor,
.asciidoc-content h2:hover > a.anchor,
.asciidoc-content h3:hover > a.anchor,
.asciidoc-content h4:hover > a.anchor,
.asciidoc-content h5:hover > a.anchor,
.asciidoc-content h6:hover > a.anchor,
.asciidoc-content a.anchor:focus {
opacity: 1;
}

.asciidoc-content a.anchor::before {
content: '\00a7'; /* § — same convention as the default Asciidoctor stylesheet */
font-size: 0.85em;
font-weight: normal;
}

.asciidoc-content a.anchor:hover {
color: var(--color-link, #2563eb);
text-decoration: none;
}
Loading