Skip to content

fix: add localized legacy redirects #100

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
steipete merged 1 commit into from
Jul 11, 2026
Merged

fix: add localized legacy redirects #100

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
22 changes: 19 additions & 3 deletions scripts/docs-site/build.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -714,13 +714,29 @@ function writeRedirects() {
for (const redirect of config.redirects ?? []) {
const source = cleanPath(redirect.source);
const dest = cleanPath(redirect.destination);
writeRedirectFile(source, publicPath(dest));
for (const prefix of new Set([basePath, legacyBasePath].filter(Boolean))) {
writeRedirectFile(`${prefix}${source}`, publicPath(dest));
writeRedirectVariants(source, publicPath(dest));
for (const locale of locales) {
if (locale.root) continue;
writeRedirectVariants(`/${locale.code}${source}`, localizedRedirectDestination(locale.code, dest));
}
}
}

function writeRedirectVariants(source, dest) {
writeRedirectFile(source, dest);
for (const prefix of new Set([basePath, legacyBasePath].filter(Boolean))) {
writeRedirectFile(`${prefix}${source}`, dest);
}
}

function localizedRedirectDestination(locale, dest) {
const [pathname, hash] = dest.split("#");
const slug = normalizeSlug(pathname.replace(/^\/+|\/+$/g, ""));
const page = allPageByKey.get(pageKey(locale, slug));
if (!page) return publicPath(dest);
return publicPath(`${pageRoute(page)}${hash ? `#${hash}` : ""}`);
}

function writeRedirectFile(source, dest) {
const target = path.join(outDir, source.replace(/^\//, ""), "index.html");
if (fs.existsSync(target)) return;
Expand Down
15 changes: 14 additions & 1 deletion scripts/docs-site/smoke.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,7 @@ const previewOrigin = (process.env.DOCS_SITE_CNAME ? `https://${process.env.DOCS
const llmsFullAvailable = process.env.DOCS_SITE_LLMS_FULL_AVAILABLE === "1";
const artifactMode = process.env.DOCS_SITE_ARTIFACT_MODE ?? "full";
const shellOnly = artifactMode === "shell";
const basePath = `/${(process.env.DOCS_SITE_BASE_PATH ?? "").replace(/^\/+|\/+$/g, "")}`.replace(/^\/$/, "");
if (!["full", "shell"].includes(artifactMode)) {
throw new Error(`DOCS_SITE_ARTIFACT_MODE must be full or shell, got ${artifactMode}`);
}
Expand Down Expand Up @@ -734,6 +735,19 @@ if (!fs.existsSync(legacyDigitalOcean)) {
if (!/url=\/(?:docs\/)?install\/digitalocean/.test(fs.readFileSync(legacyDigitalOcean, "utf8"))) {
throw new Error("legacy DigitalOcean redirect: wrong destination");
}
for (const locale of activeLocaleCodes()) {
if (locale === "en") continue;
const localizedCodexSupervisor = path.join(site, locale, "plugins/reference/codex-supervisor/index.html");
if (!fs.existsSync(localizedCodexSupervisor)) {
throw new Error(`localized Codex Supervisor redirect: missing /${locale}/plugins/reference/codex-supervisor`);
}
const localizedDestination = fs.existsSync(path.join(docsDir, locale, "plugins/codex-supervision.md"))
? `${basePath}/${locale}/plugins/codex-supervision`
: `${basePath}/plugins/codex-supervision`;
if (!fs.readFileSync(localizedCodexSupervisor, "utf8").includes(`url=${localizedDestination}`)) {
throw new Error(`localized Codex Supervisor redirect: wrong ${locale} destination`);
}
}
const showcase = fs.readFileSync(path.join(site, "start/showcase/index.html"), "utf8");
if (!/href="https:\/\/x\.com\/i\/status\/2010878524543131691"/.test(showcase)) {
throw new Error("showcase: external card href was not rendered");
Expand All @@ -745,7 +759,6 @@ console.log(`docs site smoke ok: shell, routing, skin, and hidden fixture checks
function assertInternalRoutes() {
const files = walkFiles(site);
const present = new Set(files.map((file) => path.relative(site, file).replaceAll(path.sep, "/")));
const basePath = `/${(process.env.DOCS_SITE_BASE_PATH ?? "").replace(/^\/+|\/+$/g, "")}`.replace(/^\/$/, "");
const missing = new Map();

for (const file of files) {
Expand Down