diff --git a/app/app/blog/[slug]/page.tsx b/app/app/blog/[slug]/page.tsx index c9de91b..80fcae8 100644 --- a/app/app/blog/[slug]/page.tsx +++ b/app/app/blog/[slug]/page.tsx @@ -6,6 +6,7 @@ import { BLOG_CSS } from '../blog-styles' import EditorialShell from '@/components/editorial/shell' import ReadingProgress from '@/components/blog/reading-progress' import TableOfContents from '@/components/blog/toc' +import TemplateDownload from '@/components/blog/template-download' export function generateStaticParams() { return getAllPosts().map((p) => ({ slug: p.slug })) @@ -152,6 +153,14 @@ export default function BlogPostPage({ params }: { params: { slug: string } }) {
+ {post.templateDownload && ( + + )} + {post.relatedPages.length > 0 && (
Related
diff --git a/app/app/blog/blog-styles.ts b/app/app/blog/blog-styles.ts index 303d0c4..ed8753e 100644 --- a/app/app/blog/blog-styles.ts +++ b/app/app/blog/blog-styles.ts @@ -31,6 +31,13 @@ export const BLOG_CSS = ` .kb-article h3{font-family:var(--font-space-grotesk),sans-serif;font-size:16px;font-weight:600;margin:28px 0 10px;color:var(--ink)} .kb-article h4{font-family:var(--font-space-grotesk),sans-serif;font-size:15px;font-weight:600;margin:24px 0 8px;color:var(--ink)} .kb-article code{font-family:var(--font-mono),monospace;font-size:.86em;background:var(--bg-muted);border:1px solid var(--border);padding:1px 6px;border-radius:6px;color:var(--ink)} +.kb-article pre{background:var(--bg-muted);border:1px solid var(--border);border-radius:12px;padding:18px 20px;overflow-x:auto;margin:0 0 26px} +.kb-article pre code{background:none;border:0;padding:0;font-size:13px;line-height:1.6;color:var(--ink-2);white-space:pre} +.kb-article table{width:100%;border-collapse:collapse;margin:0 0 26px;font-size:14.5px} +.kb-article th,.kb-article td{border:1px solid var(--border);padding:10px 12px;text-align:left;vertical-align:top} +.kb-article th{background:var(--accent-light);font-family:var(--font-space-grotesk),sans-serif;font-weight:600;color:var(--ink)} +.kb-article td{color:var(--ink-2)} +.kb-article[dir="rtl"] th,.kb-article[dir="rtl"] td{text-align:right} .kb-article a{color:var(--accent);text-decoration:underline;text-decoration-color:rgba(31,107,58,.3);text-underline-offset:3px} .kb-article a:hover{text-decoration-color:var(--accent)} .kb-article ul,.kb-article ol{margin:0 0 22px;padding-left:24px;color:var(--ink-2);font-size:16px;line-height:1.75} @@ -44,6 +51,15 @@ export const BLOG_CSS = ` .kb-article[dir="rtl"] ul,.kb-article[dir="rtl"] ol{padding-left:0;padding-right:24px} .kb-article[dir="rtl"] blockquote{border-left:0;border-right:3px solid var(--accent);padding:4px 20px 4px 0} .kb-h1[dir="rtl"]{text-align:right} +.kb-template-dl{max-width:720px;margin:0 auto 8px;padding:0 40px} +.kb-template-dl-card{display:flex;align-items:center;gap:16px;background:var(--accent-light);border:1px solid rgba(31,107,58,.25);border-radius:14px;padding:20px 24px} +.kb-template-dl-icon{flex-shrink:0;width:42px;height:42px;border-radius:10px;background:var(--accent);color:#fff;display:flex;align-items:center;justify-content:center;font-size:19px} +.kb-template-dl-body{flex:1;min-width:0} +.kb-template-dl-label{font-family:var(--font-space-grotesk),sans-serif;font-weight:600;font-size:15px;color:var(--ink);margin-bottom:2px} +.kb-template-dl-sub{font-family:var(--font-mono),monospace;font-size:11.5px;color:var(--ink-3)} +.kb-template-dl-btn{flex-shrink:0;background:var(--accent);color:#fff;text-decoration:none;padding:10px 20px;border-radius:8px;font-weight:600;font-size:14px;white-space:nowrap} +.kb-template-dl-btn:hover{opacity:.9} +@media(max-width:640px){.kb-template-dl{padding:0 20px}.kb-template-dl-card{flex-wrap:wrap}.kb-template-dl-btn{width:100%;text-align:center}} .kb-related{max-width:720px;margin:0 auto;padding:0 40px 56px} .kb-related-row{display:flex;gap:10px;flex-wrap:wrap} .kb-related a{font-family:var(--font-mono),monospace;font-size:12px;color:var(--accent);text-decoration:none;border:1px solid var(--border);background:var(--surface);border-radius:999px;padding:6px 14px} diff --git a/app/components/blog/template-download.tsx b/app/components/blog/template-download.tsx new file mode 100644 index 0000000..3e2829b --- /dev/null +++ b/app/components/blog/template-download.tsx @@ -0,0 +1,47 @@ +'use client' + +import posthog from 'posthog-js' + +/** Tracked download card for a post's free template asset. Fires PostHog + gtag on click. */ +export default function TemplateDownload({ + href, + label, + slug, +}: { + href: string + label: string + slug: string +}) { + const format = href.split('.').pop()?.toUpperCase() ?? 'FILE' + + const track = () => { + try { + posthog.capture('template_download', { slug, href, format }) + } catch (_) {} + if (typeof window !== 'undefined' && (window as any).gtag) { + ;(window as any).gtag('event', 'template_download', { + slug, + href, + format, + event_category: 'content', + }) + } + } + + return ( +
+
+ +
+
{label}
+
Free · no signup · opens in Word / Google Docs
+
+ + Download {format} + +
+
+ ) +} diff --git a/app/lib/blog.ts b/app/lib/blog.ts index d1ae5cb..150d50e 100644 --- a/app/lib/blog.ts +++ b/app/lib/blog.ts @@ -6,8 +6,9 @@ import matter from 'gray-matter' * Blog content lib — reads markdown posts from content/blog/ at build time. * Posts are produced by the blogger routine (routines/blogger/) and validated * by its gates before landing here, so the markdown surface is deliberately - * small: headings, paragraphs, links, inline code, bold/italic. No external - * markdown dependency — the renderer below covers exactly that surface. + * small: headings, paragraphs, links, inline code, bold/italic, GFM tables, + * fenced code blocks. No external markdown dependency — the renderer below + * covers exactly that surface. */ const BLOG_DIR = path.join(process.cwd(), 'content', 'blog') @@ -28,6 +29,8 @@ export interface BlogPostMeta { dir: 'ltr' | 'rtl' /** Absolute-from-root path to the post's social/OG image, or null. */ ogImage: string | null + /** Free downloadable asset (e.g. a copy-paste template as .docx), or null. */ + templateDownload: { href: string; label: string } | null } /** @@ -98,10 +101,21 @@ function renderInline(s: string): string { }) } +/** True if `line` is a GFM table separator row, e.g. `|---|:--:|---|` or `---|---`. */ +function isTableSeparator(line: string): boolean { + const cells = line.trim().replace(/^\||\|$/g, '').split('|') + return cells.length > 0 && cells.every((c) => /^\s*:?-{3,}:?\s*$/.test(c)) +} + +function splitTableRow(line: string): string[] { + return line.trim().replace(/^\||\|$/g, '').split('|').map((c) => c.trim()) +} + /** * Block-level markdown → HTML. Covers the post pipeline's surface: * h1–h4 (leading h1 dropped — the page renders the frontmatter title), - * paragraphs, unordered/ordered lists, blockquotes, hr. + * paragraphs, unordered/ordered lists, blockquotes, hr, GFM tables, + * fenced code blocks, `:::key/note/warn` callouts. */ export function renderMarkdown(md: string): string { const lines = md.split(/\r?\n/) @@ -109,6 +123,7 @@ export function renderMarkdown(md: string): string { let para: string[] = [] let list: { tag: 'ul' | 'ol'; items: string[] } | null = null let callout: { kind: string; lines: string[] } | null = null + let codeFence: string[] | null = null let firstH1Dropped = false const flushPara = () => { @@ -124,9 +139,26 @@ export function renderMarkdown(md: string): string { } } - for (const raw of lines) { + for (let i = 0; i < lines.length; i++) { + const raw = lines[i] const line = raw.trimEnd() + // Fenced code blocks: ```[lang] ... ``` →
, content preserved verbatim (not reflowed).
+    if (codeFence) {
+      if (/^```\s*$/.test(line)) {
+        out.push(`
${escapeHtml(codeFence.join('\n'))}
`) + codeFence = null + } else { + codeFence.push(raw) + } + continue + } + if (/^```/.test(line)) { + flushPara(); flushList() + codeFence = [] + continue + } + // Callout fences: :::key ... ::: → styled