@lucasviola/specwiki 1.0.0

package/dist/output/html/renderer.d.ts

@@ -0,0 +1,21 @@
+import type { WikiIndexMeta, WikiPage } from "../../types.js";
+export interface HtmlRenderOptions {
+    includeSearch?: boolean;
+    searchIndexJson?: string;
+}
+export declare class HtmlRenderer {
+    private readonly layoutTemplate;
+    private readonly indexTemplate;
+    private readonly articleTemplate;
+    private constructor();
+    static create(): Promise<HtmlRenderer>;
+    renderIndex(pages: WikiPage[], indexMeta: WikiIndexMeta, renderOptions?: HtmlRenderOptions): string;
+    renderArticle(page: WikiPage, allPages: WikiPage[], contentHtml: string, renderOptions?: HtmlRenderOptions): string;
+    static bundleCss(): Promise<string>;
+    static bundledCssFilename(): string;
+    static highlightCssFilename(): string;
+    static readHighlightCss(): Promise<string>;
+}
+export declare function getHtmlRenderer(): Promise<HtmlRenderer>;
+export declare function resetHtmlRendererCache(): void;
+//# sourceMappingURL=renderer.d.ts.map

package/dist/output/html/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../../src/output/html/renderer.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAe,aAAa,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AA2C3E,MAAM,WAAW,iBAAiB;IAChC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAQD,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IAEzC,OAAO;WAMM,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC;IAS5C,WAAW,CACT,KAAK,EAAE,QAAQ,EAAE,EACjB,SAAS,EAAE,aAAa,EACxB,aAAa,GAAE,iBAAsB,GACpC,MAAM;IA+BT,aAAa,CACX,IAAI,EAAE,QAAQ,EACd,QAAQ,EAAE,QAAQ,EAAE,EACpB,WAAW,EAAE,MAAM,EACnB,aAAa,GAAE,iBAAsB,GACpC,MAAM;WA8BI,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAWzC,MAAM,CAAC,kBAAkB,IAAI,MAAM;IAInC,MAAM,CAAC,oBAAoB,IAAI,MAAM;WAIxB,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;CAIjD;AAmHD,wBAAsB,eAAe,IAAI,OAAO,CAAC,YAAY,CAAC,CAK7D;AAED,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}

package/dist/output/html/renderer.js

