.md.
+ // Defaults to the editPath from the resolved nav location.
+ editPathOverride?: string | null;
+}
+
+const sidebarLink = (link: DocsNavLink, current: string): string => {
+ const cls = link.href === current ? "docs-side-link docs-side-link-active" : "docs-side-link";
+ return `${escape(link.label)}`;
+};
+
+const renderSidebar = (currentPath: string): string => {
+ const sections = SITE_NAV.map((section: DocsNavSection) => {
+ const items = section.links.map((l) => sidebarLink(l, currentPath)).join("");
+ const sectionCls = section.links.some((l) => l.href === currentPath)
+ ? "docs-side-section docs-side-section-active"
+ : "docs-side-section";
+ return ``;
+ }).join("\n");
+ return ``;
+};
+
+const renderAnchorRail = (anchors: Anchor[]): string => {
+ if (anchors.length === 0) return "";
+ const items = anchors
+ .map((a) => {
+ const cls = a.level === 3 ? "docs-rail-link docs-rail-link-h3" : "docs-rail-link";
+ return `${escape(a.text)}`;
+ })
+ .join("");
+ return ``;
+};
+
+const renderEditLink = (editPath: string | null): string => {
+ if (!editPath) return "";
+ const url = `${REPO_EDIT_BASE}/${editPath}`;
+ return `edit this page on GitHub →
`;
+};
+
+const renderPrevNext = (loc: ResolvedDocsLocation | null): string => {
+ if (!loc) return "";
+ const prev = loc.prev
+ ? `←${escape(loc.prev.label)}`
+ : ``;
+ const next = loc.next
+ ? `${escape(loc.next.label)}→`
+ : ``;
+ return ``;
+};
+
+// Wrap a heading element with an anchor link for hover-click access.
+// Also injects an `id` if marked didn't (rare with our config but
+// possible). Operates on the rendered HTML before composing the page.
+const enrichHeadings = (html: string): string =>
+ html.replace(
+ /]*)?>([\s\S]*?)<\/h\1>/g,
+ (_full, level, attrs, inner) => {
+ const idMatch = /\bid="([^"]+)"/.exec(attrs ?? "");
+ const id = idMatch?.[1] ?? inner.replace(/<[^>]*>/g, "").toLowerCase().replace(/[^a-z0-9\s-]/g, "").trim().replace(/\s+/g, "-");
+ const finalAttrs = idMatch ? attrs : `${attrs ?? ""} id="${id}"`;
+ return `#${inner}`;
+ },
+ );
+
+export const renderDocsPage = async (opts: DocsPageOptions): Promise => {
+ const rawHtml = opts.bodyMarkdown
+ ? await marked.parse(opts.bodyMarkdown, { gfm: true, breaks: false })
+ : "";
+ const enriched = enrichHeadings(rawHtml);
+ const anchors = extractAnchors(enriched);
+ const loc = resolveDocsLocation(opts.pathForDocs);
+ const editPath = opts.editPathOverride !== undefined ? opts.editPathOverride : loc?.current.editPath ?? null;
+
+ const sidebar = renderSidebar(opts.pathForDocs);
+ const rail = renderAnchorRail(anchors);
+ const editLink = renderEditLink(editPath);
+ const prevNext = renderPrevNext(loc);
+
+ const composed = `
+${sidebar}
+
+${editLink}
+${enriched}
+${prevNext}
+
+${rail}
+