From b751d102f158968aab681cb663d27b4c32197f62 Mon Sep 17 00:00:00 2001 From: Ogulcan Celik Date: Tue, 2 Jun 2026 21:48:02 +0300 Subject: feat: add preview update channel --- website/.gitignore | 1 + website/astro.config.mjs | 2 + website/scripts/prepare-docs.mjs | 80 ++++++++++++++++++- website/src/components/Header.astro | 149 ++++++++++++++++++++++++++++++++++++ website/src/content.config.ts | 3 +- 5 files changed, 230 insertions(+), 5 deletions(-) create mode 100644 website/src/components/Header.astro (limited to 'website') diff --git a/website/.gitignore b/website/.gitignore index 4466e0a1..2d6ddb63 100644 --- a/website/.gitignore +++ b/website/.gitignore @@ -2,3 +2,4 @@ node_modules/ public/ dist/ .astro/ +src/content/docs/preview/ diff --git a/website/astro.config.mjs b/website/astro.config.mjs index badd2873..2da2dd44 100644 --- a/website/astro.config.mjs +++ b/website/astro.config.mjs @@ -62,6 +62,7 @@ export default defineConfig({ }, ], components: { + Header: './src/components/Header.astro', SiteTitle: './src/components/SiteTitle.astro', }, customCss: ['./src/styles/starlight.css'], @@ -129,6 +130,7 @@ export default defineConfig({ label: 'Updates', items: [ { label: 'Releases', link: '/releases/' }, + { label: 'Preview docs', slug: 'docs/preview' }, { label: 'Blog', link: '/blog/' }, ], }, diff --git a/website/scripts/prepare-docs.mjs b/website/scripts/prepare-docs.mjs index c6fefaf7..19201a18 100644 --- a/website/scripts/prepare-docs.mjs +++ b/website/scripts/prepare-docs.mjs @@ -1,12 +1,23 @@ -import { cp, mkdir, rm } from 'node:fs/promises'; -import { dirname, resolve } from 'node:path'; +import { cp, mkdir, readdir, readFile, rm, writeFile } from 'node:fs/promises'; +import { dirname, join, relative, resolve } from 'node:path'; import { fileURLToPath } from 'node:url'; +import process from 'node:process'; const websiteDir = dirname(fileURLToPath(import.meta.url)); const repoRoot = resolve(websiteDir, '../..'); const publicDir = resolve(repoRoot, 'website/public'); +const stableDocsDir = resolve(repoRoot, 'website/src/content/docs'); +const previewDocsSourceDir = resolve(repoRoot, 'docs/next/website/src/content/docs'); +const previewDocsDir = resolve(stableDocsDir, 'preview'); -await preparePublicAssets(); +if (process.argv[2] === '--rewrite-preview-doc-fixture') { + const chunks = []; + for await (const chunk of process.stdin) chunks.push(chunk); + process.stdout.write(rewritePreviewDocContent(Buffer.concat(chunks).toString('utf8'))); +} else { + await preparePublicAssets(); + await preparePreviewDocs(); +} async function preparePublicAssets() { await rm(publicDir, { recursive: true, force: true }); @@ -15,11 +26,17 @@ async function preparePublicAssets() { for (const file of [ 'install.sh', 'latest.json', + 'preview.json', 'robots.txt', '_headers', '_redirects', ]) { - await cp(resolve(repoRoot, 'website', file), resolve(publicDir, file)); + const source = resolve(repoRoot, 'website', file); + try { + await cp(source, resolve(publicDir, file)); + } catch (error) { + if (file !== 'preview.json' || error.code !== 'ENOENT') throw error; + } } for (const directory of ['assets', 'css']) { @@ -28,3 +45,58 @@ async function preparePublicAssets() { }); } } + +async function preparePreviewDocs() { + await rm(previewDocsDir, { recursive: true, force: true }); + await copyPreviewDocs(previewDocsSourceDir, previewDocsDir); +} + +async function copyPreviewDocs(sourceDir, destinationDir) { + await mkdir(destinationDir, { recursive: true }); + for (const entry of await readdir(sourceDir, { withFileTypes: true })) { + const source = join(sourceDir, entry.name); + const destination = join(destinationDir, entry.name); + if (entry.isDirectory()) { + await copyPreviewDocs(source, destination); + continue; + } + if (!entry.isFile()) continue; + + const content = await readFile(source, 'utf8'); + const relativePath = relative(previewDocsSourceDir, source); + await writeFile(destination, rewritePreviewDocContent(content, relativePath), 'utf8'); + } +} + +export function rewritePreviewDocContent(content, relativePath = '') { + const rewritten = content + .replaceAll('/docs/', '/docs/preview/') + .replaceAll('../../../public/', '../../../../public/'); + return insertPreviewNotice(rewritten, relativePath); +} + +function insertPreviewNotice(content, relativePath) { + const notice = [ + '> Preview docs describe unreleased preview builds. Stable docs remain at [/docs/](/docs/).', + '', + '', + ].join('\n'); + const indexPrefix = + relativePath === 'index.mdx' + ? content.replace('title: Herdr documentation', 'title: Herdr preview documentation') + : content; + const frontmatter = indexPrefix.match(/^---\n[\s\S]*?\n---\n/); + if (!frontmatter) { + return insertNoticeAfterImports(indexPrefix, notice); + } + const body = indexPrefix.slice(frontmatter[0].length); + return `${frontmatter[0]}\n${insertNoticeAfterImports(body, notice)}`; +} + +function insertNoticeAfterImports(content, notice) { + const imports = content.match(/^(\s*import .+?;\n)+\s*/); + if (!imports) { + return `${notice}${content}`; + } + return `${imports[0]}${notice}${content.slice(imports[0].length)}`; +} diff --git a/website/src/components/Header.astro b/website/src/components/Header.astro new file mode 100644 index 00000000..982efd2e --- /dev/null +++ b/website/src/components/Header.astro @@ -0,0 +1,149 @@ +--- +import config from 'virtual:starlight/user-config'; + +import LanguageSelect from 'virtual:starlight/components/LanguageSelect'; +import Search from 'virtual:starlight/components/Search'; +import SiteTitle from 'virtual:starlight/components/SiteTitle'; +import SocialIcons from 'virtual:starlight/components/SocialIcons'; +import ThemeSelect from 'virtual:starlight/components/ThemeSelect'; + +const shouldRenderSearch = + config.pagefind || config.components.Search !== '@astrojs/starlight/components/Search.astro'; + +const pathname = Astro.url.pathname; +const isDocs = pathname === '/docs/' || pathname.startsWith('/docs/'); +const isPreview = pathname === '/docs/preview/' || pathname.startsWith('/docs/preview/'); +const stableHref = isPreview ? pathname.replace(/^\/docs\/preview\/?/, '/docs/') : pathname; +const previewHref = isPreview + ? pathname + : pathname === '/docs/' + ? '/docs/preview/' + : pathname.replace(/^\/docs\/?/, '/docs/preview/'); +--- + +
+
+ +
+
+ {isDocs && ( + + )} + {shouldRenderSearch && } +
+
+ + + +
+
+ + diff --git a/website/src/content.config.ts b/website/src/content.config.ts index c9a9b8fd..834d37cf 100644 --- a/website/src/content.config.ts +++ b/website/src/content.config.ts @@ -5,7 +5,8 @@ import { docsSchema } from '@astrojs/starlight/schema'; function docsPath({ entry }: { entry: string }) { const slug = entry.replace(/\.(md|mdx|markdown|mdown|mkdn|mkd|mdwn)$/i, ''); - return slug === 'index' ? 'docs' : `docs/${slug}`; + const normalized = slug.replace(/\/index$/, ''); + return normalized === 'index' ? 'docs' : `docs/${normalized}`; } export const collections = { -- cgit v1.2.3