@@ -0,0 +1,203 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { createRequire } from "node:module";
+import { fileURLToPath } from "node:url";
+import Mustache from "mustache";
+import { CATEGORY_LABELS } from "../../config/patterns.js";
+import { renderMarkdown } from "../../parse/markdown.js";
+import { isReadmeFile } from "../readme-index.js";
+const moduleDir = path.dirname(fileURLToPath(import.meta.url));
+const require = createRequire(import.meta.url);
+const TEMPLATES_DIR = path.join(moduleDir, "templates");
+const ASSETS_DIR = path.join(moduleDir, "assets");
+const BUNDLED_CSS_FILENAME = "specwiki.css";
+const HIGHLIGHT_CSS_FILENAME = "highlight.css";
+export class HtmlRenderer {
+    layoutTemplate;
+    indexTemplate;
+    articleTemplate;
+    constructor(layout, index, article) {
+        this.layoutTemplate = layout;
+        this.indexTemplate = index;
+        this.articleTemplate = article;
+    }
+    static async create() {
+        const [layout, index, article] = await Promise.all([
+            fs.readFile(path.join(TEMPLATES_DIR, "layout.mustache"), "utf-8"),
+            fs.readFile(path.join(TEMPLATES_DIR, "index.mustache"), "utf-8"),
+            fs.readFile(path.join(TEMPLATES_DIR, "article.mustache"), "utf-8"),
+        ]);
+        return new HtmlRenderer(layout, index, article);
+    }
+    renderIndex(pages, indexMeta, renderOptions = {}) {
+        const categories = buildNavCategories(pages)
+            .filter((category) => categoryVisibleInIndex(pages, category.key))
+            .map((category) => {
+            const intro = indexMeta.categoryIntros.get(category.key);
+            return {
+                ...category,
+                hasIntro: Boolean(intro),
+                introHtml: intro ? renderMarkdown(intro.content) : "",
+            };
+        });
+        const pageCount = pages.length;
+        const allPages = buildAllPagesList(pages);
+        const hasRootIntro = Boolean(indexMeta.rootIntro);
+        const body = Mustache.render(this.indexTemplate, {
+            categories,
+            pageCount,
+            pageCountLabel: pageCount === 1 ? "spec file" : "spec files",
+            allPages,
+            hasRootIntro,
+            rootIntroHtml: hasRootIntro ? renderMarkdown(indexMeta.rootIntro) : "",
+        });
+        return Mustache.render(this.layoutTemplate, {
+            pageTitle: "Spec Wiki",
+            body,
+            includeHighlightCss: false,
+            includeSearch: Boolean(renderOptions.includeSearch),
+            searchIndexJson: renderOptions.searchIndexJson ?? "",
+        });
+    }
+    renderArticle(page, allPages, contentHtml, renderOptions = {}) {
+        validateArticlePage(page);
+        const categories = buildNavCategories(allPages, page.category);
+        const categoryLabel = categoryLabelFor(page.category);
+        const tocEntries = buildTocEntries(page.sections);
+        const breadcrumbs = buildBreadcrumbs(page, categoryLabel, allPages);
+        const body = Mustache.render(this.articleTemplate, {
+            categories,
+            breadcrumbs,
+            title: page.title,
+            categoryLabel,
+            sourcePath: page.sourcePath,
+            description: page.description,
+            hasDescription: Boolean(page.description),
+            content: contentHtml,
+            tocEntries,
+            hasToc: tocEntries.length > 0,
+        });
+        return Mustache.render(this.layoutTemplate, {
+            pageTitle: page.title,
+            body,
+            includeHighlightCss: true,
+            includeSearch: Boolean(renderOptions.includeSearch),
+            searchIndexJson: renderOptions.searchIndexJson ?? "",
+        });
+    }
+    static async bundleCss() {
+        const wikimediaPath = require.resolve("wikimedia-ui-base/wikimedia-ui-base.css");
+        const customPath = path.join(ASSETS_DIR, BUNDLED_CSS_FILENAME);
+        const [wikimedia, custom] = await Promise.all([
+            fs.readFile(wikimediaPath, "utf-8"),
+            fs.readFile(customPath, "utf-8"),
+        ]);
+        return `${wikimedia}\n\n${custom}`;
+    }
+    static bundledCssFilename() {
+        return BUNDLED_CSS_FILENAME;
+    }
+    static highlightCssFilename() {
+        return HIGHLIGHT_CSS_FILENAME;
+    }
+    static async readHighlightCss() {
+        const highlightPath = path.join(ASSETS_DIR, HIGHLIGHT_CSS_FILENAME);
+        return fs.readFile(highlightPath, "utf-8");
+    }
+}
+function categoryLabelFor(category) {
+    return CATEGORY_LABELS[category] ?? category;
+}
+function categoryAnchor(category) {
+    return `category-${category}`;
+}
+function buildAllPagesList(pages) {
+    return [...pages]
+        .sort((a, b) => a.title.localeCompare(b.title))
+        .map((page) => ({
+        title: page.title,
+        slug: page.slug,
+        href: `${page.slug}.html`,
+    }));
+}
+function categoryVisibleInIndex(pages, category) {
+    return pages.some((page) => page.category === category && !isReadmeFile(page.sourcePath));
+}
+function buildNavCategories(pages, activeCategory) {
+    const byCategory = new Map();
+    for (const page of pages) {
+        const list = byCategory.get(page.category) ?? [];
+        list.push(page);
+        byCategory.set(page.category, list);
+    }
+    const sortedKeys = [...byCategory.keys()].sort((a, b) => categoryLabelFor(a).localeCompare(categoryLabelFor(b)));
+    return sortedKeys
+        .filter((key) => categoryVisibleInIndex(pages, key))
+        .map((key) => ({
+        key,
+        label: categoryLabelFor(key),
+        anchor: categoryAnchor(key),
+        active: key === activeCategory,
+        open: key === activeCategory,
+        pageCount: (byCategory.get(key) ?? []).length,
+        collapsible: (byCategory.get(key) ?? []).length > 1,
+        pages: (byCategory.get(key) ?? []).map((page) => ({
+            title: page.title,
+            slug: page.slug,
+            href: `${page.slug}.html`,
+            sourcePath: page.sourcePath,
+        })),
+    }));
+}
+function buildTocEntries(sections) {
+    return sections
+        .filter((section) => section.level >= 2 && section.level <= 6)
+        .map((section) => ({
+        title: section.title,
+        href: `#${section.anchor}`,
+        level: section.level,
+    }));
+}
+function buildBreadcrumbs(page, categoryLabel, allPages) {
+    const segments = [
+        { label: "Main Page", href: "index.html", first: true },
+    ];
+    if (categoryVisibleInIndex(allPages, page.category)) {
+        segments.push({
+            label: categoryLabel,
+            href: `index.html#${categoryAnchor(page.category)}`,
+            first: false,
+        });
+    }
+    else {
+        segments.push({ label: categoryLabel, first: false });
+    }
+    segments.push({ label: page.title, first: false });
+    return segments;
+}
+function validateArticlePage(page) {
+    const missing = [];
+    if (!page.title) {
+        missing.push("title");
+    }
+    if (!page.category) {
+        missing.push("category");
+    }
+    if (!page.sourcePath) {
+        missing.push("sourcePath");
+    }
+    if (missing.length > 0) {
+        throw new Error(`Missing required template fields: ${missing.join(", ")}`);
+    }
+}
+let cachedRenderer = null;
+export async function getHtmlRenderer() {
+    if (!cachedRenderer) {
+        cachedRenderer = await HtmlRenderer.create();
+    }
+    return cachedRenderer;
+}
+export function resetHtmlRendererCache() {
+    cachedRenderer = null;
+}
+//# sourceMappingURL=renderer.js.map

