diff --git a/index.html b/index.html index d81e9a8..717146c 100644 --- a/index.html +++ b/index.html @@ -7,10 +7,10 @@ - Devy Archive - + Devy 블로그 — 백엔드·인프라·AI 개발 기록 | Devy Archive + - + @@ -22,7 +22,7 @@ - + diff --git a/scripts/prerender.mjs b/scripts/prerender.mjs index 725d17d..1d79ce9 100644 --- a/scripts/prerender.mjs +++ b/scripts/prerender.mjs @@ -41,7 +41,7 @@ function outputPathFor(routePath) { function withHead(templateHtml, route) { const fullTitle = toFullTitle(route.title) - const description = route.description || "Devy의 개발과 운영 기록을 문제 해결 중심으로 모아둔 아카이브입니다." + const description = route.description || "Devy의 기술 블로그입니다. 백엔드·클라우드 인프라·AI 개발과 운영에서 겪은 문제와 해결 과정을 기록합니다." const previewTitle = route.ogTitle || fullTitle const previewDescription = route.ogDescription || description const canonicalPath = route.canonicalPath || route.path diff --git a/scripts/seo.test.mjs b/scripts/seo.test.mjs index 587e6c5..0e3bf45 100644 --- a/scripts/seo.test.mjs +++ b/scripts/seo.test.mjs @@ -71,12 +71,45 @@ test("all published articles include visible content and matching React-owned st } }) -test("home, collection, and project metadata is rendered by the active React page", () => { +test("localized homes identify one website while preserving each blog's canonical URL", () => { + const homes = [...pages].filter(([url]) => /^\/(en\/)?$/.test(new URL(url).pathname)) + assert.equal(homes.length, 2) + let websiteIdentity + + for (const [url, html] of homes) { + const documents = schemas(html) + assert.equal(documents.length, 2, url) + const websites = documents.filter((document) => document["@type"] === "WebSite") + const blogs = documents.filter((document) => document["@type"] === "Blog") + assert.equal(websites.length, 1, url) + assert.equal(blogs.length, 1, url) + + const website = websites[0] + assert.equal(website.url, `${origin}/`, `localized path incorrectly identifies a separate website: ${url}`) + assert.equal(website["@id"], `${origin}/#website`, url) + assert.equal(website.name, "Devy Archive", url) + assert.equal(website.name, text(html.match(/]*>([\s\S]*?)<\/body>/)?.[1] ?? "" + const visibleContent = text(body.replace(/]*>[\s\S]*?<\/script>/g, "")) + assert.ok(visibleContent.includes(website.name), `preferred site name is missing from the visible home: ${url}`) + assert.ok(Array.isArray(website.alternateName), url) + for (const name of ["Devy 블로그", "Devy 기술 블로그", "Devy Blog", "dev.devy.dev"]) { + assert.ok(website.alternateName.includes(name), `missing recognizable site name ${name}: ${url}`) + } + if (websiteIdentity) assert.deepEqual(website, websiteIdentity, `language variants identify different websites: ${url}`) + else websiteIdentity = website + + assert.equal(blogs[0].url, url) + assert.equal(blogs[0].inLanguage, new URL(url).pathname.startsWith("/en/") ? "en" : "ko-KR", url) + assert.ok(!schemas(html.split("")[0]).length, `unmanaged head schema: ${url}`) + } +}) + +test("collection and project metadata is rendered by the active React page", () => { for (const [url, html] of pages) { const pathname = new URL(url).pathname - const expected = /^\/(en\/)?$/.test(pathname) ? "Blog" - : /^\/(en\/)?posts\/$/.test(pathname) ? "CollectionPage" - : pathname.includes("/about/projects/") ? "WebPage" : null + const expected = /^\/(en\/)?posts\/$/.test(pathname) ? "CollectionPage" + : pathname.includes("/about/projects/") ? "WebPage" : null if (!expected) continue const documents = schemas(html) assert.equal(documents.length, 1, url) diff --git a/src/entry-server.tsx b/src/entry-server.tsx index 72d076a..072658e 100644 --- a/src/entry-server.tsx +++ b/src/entry-server.tsx @@ -8,6 +8,7 @@ import type { ProjectDetail } from "./data/resume" import { getAllPosts } from "./lib/posts" import { getRouteLanguage, localizePath, postPath } from "./lib/i18n-routing" import type { Language } from "./i18n" +import { ko, en } from "./i18n/translations" export { preparePostContentForPrerender, getPostHydrationData } from "./lib/posts" export interface PrerenderRoute { @@ -33,18 +34,16 @@ function toCanonicalPath(path: string) { function localizedStaticRoutes(language: Language): PrerenderRoute[] { const isEnglish = language === "en" const path = (basePath: string) => toCanonicalPath(localizePath(basePath, language)) - const homeDescription = isEnglish - ? "An archive of Devy's development and operations notes, organized around problem solving." - : "Devy의 개발과 운영 기록을 문제 해결 중심으로 모아둔 아카이브입니다." + const meta = (isEnglish ? en : ko).meta const postsDescription = isEnglish ? "All blog posts." : "개발하며 배운 것들을 정리한 글 목록입니다." return [ { path: path("/"), language, - title: isEnglish ? "Backend and Infrastructure Engineering Notes" : "백엔드·인프라 개발 기록", - description: homeDescription, - ogTitle: "Devy Archive", + title: meta.homeTitle, + description: meta.defaultDescription, + ogTitle: meta.siteName, alternates: { ko: "/", en: "/en/", diff --git a/src/i18n/translations.ts b/src/i18n/translations.ts index ae2790f..81b3ed2 100644 --- a/src/i18n/translations.ts +++ b/src/i18n/translations.ts @@ -276,7 +276,7 @@ export const ko: Translations = { }, home: { title: "What works, and why.", - subtitle: "무엇이 통했고, 왜 그랬는지 기록합니다.", + subtitle: "Devy Archive는 Devy의 기술 블로그입니다. 백엔드·인프라·AI를 개발하고 운영하며 배운 것을 기록합니다.", viewPosts: "글 목록 보기", introduction: "소개", popularPosts: "인기 글", @@ -493,8 +493,8 @@ export const ko: Translations = { }, meta: { siteName: "Devy Archive", - homeTitle: "백엔드·인프라 개발 기록", - defaultDescription: "Devy의 개발과 운영 기록을 문제 해결 중심으로 모아둔 아카이브입니다.", + homeTitle: "Devy 블로그 — 백엔드·인프라·AI 개발 기록", + defaultDescription: "Devy의 기술 블로그입니다. 백엔드·클라우드 인프라·AI 개발과 운영에서 겪은 문제와 해결 과정을 기록합니다.", }, } @@ -525,7 +525,7 @@ export const en: Translations = { }, home: { title: "What works, and why.", - subtitle: "Documenting what worked, and why.", + subtitle: "Devy Archive is Devy's technical blog. Lessons from building and operating backend systems, infrastructure, and AI.", viewPosts: "View Posts", introduction: "About", popularPosts: "Popular Posts", @@ -742,7 +742,7 @@ export const en: Translations = { }, meta: { siteName: "Devy Archive", - homeTitle: "Backend and Infrastructure Engineering Notes", - defaultDescription: "An archive of Devy's development and operations notes, organized around problem solving.", + homeTitle: "Devy Blog — Backend, Infrastructure, and AI Engineering", + defaultDescription: "Devy's technical blog about backend engineering, cloud infrastructure, and AI. Notes on development and operations problems and how they were solved.", }, } diff --git a/src/lib/structured-data.ts b/src/lib/structured-data.ts index 7b3559d..21a954b 100644 --- a/src/lib/structured-data.ts +++ b/src/lib/structured-data.ts @@ -8,6 +8,17 @@ const BASE_URL = "https://dev.devy.dev" const SITE_NAME = "Devy Archive" const OG_IMAGE_URL = `${BASE_URL}/og-image.png?v=20260922-5` +export function websiteStructuredData() { + return { + "@context": "https://schema.org", + "@type": "WebSite", + "@id": `${BASE_URL}/#website`, + name: SITE_NAME, + alternateName: ["Devy 블로그", "Devy 기술 블로그", "Devy Blog", "dev.devy.dev"], + url: `${BASE_URL}/`, + } +} + function articleText(markdown: string) { return markdown .replace(/```[\s\S]*?```/g, "") diff --git a/src/pages/HomePage.tsx b/src/pages/HomePage.tsx index 02ed30d..c878f8a 100644 --- a/src/pages/HomePage.tsx +++ b/src/pages/HomePage.tsx @@ -10,7 +10,7 @@ import { ArrowRight, Eye } from "lucide-react" import { useLanguage } from "@/i18n" import { localizePath, postPath } from "@/lib/i18n-routing" import { StructuredData } from "@/components/StructuredData" -import { blogStructuredData } from "@/lib/structured-data" +import { blogStructuredData, websiteStructuredData } from "@/lib/structured-data" export function HomePage() { const { language, t } = useLanguage() @@ -44,6 +44,7 @@ export function HomePage() { return ( + {/* Hero */}
diff --git a/vite.config.ts b/vite.config.ts index 2feecf7..d830a94 100644 --- a/vite.config.ts +++ b/vite.config.ts @@ -7,6 +7,7 @@ import { assertValidPostDates, getPostModifiedDate } from "./src/lib/post-dates" import { PROJECTS } from "./src/data/resume" import { imageAssetsPlugin } from "./scripts/image-assets" import { previewPagesPlugin } from "./scripts/preview-pages" +import { ko, en } from "./src/i18n/translations" const BASE_URL = "https://dev.devy.dev" const LANGUAGES = ["ko", "en"] as const @@ -97,6 +98,7 @@ function rssPlugin(): Plugin { function writeFeed(language: ContentLanguage) { const posts = readPosts(language) const isEnglish = language === "en" + const meta = (isEnglish ? en : ko).meta const items = posts.map((p) => ` ${escapeXml(p.title)} @@ -109,9 +111,9 @@ function rssPlugin(): Plugin { const rss = ` - Devy Archive + ${escapeXml(meta.siteName)} ${isEnglish ? `${BASE_URL}/en/` : BASE_URL} - ${isEnglish ? "An archive of Devy's development and operations notes, organized around problem solving." : "Devy의 개발과 운영 기록을 문제 해결 중심으로 모아둔 아카이브입니다."} + ${escapeXml(meta.defaultDescription)} ${isEnglish ? "en" : "ko"} ${items.join("\n")}