This page has moved to ${escapeAttr(newPath)}.
+`; + const rel = oldPath.replace(/^\//, '').replace(/\/$/, ''); + const dir = path.join(outDir, rel); + if (!fs.existsSync(path.join(dir, 'index.html'))) { + fs.mkdirSync(dir, { recursive: true }); + fs.writeFileSync(path.join(dir, 'index.html'), stub); + } + } + console.log(`Wrote ${Object.keys(redirects).length} redirect stubs`); + } + + // 404 + sitemap + fs.writeFileSync(path.join(outDir, '404.html'), render404({ tree, siteUrl: SITE_URL })); + const sitemap = `\n${escapeHtml(token.content)}` +
+ (titleMatch ? `
\n`;
+ };
+
+ // heading anchors
+ md.renderer.rules.heading_open = (tokens, idx, options, env, self) => {
+ const token = tokens[idx];
+ const next = tokens[idx + 1];
+ if (next && next.type === 'inline' && ['h2', 'h3', 'h4'].includes(token.tag)) {
+ const slug = slugify(plainText(next));
+ const used = env.__anchors ?? (env.__anchors = new Map());
+ let final = slug;
+ let n = used.get(slug) ?? 0;
+ if (n > 0) final = `${slug}-${n}`;
+ used.set(slug, n + 1);
+ token.attrSet('id', final);
+ (env.headings ?? (env.headings = [])).push({ level: Number(token.tag[1]), id: final, text: plainText(next) });
+ return `<${token.tag} id="${final}" class="anchor-heading">`;
+ }
+ return self.renderToken(tokens, idx, options);
+ };
+ md.renderer.rules.heading_close = (tokens, idx, options, env, self) => {
+ const token = tokens[idx];
+ const open = tokens[idx - 2];
+ if (open && open.attrGet && open.attrGet('id') && ['h2', 'h3', 'h4'].includes(token.tag)) {
+ return `#`;
+ }
+ return self.renderToken(tokens, idx, options);
+ };
+
+ return md;
+}
+
+function plainText(inlineToken) {
+ return inlineToken.children
+ ? inlineToken.children.filter(t => t.type === 'text' || t.type === 'code_inline').map(t => t.content).join('')
+ : inlineToken.content;
+}
+
+export function slugify(text) {
+ return text.toLowerCase().trim()
+ .replace(/[^\w\- ]+/g, '')
+ .replace(/\s+/g, '-')
+ .replace(/-+/g, '-')
+ .replace(/^-|-$/g, '');
+}
+
+export function escapeHtml(s) {
+ return s.replace(/&/g, '&').replace(//g, '>').replace(/"/g, '"');
+}
+
+const ADMONITION_ICONS = {
+ note: '',
+ tip: '',
+ info: '',
+ warning: '',
+ caution: '',
+ danger: '',
+};
+const ADMONITION_LABELS = { note: 'Note', tip: 'Tip', info: 'Info', warning: 'Warning', caution: 'Caution', danger: 'Danger' };
+
+// Pre-pass: convert Docusaurus-only syntax into raw-HTML islands that
+// markdown-it will pass through, recursing so inner markdown still renders.
+export function preprocess(source, renderInner) {
+ let out = source.replace(/\r\n?/g, '\n');
+ // strip MDX imports
+ out = out.replace(/^import\s+.*from\s+['"][^'"]+['"];?\s*$/gm, '');
+ out = transformTabs(out, renderInner);
+ out = transformAdmonitions(out, renderInner);
+ // ${escapeHtml(titleMatch[1])}
` : '') +
+ `` +
+ (langLabel ? `${escapeHtml(langLabel)}` : '') +
+ inner + `/ pass through natively;
pass through natively;
ok.
+ return out;
+}
+
+function transformAdmonitions(src, renderInner) {
+ const lines = src.split('\n');
+ const out = [];
+ const stack = [];
+ for (const line of lines) {
+ const open = line.match(/^:::(note|tip|info|warning|caution|danger)(?:\[(.*?)\]?)?\s*(.*)$/);
+ if (open) {
+ stack.push({ type: open[1], title: (open[2] ?? open[3] ?? '').replace(/\]$/, '').trim(), lines: [] });
+ continue;
+ }
+ if (/^:::\s*$/.test(line) && stack.length) {
+ const adm = stack.pop();
+ const type = adm.type;
+ const title = adm.title || ADMONITION_LABELS[type];
+ const inner = renderInner(adm.lines.join('\n'));
+ const html = `` +
+ `${ADMONITION_ICONS[type]}${escapeHtml(title)}` +
+ `\n\n${inner}\n\n`;
+ if (stack.length) stack[stack.length - 1].lines.push(html);
+ else out.push(html);
+ continue;
+ }
+ if (stack.length) stack[stack.length - 1].lines.push(line);
+ else out.push(line);
+ }
+ // Unclosed admonition: emit content as-is rather than dropping it.
+ while (stack.length) {
+ const adm = stack.shift();
+ out.push(`:::${adm.type}${adm.title ? ' ' + adm.title : ''}`, ...adm.lines);
+ }
+ return out.join('\n');
+}
+
+// Finds balanced ... blocks, tolerating same-tag nesting.
+function findBalancedBlocks(src, tag) {
+ const openRe = new RegExp(`<${tag}(\\s[^>]*)?>`, 'g');
+ const anyRe = new RegExp(`<${tag}(\\s[^>]*)?>|`, 'g');
+ const blocks = [];
+ let m;
+ while ((m = openRe.exec(src)) !== null) {
+ anyRe.lastIndex = openRe.lastIndex;
+ let depth = 1;
+ let t;
+ while (depth > 0 && (t = anyRe.exec(src)) !== null) {
+ depth += t[0].startsWith('`.length),
+ });
+ openRe.lastIndex = anyRe.lastIndex;
+ }
+ return blocks;
+}
+
+// Strips the common leading indentation MDX allows inside JSX children,
+// which plain markdown would otherwise read as an indented code block.
+function dedent(src) {
+ const lines = src.split('\n');
+ let min = Infinity;
+ for (const l of lines) {
+ if (!l.trim()) continue;
+ min = Math.min(min, l.match(/^ */)[0].length);
+ }
+ if (!isFinite(min) || min === 0) return src;
+ return lines.map(l => l.slice(min)).join('\n');
+}
+
+function transformTabs(src, renderInner, state = { n: 0 }) {
+ const blocks = findBalancedBlocks(src, 'Tabs');
+ if (!blocks.length) return src;
+ let out = '';
+ let pos = 0;
+ for (const block of blocks) {
+ out += src.slice(pos, block.start);
+ out += renderTabsBlock(block, renderInner, state);
+ pos = block.end;
+ }
+ return out + src.slice(pos);
+}
+
+function renderTabsBlock(block, renderInner, state) {
+ const groupId = (block.attrs.match(/groupId="([^"]+)"/) || [])[1] || `tabs-${state.n}`;
+ const uid = `tabs-${state.n++}`;
+ const items = findBalancedBlocks(block.inner, 'TabItem').map((b, i) => ({
+ value: (b.attrs.match(/value="([^"]+)"/) || [])[1] || `tab-${i}`,
+ label: (b.attrs.match(/label="([^"]+)"/) || [])[1] || `Tab ${i + 1}`,
+ isDefault: /\bdefault\b/.test(b.attrs),
+ content: dedent(b.inner),
+ }));
+ if (!items.length) return block.inner;
+ const defaultIdx = Math.max(0, items.findIndex(i => i.isDefault));
+ const tabs = items.map((it, i) =>
+ ``
+ ).join('');
+ const panels = items.map((it, i) =>
+ `\n\n${renderInner(it.content)}\n\n`
+ ).join('\n');
+ return `` +
+ `${tabs}${panels}`;
+}
diff --git a/scripts/lib/template.mjs b/scripts/lib/template.mjs
new file mode 100644
index 00000000..85c0c6be
--- /dev/null
+++ b/scripts/lib/template.mjs
@@ -0,0 +1,289 @@
+// Page shell: navbar, sidebar, content, right-hand ToC.
+// Third-party integrations preserved from the Docusaurus setup:
+// Termly, Kapa AI widget, Algolia DocSearch, PostHog, Scarf pixel.
+import { escapeHtml } from './markdown.mjs';
+
+const KAPA = {
+ websiteId: '32633e81-a72c-4df4-9cb9-c6cd3a0899cb',
+ projectName: 'Stirling PDF',
+ projectColor: '#1E88E5',
+ // Chevron mark inlined as a data URI so the launcher icon renders
+ // everywhere (locally and before/after deploys), no hosted file needed.
+ projectLogo: 'data:image/svg+xml,' + encodeURIComponent(
+ ''
+ ),
+};
+const ALGOLIA = { appId: 'NJB9CKQAIT', apiKey: 'c67f84bf0cdec4d1962ac4e0d65fb4e5', indexName: 'stirlingpdf' };
+const POSTHOG = { apiKey: 'phc_qy9V53BkvTATJESFrSBvg8Rw5m3KvYuTmmk9IojIjyZ', apiHost: 'https://eu.i.posthog.com' };
+
+function encodeUrl(url) {
+ return url.split('/').map(encodeURIComponent).join('/').replace(/%2F/g, '/');
+}
+
+function head({ title, description, url, siteUrl }) {
+ const fullTitle = title ? `${title} | Stirling PDF` : 'Stirling PDF Documentation';
+ const desc = description ?? 'Documentation for Stirling PDF - your locally hosted one-stop-shop for all your PDF needs.';
+ return `
+
+
+
+
+${escapeHtml(fullTitle)}
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+`;
+}
+
+// Styled to match the stirling.com marketing site header: always-dark bar,
+// Geist type, the same nav links, GitHub star chip, and pill CTA.
+function navbar() {
+ return `
+
+
+
+ 
+ Stirling
+
+
+
+
+ `;
+}
+
+function sidebarHtml(tree, currentUrl) {
+ const renderItems = (items) => items.map(item => {
+ if (item.type === 'doc') {
+ const active = item.url === currentUrl ? ' active' : '';
+ return `${escapeHtml(item.sidebarLabel)} `;
+ }
+ const containsActive = categoryContains(item, currentUrl);
+ const idxUrl = item.indexPage ? encodeUrl(item.indexPage.url) : null;
+ const activeIdx = item.indexPage && item.indexPage.url === currentUrl ? ' active' : '';
+ // Category whose only page is its own index: render as a plain link.
+ if (!item.items.length && idxUrl) {
+ return `${escapeHtml(item.label)} `;
+ }
+ return `
+
+ ${idxUrl
+ ? `${escapeHtml(item.label)}`
+ : ``}
+
+
+ ${renderItems(item.items)}
+ `;
+ }).join('\n');
+
+ const top = [];
+ if (tree.indexPage) {
+ const active = tree.indexPage.url === currentUrl ? ' active' : '';
+ top.push(`${escapeHtml(tree.indexPage.sidebarLabel)} `);
+ }
+ return ``;
+}
+
+function categoryContains(cat, url) {
+ if (cat.indexPage && cat.indexPage.url === url) return true;
+ return cat.items.some(i => i.type === 'doc' ? i.url === url : categoryContains(i, url));
+}
+
+function tocHtml(headings) {
+ if (!headings.length) return '';
+ const items = headings.map(h =>
+ `${escapeHtml(h.text)} `).join('\n');
+ return ``;
+}
+
+function pagerHtml(prev, next) {
+ const cell = (p, dir) => p
+ ? `
+ ${dir === 'prev' ? '← Previous' : 'Next →'}
+ ${escapeHtml(p.sidebarLabel)}
+ `
+ : '';
+ return ``;
+}
+
+// Mirrors the stirling.com site footer: brand + tagline + socials on the
+// left, Product / Resources / Company columns, subdued legal row below.
+function footerHtml() {
+ const year = new Date().getFullYear();
+ return ``;
+}
+
+function scripts() {
+ return `
+
+
+`;
+}
+
+export function renderPage({ page, bodyHtml, tree, prev, next, headings, siteUrl, editUrl }) {
+ // Don't duplicate the H1 if the markdown already starts with one.
+ const hasH1 = /]/.test(bodyHtml.slice(0, 500));
+ return `${head({ title: page.title, description: page.description, url: page.url, siteUrl })}
+
+Skip to content
+${navbar()}
+
+${sidebarHtml(tree, page.url)}
+
+
+ ${hasH1 ? '' : `
+ ${pagerHtml(prev, next)}
+
+${tocHtml(headings)}
+
+${footerHtml()}
+
+${scripts()}
+
+`;
+}
+
+export function render404({ tree, siteUrl }) {
+ return `${head({ title: 'Page Not Found', description: null, url: '/404.html', siteUrl })}
+
+${navbar()}
+
+${sidebarHtml(tree, '__none__')}
+
+
+ Page not found
+ We couldn't find what you were looking for. Try the search in the sidebar, or head back to the documentation home.
+
+
+
+
+${footerHtml()}
+
+${scripts()}
+
+
${ADMONITION_ICONS[type]}${escapeHtml(title)}
` +
+ `\n\n${inner}\n\n
${tabs}
${panels}
+
+
+
+ Stirling
+
+
+
+
+
+ Stirling
+
+
+
+
+ ${idxUrl
+ ? `${escapeHtml(item.label)}`
+ : ``}
+
+
+ - ${renderItems(item.items)}
`;
+}
+
+export function renderPage({ page, bodyHtml, tree, prev, next, headings, siteUrl, editUrl }) {
+ // Don't duplicate the H1 if the markdown already starts with one.
+ const hasH1 = /
+${sidebarHtml(tree, page.url)}
+
+
+ ${hasH1 ? '' : `
+ ${pagerHtml(prev, next)}
+
+${tocHtml(headings)}
+
+${footerHtml()}
+
+${scripts()}
+
+`;
+}
+
+export function render404({ tree, siteUrl }) {
+ return `${head({ title: 'Page Not Found', description: null, url: '/404.html', siteUrl })}
+
+${navbar()}
+
+${sidebarHtml(tree, '__none__')}
+
+
+
+
+
+
+${footerHtml()}
+
+${scripts()}
+
+Page not found
+We couldn't find what you were looking for. Try the search in the sidebar, or head back to the documentation home.
+