package/dist/output/html/renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../../../src/output/html/renderer.ts"],"names":[],"mappings":"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"}

package/dist/output/html/search-index.d.ts

@@ -0,0 +1,20 @@
+import type { WikiPage } from "../../types.js";
+export declare const SEARCH_INDEX_VERSION = 1;
+export declare const BODY_EXCERPT_MAX = 2000;
+export interface SearchIndexDocument {
+    slug: string;
+    title: string;
+    category: string;
+    categoryLabel: string;
+    description: string;
+    body: string;
+}
+export interface SearchIndex {
+    version: number;
+    documents: SearchIndexDocument[];
+}
+export declare function stripMarkdown(text: string): string;
+export declare function extractBodyExcerpt(content: string, maxLength?: number): string;
+export declare function buildSearchIndex(pages: WikiPage[]): SearchIndex;
+export declare function serializeSearchIndexForInlineScript(index: SearchIndex): string;
+//# sourceMappingURL=search-index.d.ts.map

package/dist/output/html/search-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-index.d.ts","sourceRoot":"","sources":["../../../src/output/html/search-index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,mBAAmB,EAAE,CAAC;CAClC;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAkBlD;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,SAAS,SAAmB,GAC3B,MAAM,CAMR;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,WAAW,CAY/D;AAED,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,WAAW,GACjB,MAAM,CAER"}

package/dist/output/html/search-index.js

