]*>/i;
+const TITLE_RE = /(.*?)<\/title>/is;
+
+export function fnv1aHash(str) {
+ let hash = 0x811c9dc5;
+ for (let i = 0; i < str.length; i++) {
+ hash ^= str.charCodeAt(i);
+ hash = Math.imul(hash, 0x01000193);
+ }
+ return (hash >>> 0).toString(36);
+}
+
+// Seeded from the deck's filename stem, incrementing the seed on collision
+// against the manifest until a free hash is found. `excludePath` lets a
+// deck that already owns a hash re-derive the same hash without tripping
+// over its own manifest entry.
+export function computeUniqueHash(stem, manifest, { excludePath } = {}) {
+ let attempt = 1;
+ let seed = stem;
+ for (;;) {
+ const hash = fnv1aHash(seed);
+ const existing = manifest[hash];
+ if (!existing || existing.path === excludePath) {
+ return hash;
+ }
+ attempt += 1;
+ seed = `${stem}#${attempt}`;
+ }
+}
+
+export function extractPermalinkHash(html) {
+ const match = html.match(PERMALINK_META_RE);
+ return match ? match[1] : null;
+}
+
+export function insertPermalinkTag(html, hash) {
+ if (!HEAD_OPEN_RE.test(html)) {
+ throw new Error('No <head> tag found');
+ }
+ const tag = `<meta name="${PERMALINK_META_NAME}" content="${hash}">`;
+ return html.replace(HEAD_OPEN_RE, (match) => `${match}\n${tag}`);
+}
+
+export function extractTitle(html) {
+ const match = html.match(TITLE_RE);
+ if (!match) {
+ return null;
+ }
+ const value = match[1].replace(/\s+/g, ' ').trim();
+ return value || null;
+}
+
+export async function loadManifest(rootDir) {
+ const manifestPath = path.join(rootDir, manifestRelativePath);
+ try {
+ const raw = await fs.readFile(manifestPath, 'utf8');
+ return JSON.parse(raw);
+ } catch (err) {
+ if (err.code === 'ENOENT') {
+ return {};
+ }
+ throw err;
+ }
+}
+
+export async function saveManifest(rootDir, manifest) {
+ const manifestPath = path.join(rootDir, manifestRelativePath);
+ const sorted = {};
+ for (const key of Object.keys(manifest).sort()) {
+ sorted[key] = manifest[key];
+ }
+ await fs.writeFile(manifestPath, JSON.stringify(sorted, null, 2) + '\n', 'utf8');
+}
+
+// Walks Decks/ directly (source files, not the staged/published site) since
+// the generator needs to edit the actual deck HTML in place.
+// Percent-encode each path segment so the target is safe to embed in both
+// a JS string literal and an HTML attribute, and resolve it relative to
+// p/<hash>.html so it works unmodified under the GitHub Pages project
+// prefix and the local dev server alike.
+export function toRedirectTarget(publicPath) {
+ return '../' + publicPath.split('/').map(encodeURIComponent).join('/');
+}
+
+export function redirectHtml(target) {
+ return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<title>Redirecting...
+
+Redirecting to the presentation ...
+
+
+`;
+}
+
+export async function collectDeckFiles(rootDir) {
+ const decksRoot = path.join(rootDir, 'Decks');
+ const results = [];
+
+ async function walk(relDir) {
+ const absDir = path.join(decksRoot, relDir);
+ const entries = await fs.readdir(absDir, { withFileTypes: true });
+ for (const entry of entries) {
+ const rel = relDir ? path.posix.join(relDir, entry.name) : entry.name;
+ if (entry.isDirectory()) {
+ await walk(rel);
+ continue;
+ }
+ if (
+ entry.isFile() &&
+ rel.toLowerCase().endsWith('.html') &&
+ path.posix.basename(rel) !== 'index.html'
+ ) {
+ results.push({
+ publicPath: rel,
+ absolutePath: path.join(decksRoot, rel),
+ });
+ }
+ }
+ }
+
+ await walk('');
+ results.sort((a, b) => a.publicPath.localeCompare(b.publicPath));
+ return results;
+}
diff --git a/scripts/site-indexes.mjs b/scripts/site-indexes.mjs
index a3eb83d..7475bbb 100644
--- a/scripts/site-indexes.mjs
+++ b/scripts/site-indexes.mjs
@@ -2,6 +2,7 @@ import fs from 'node:fs/promises';
import path from 'node:path';
import { syncDeckHosting } from '../config/site-map.mjs';
+import { extractPermalinkHash } from './permalink-utils.mjs';
const NATURAL_COLLATOR = new Intl.Collator(undefined, {
numeric: true,
@@ -132,10 +133,10 @@ export const PAGE_STYLE = `
.file-actions a { color: inherit; }
.file-actions a:hover { color: var(--accent); text-decoration: underline; }
.file-actions .sep { color: #3d537e; }
- .file-actions button.copy-url {
+ .tree button.copy-url {
display: inline-flex;
align-items: center;
- color: inherit;
+ color: var(--muted);
background: none;
border: none;
padding: 2px;
@@ -144,12 +145,13 @@ export const PAGE_STYLE = `
border-radius: 4px;
cursor: pointer;
}
- .file-actions button.copy-url svg { width: 14px; height: 14px; display: block; }
- .file-actions button.copy-url:hover { color: var(--accent); }
- .file-actions button.copy-url:focus-visible { outline: 1px solid var(--accent); outline-offset: 2px; }
- .file-actions button.copy-url.copied { color: #7cd992; }
- .file-actions button.copy-url.failed { color: #ff8a80; }
- .file-actions button.copy-url:disabled { cursor: default; }
+ .tree button.copy-url svg { width: 14px; height: 14px; display: block; }
+ .tree button.copy-url:hover { color: var(--accent); }
+ .tree button.copy-url:focus-visible { outline: 1px solid var(--accent); outline-offset: 2px; }
+ .tree button.copy-url.copied { color: #7cd992; }
+ .tree button.copy-url.failed { color: #ff8a80; }
+ .tree button.copy-url:disabled { cursor: default; }
+ .tree button.copy-url-labeled { gap: 4px; }
@media (max-width: 640px) {
.tree li.file {
flex-direction: column;
@@ -201,9 +203,10 @@ export const PAGE_SCRIPT = `
document.querySelectorAll('a[data-launch-path]').forEach((a) => {
const presentationUrl = resolveUrl(a.getAttribute('data-launch-path') || '');
- if (a.getAttribute('data-launch') === 'instructor') {
+ const launchMode = a.getAttribute('data-launch');
+ if (launchMode === 'instructor') {
a.href = buildActiveBitsUrl(launchPath, presentationUrl, { mode: 'instructor' });
- } else {
+ } else if (launchMode === 'syncdeck') {
a.href = buildActiveBitsUrl(permalinkPath, presentationUrl);
}
});
@@ -277,6 +280,15 @@ export async function defaultTitleForFile(filePath) {
return path.basename(filePath, path.extname(filePath)).replace(/[-_]/g, ' ').trim();
}
+export async function permalinkHashForFile(filePath) {
+ try {
+ const text = await fs.readFile(filePath, 'utf8');
+ return extractPermalinkHash(text);
+ } catch {
+ return null;
+ }
+}
+
function makePage(titleText, heading, description, listing, generatedAt, generatedAtIso, backLink = null) {
const backHtml = backLink
? `← Back
`
@@ -307,19 +319,31 @@ ${listing}
`;
}
-function renderTree(node, indent = ' ', pathPrefix = '') {
+function renderTree(node, indent = ' ', pathPrefix = '', pageDepth = 0) {
const lines = [];
+ // pageDepth is how many directories the *page being rendered* sits below
+ // the site root (constant across this recursion), not how deep `pathPrefix`
+ // has nested within that single page's listing — those are different axes.
+ const rootPrefix = '../'.repeat(pageDepth);
for (const file of [...node.files].sort((a, b) => NATURAL_COLLATOR.compare(a.title, b.title))) {
const relativeHref = `${pathPrefix}${file.name}`;
+ const permalinkHref = file.permalinkHash ? `${rootPrefix}p/${file.permalinkHash}.html` : null;
+ // The syncdeck link is fed to ActiveBits as presentationUrl, so route it
+ // through our own stable permalink when one exists rather than the raw
+ // (reorg-fragile) path.
+ const syncdeckLaunchPath = permalinkHref || relativeHref;
lines.push(
`${indent}${escapeHtml(file.title)} ` +
+ `${ICON_COPY} ` +
`` +
`Start as instructor ` +
`· ` +
- `Get permalink ` +
- `· ` +
- `${ICON_COPY} ` +
+ `Syncdeck link ` +
+ (permalinkHref
+ ? `· ` +
+ `Permalink ${ICON_COPY} `
+ : '') +
` ${escapeHtml(dirname)}/ `
);
lines.push(`${indent} `);
- lines.push(...renderTree(child, indent + ' ', `${pathPrefix}${dirname}/`));
+ lines.push(...renderTree(child, indent + ' ', `${pathPrefix}${dirname}/`, pageDepth));
lines.push(`${indent} `);
lines.push(`${indent} `);
lines.push(`${indent}`);
@@ -341,7 +365,7 @@ function renderTree(node, indent = ' ', pathPrefix = '') {
return lines;
}
-export async function buildIndexPages(htmlFiles, getTitleForPublicPath) {
+export async function buildIndexPages(htmlFiles, getTitleForPublicPath, getPermalinkForPublicPath) {
const generatedAtDt = new Date();
const generatedAt = generatedAtDt.toISOString().replace('T', ' ').replace(/\.\d{3}Z$/, ' UTC');
const generatedAtIso = generatedAtDt.toISOString();
@@ -356,6 +380,7 @@ export async function buildIndexPages(htmlFiles, getTitleForPublicPath) {
titledEntries.push({
rel,
title: await getTitleForPublicPath(rel),
+ permalinkHash: getPermalinkForPublicPath ? await getPermalinkForPublicPath(rel) : null,
});
}
@@ -376,6 +401,7 @@ export async function buildIndexPages(htmlFiles, getTitleForPublicPath) {
name: parsed.base,
rel: relPath,
title: entry.title,
+ permalinkHash: entry.permalinkHash,
});
}
@@ -401,7 +427,8 @@ export async function buildIndexPages(htmlFiles, getTitleForPublicPath) {
function addFolderPages(node, folder = '.') {
for (const [dirname, child] of [...node.dirs.entries()].sort((a, b) => NATURAL_COLLATOR.compare(a[0], b[0]))) {
const childFolder = folder === '.' ? dirname : `${folder}/${dirname}`;
- const listingLines = renderTree(child);
+ const pageDepth = childFolder.split('/').filter(Boolean).length;
+ const listingLines = renderTree(child, ' ', '', pageDepth);
const listing = listingLines.length
? listingLines.join('\n')
: ' No presentations found. ';