@@ -0,0 +1,46 @@
+import { CATEGORY_LABELS } from "../../config/patterns.js";
+export const SEARCH_INDEX_VERSION = 1;
+export const BODY_EXCERPT_MAX = 2000;
+export function stripMarkdown(text) {
+    return text
+        .replace(/^---[\s\S]*?---\n/m, "")
+        .replace(/```[\s\S]*?```/g, " ")
+        .replace(/`([^`]+)`/g, "$1")
+        .replace(/!\[[^\]]*\]\([^)]*\)/g, " ")
+        .replace(/\[([^\]]*)\]\([^)]*\)/g, "$1")
+        .replace(/^#{1,6}\s+/gm, "")
+        .replace(/^\s*[-*+]\s+/gm, "")
+        .replace(/^\s*\d+\.\s+/gm, "")
+        .replace(/^\s*>+\s?/gm, "")
+        .replace(/\*\*([^*]+)\*\*/g, "$1")
+        .replace(/\*([^*]+)\*/g, "$1")
+        .replace(/__([^_]+)__/g, "$1")
+        .replace(/_([^_]+)_/g, "$1")
+        .replace(/<\/?[^>]+(>|$)/g, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+export function extractBodyExcerpt(content, maxLength = BODY_EXCERPT_MAX) {
+    const plain = stripMarkdown(content);
+    if (plain.length <= maxLength) {
+        return plain;
+    }
+    return plain.slice(0, maxLength);
+}
+export function buildSearchIndex(pages) {
+    return {
+        version: SEARCH_INDEX_VERSION,
+        documents: pages.map((page) => ({
+            slug: page.slug,
+            title: page.title,
+            category: page.category,
+            categoryLabel: CATEGORY_LABELS[page.category] ?? page.category,
+            description: page.description,
+            body: extractBodyExcerpt(page.content),
+        })),
+    };
+}
+export function serializeSearchIndexForInlineScript(index) {
+    return JSON.stringify(index).replace(/</g, "\\u003c");
+}
+//# sourceMappingURL=search-index.js.map

package/dist/output/html/search-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-index.js","sourceRoot":"","sources":["../../../src/output/html/search-index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AACtC,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAgBrC,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI;SACR,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC;SACjC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC;SAC/B,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC;SAC3B,OAAO,CAAC,uBAAuB,EAAE,GAAG,CAAC;SACrC,OAAO,CAAC,wBAAwB,EAAE,IAAI,CAAC;SACvC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;SAC3B,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC;SAC7B,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC;SAC7B,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC;SAC1B,OAAO,CAAC,kBAAkB,EAAE,IAAI,CAAC;SACjC,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC;SAC7B,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC;SAC7B,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC;SAC3B,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC;SAC/B,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,OAAe,EACf,SAAS,GAAG,gBAAgB;IAE5B,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACrC,IAAI,KAAK,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAiB;IAChD,OAAO;QACL,OAAO,EAAE,oBAAoB;QAC7B,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC9B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,aAAa,EAAE,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ;YAC9D,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,IAAI,EAAE,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC;SACvC,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mCAAmC,CACjD,KAAkB;IAElB,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AACxD,CAAC"}

package/dist/output/html/templates/article.mustache

@@ -0,0 +1,85 @@
+<div class="specwiki-layout specwiki-layout-article">
+  <aside id="specwiki-nav-drawer" class="specwiki-nav-drawer">
+    <button
+      type="button"
+      id="specwiki-nav-close"
+      hidden
+      class="specwiki-nav-close"
+      aria-label="Close category navigation"
+    >
+      <span aria-hidden="true">×</span>
+    </button>
+    <nav class="category-nav" aria-label="Categories">
+      {{#categories}}
+      {{#collapsible}}
+      <details class="category-nav-group{{#active}} category-nav-active{{/active}}" data-category="{{key}}" {{#open}}open{{/open}}>
+        <summary class="category-nav-summary">
+          <a href="index.html#{{anchor}}" class="category-nav-heading">{{label}}</a>
+          <span class="category-nav-count" aria-label="{{pageCount}} pages">{{pageCount}}</span>
+        </summary>
+        <ul class="category-nav-pages">
+          {{#pages}}
+          <li><a href="{{href}}">{{title}}</a></li>
+          {{/pages}}
+        </ul>
+      </details>
+      {{/collapsible}}
+      {{^collapsible}}
+      <div class="category-nav-group{{#active}} category-nav-active{{/active}}" data-category="{{key}}">
+        <a href="index.html#{{anchor}}" class="category-nav-heading">{{label}}</a>
+        <ul class="category-nav-pages">
+          {{#pages}}
+          <li><a href="{{href}}">{{title}}</a></li>
+          {{/pages}}
+        </ul>
+      </div>
+      {{/collapsible}}
+      {{/categories}}
+    </nav>
+  </aside>
+  <div class="specwiki-center">
+    <nav class="breadcrumb" aria-label="Breadcrumb">
+      {{#breadcrumbs}}
+      {{^first}} › {{/first}}
+      {{#href}}<a href="{{href}}">{{label}}</a>{{/href}}
+      {{^href}}<span aria-current="page">{{label}}</span>{{/href}}
+      {{/breadcrumbs}}
+    </nav>
+    <aside class="infobox">
+      <h2 class="infobox-title">{{title}}</h2>
+      <table class="infobox-table">
+        <tbody>
+          <tr>
+            <th scope="row">Category</th>
+            <td>{{categoryLabel}}</td>
+          </tr>
+          <tr>
+            <th scope="row">Source</th>
+            <td><code>{{sourcePath}}</code></td>
+          </tr>
+          {{#hasDescription}}
+          <tr>
+            <th scope="row">Summary</th>
+            <td>{{description}}</td>
+          </tr>
+          {{/hasDescription}}
+        </tbody>
+      </table>
+    </aside>
+    <main id="content" class="specwiki-article-body">
+      <div class="mw-parser-output">
+        {{{content}}}
+      </div>
+    </main>
+  </div>
+  {{#hasToc}}
+  <nav class="toc" aria-label="Table of contents">
+    <h2 class="toc-heading">Contents</h2>
+    <ul class="toc-list">
+      {{#tocEntries}}
+      <li class="toc-level-{{level}}"><a href="{{href}}">{{title}}</a></li>
+      {{/tocEntries}}
+    </ul>
+  </nav>
+  {{/hasToc}}
+</div>

package/dist/output/html/templates/index.mustache

@@ -0,0 +1,80 @@
+<div class="specwiki-layout">
+  <aside id="specwiki-nav-drawer" class="specwiki-nav-drawer">
+    <button
+      type="button"
+      id="specwiki-nav-close"
+      hidden
+      class="specwiki-nav-close"
+      aria-label="Close category navigation"
+    >
+      <span aria-hidden="true">×</span>
+    </button>
+    <nav class="category-nav" aria-label="Categories">
+      {{#categories}}
+      {{#collapsible}}
+      <details class="category-nav-group" data-category="{{key}}" {{#open}}open{{/open}}>
+        <summary class="category-nav-summary">
+          <a href="index.html#{{anchor}}" class="category-nav-heading">{{label}}</a>
+          <span class="category-nav-count" aria-label="{{pageCount}} pages">{{pageCount}}</span>
+        </summary>
+        <ul class="category-nav-pages">
+          {{#pages}}
+          <li><a href="{{href}}">{{title}}</a></li>
+          {{/pages}}
+        </ul>
+      </details>
+      {{/collapsible}}
+      {{^collapsible}}
+      <div class="category-nav-group" data-category="{{key}}">
+        <a href="index.html#{{anchor}}" class="category-nav-heading">{{label}}</a>
+        <ul class="category-nav-pages">
+          {{#pages}}
+          <li><a href="{{href}}">{{title}}</a></li>
+          {{/pages}}
+        </ul>
+      </div>
+      {{/collapsible}}
+      {{/categories}}
+    </nav>
+  </aside>
+  <div class="specwiki-center">
+    <article class="specwiki-portal" id="content">
+      <h1>Main Page</h1>
+      {{#hasRootIntro}}
+      <div class="specwiki-portal-intro mw-parser-output">
+        {{{rootIntroHtml}}}
+      </div>
+      {{/hasRootIntro}}
+      {{^hasRootIntro}}
+      <p class="specwiki-portal-intro">
+        Structured documentation generated from AI specs, agent instructions,
+        and spec-driven development files in this project.
+      </p>
+      {{/hasRootIntro}}
+      <p><strong>{{pageCount}}</strong> {{pageCountLabel}} indexed.</p>
+      {{#categories}}
+      <section id="{{anchor}}" class="specwiki-category-section">
+        <h2>{{label}}</h2>
+        {{#hasIntro}}
+        <div class="specwiki-category-intro mw-parser-output">
+          {{{introHtml}}}
+        </div>
+        {{/hasIntro}}
+        <ul class="specwiki-portal-pages">
+          {{#pages}}
+          <li><a href="{{href}}">{{title}}</a> — <code>{{sourcePath}}</code></li>
+          {{/pages}}
+        </ul>
+      </section>
+      {{/categories}}
+      <section id="all-pages" class="specwiki-all-pages">
+        <h2>All pages</h2>
+        <ul class="specwiki-portal-pages">
+          {{#allPages}}
+          <li><a href="{{href}}">{{title}}</a></li>
+          {{/allPages}}
+        </ul>
+      </section>
+    </article>
+  </div>
+</div>