@limcpf/everything-is-a-markdown 0.5.4 → 0.5.5

package/README.ko.md

@@ -38,6 +38,8 @@ bun run blog [build|dev|clean] [options]
 - `--vault <path>`: Markdown 루트 디렉터리 (기본 `.`)
 - `--out <path>`: 출력 디렉터리 (기본 `dist`)
 - `--exclude <glob>`: 제외 패턴 추가 (반복 가능)
+- `--new-within-days <n>`: NEW 배지 기준 일수 (정수 `>= 0`, 기본 `7`)
+- `--recent-limit <n>`: Recent 폴더 문서 수 제한 (정수 `>= 1`, 기본 `5`)
 - `--port <n>`: 개발 서버 포트 (기본 `3000`)
 
 ## 설정 파일 (`blog.config.ts`)
@@ -51,6 +53,7 @@ const config = {
   staticPaths: ["assets", "public/favicon.ico"],
   seo: {
     siteUrl: "https://example.com",
+    pathBase: "/blog",
     defaultOgImage: "/assets/og.png",
   },
 };
@@ -65,6 +68,12 @@ export default config;
 - 지정한 경로의 파일들을 `dist`에 같은 상대 경로로 복사
 - 예: 볼트 `assets/og.png` -> `dist/assets/og.png`
 
+`seo.pathBase`:
+
+- 서브패스 배포(예: `/blog`)를 정식 지원합니다.
+- 내부 라우팅/본문 fetch 링크에 동일한 base path가 적용됩니다.
+- 루트 배포는 빈 문자열(`""`)을 사용합니다.
+
 예시:
 
 ```bash

package/README.md

@@ -38,6 +38,8 @@ Common options:
 - `--vault <path>`: Markdown root directory (default `.`)
 - `--out <path>`: Output directory (default `dist`)
 - `--exclude <glob>`: Add exclude pattern (repeatable)
+- `--new-within-days <n>`: NEW badge threshold days (integer `>= 0`, default `7`)
+- `--recent-limit <n>`: Recent folder item limit (integer `>= 1`, default `5`)
 - `--port <n>`: Dev server port (default `3000`)
 
 ## Config File (`blog.config.ts`)
@@ -51,6 +53,7 @@ const config = {
   staticPaths: ["assets", "public/favicon.ico"],
   seo: {
     siteUrl: "https://example.com",
+    pathBase: "/blog",
     defaultOgImage: "/assets/og.png",
   },
 };
@@ -65,6 +68,12 @@ export default config;
 - Copies all matched files into the same relative location in `dist`
 - Example: `assets/og.png` in vault becomes `dist/assets/og.png`
 
+`seo.pathBase`:
+
+- Deploy under a subpath (for example `/blog`)
+- Internal routing/content fetch links are generated with this base path
+- Keep empty (`""`) for root deployment
+
 Examples:
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@limcpf/everything-is-a-markdown",
-  "version": "0.5.4",
+  "version": "0.5.5",
   "license": "MIT",
   "private": false,
   "type": "module",

package/src/build.ts

@@ -866,6 +866,7 @@ function buildManifest(docs: DocRecord[], tree: TreeNode[], options: BuildOption
   return {
     generatedAt: new Date().toISOString(),
     siteTitle: resolveSiteTitle(options),
+    pathBase: options.seo?.pathBase ?? "",
     defaultBranch: DEFAULT_BRANCH,
     branches,
     ui: {
@@ -1206,7 +1207,23 @@ function renderInitialMeta(doc: DocRecord): string {
   return items.join("");
 }
 
-function renderInitialNav(docs: DocRecord[], currentId: string): string {
+function toPathWithBase(pathname: string, pathBase: string): string {
+  const cleanBase = pathBase.trim().replace(/\\/g, "/");
+  const normalizedBase = !cleanBase || cleanBase === "/"
+    ? ""
+    : `/${cleanBase.replace(/^\/+/, "").replace(/\/+$/, "")}`;
+  if (!normalizedBase) {
+    return pathname;
+  }
+
+  if (pathname === "/") {
+    return `${normalizedBase}/`;
+  }
+  const normalizedPathname = pathname.startsWith("/") ? pathname : `/${pathname}`;
+  return `${normalizedBase}${normalizedPathname}`;
+}
+
+function renderInitialNav(docs: DocRecord[], currentId: string, pathBase: string): string {
   const currentIndex = docs.findIndex((doc) => doc.id === currentId);
   if (currentIndex === -1) {
     return "";
@@ -1217,16 +1234,16 @@ function renderInitialNav(docs: DocRecord[], currentId: string): string {
 
   let html = "";
   if (prev) {
-    html += `<a href="${escapeHtmlAttribute(prev.route)}" class="nav-link nav-link-prev" data-route="${escapeHtmlAttribute(prev.route)}"><div class="nav-link-label"><span class="material-symbols-outlined">arrow_back</span>Previous</div><div class="nav-link-title">${escapeHtmlAttribute(prev.title)}</div></a>`;
+    html += `<a href="${escapeHtmlAttribute(toPathWithBase(prev.route, pathBase))}" class="nav-link nav-link-prev" data-route="${escapeHtmlAttribute(prev.route)}"><div class="nav-link-label"><span class="material-symbols-outlined">arrow_back</span>Previous</div><div class="nav-link-title">${escapeHtmlAttribute(prev.title)}</div></a>`;
   }
   if (next) {
-    html += `<a href="${escapeHtmlAttribute(next.route)}" class="nav-link nav-link-next" data-route="${escapeHtmlAttribute(next.route)}"><div class="nav-link-label">Next<span class="material-symbols-outlined">arrow_forward</span></div><div class="nav-link-title">${escapeHtmlAttribute(next.title)}</div></a>`;
+    html += `<a href="${escapeHtmlAttribute(toPathWithBase(next.route, pathBase))}" class="nav-link nav-link-next" data-route="${escapeHtmlAttribute(next.route)}"><div class="nav-link-label">Next<span class="material-symbols-outlined">arrow_forward</span></div><div class="nav-link-title">${escapeHtmlAttribute(next.title)}</div></a>`;
   }
 
   return html;
 }
 
-function renderInitialBacklinks(backlinks: Manifest["docs"][number]["backlinks"]): string {
+function renderInitialBacklinks(backlinks: Manifest["docs"][number]["backlinks"], pathBase: string): string {
   if (backlinks.length === 0) {
     return "";
   }
@@ -1236,7 +1253,7 @@ function renderInitialBacklinks(backlinks: Manifest["docs"][number]["backlinks"]
     const prefixHtml = backlink.prefix
       ? `<span class="backlink-prefix">${escapeHtmlAttribute(backlink.prefix)}</span>`
       : "";
-    html += `<li class="backlinks-item"><a href="${escapeHtmlAttribute(backlink.route)}" class="backlink-link" data-route="${escapeHtmlAttribute(backlink.route)}">${prefixHtml}<span class="backlink-text">${escapeHtmlAttribute(backlink.title)}</span></a></li>`;
+    html += `<li class="backlinks-item"><a href="${escapeHtmlAttribute(toPathWithBase(backlink.route, pathBase))}" class="backlink-link" data-route="${escapeHtmlAttribute(backlink.route)}">${prefixHtml}<span class="backlink-text">${escapeHtmlAttribute(backlink.title)}</span></a></li>`;
   }
   html += "</ul>";
   return html;
@@ -1247,6 +1264,7 @@ function buildInitialView(
   docs: DocRecord[],
   contentHtml: string,
   manifestDocById: Map<string, Manifest["docs"][number]>,
+  pathBase: string,
 ): AppShellInitialView {
   const manifestDoc = manifestDocById.get(doc.id);
   return {
@@ -1256,8 +1274,8 @@ function buildInitialView(
     breadcrumbHtml: renderInitialBreadcrumb(doc.route),
     metaHtml: renderInitialMeta(doc),
     contentHtml,
-    backlinksHtml: renderInitialBacklinks(manifestDoc?.backlinks ?? []),
-    navHtml: renderInitialNav(docs, doc.id),
+    backlinksHtml: renderInitialBacklinks(manifestDoc?.backlinks ?? [], pathBase),
+    navHtml: renderInitialNav(docs, doc.id, pathBase),
   };
 }
 
@@ -1270,10 +1288,11 @@ async function writeShellPages(
   contentByDocId: Map<string, string>,
 ): Promise<void> {
   const manifestDocById = new Map(manifest.docs.map((doc) => [doc.id, doc]));
+  const pathBase = options.seo?.pathBase ?? "";
   const indexDoc = pickHomeDoc(docs);
   const indexOutputPath = "index.html";
   const indexInitialView = indexDoc
-    ? buildInitialView(indexDoc, docs, contentByDocId.get(indexDoc.id) ?? "", manifestDocById)
+    ? buildInitialView(indexDoc, docs, contentByDocId.get(indexDoc.id) ?? "", manifestDocById, pathBase)
     : null;
   const shell = renderAppShellHtml(
     buildShellMeta("/", null, options),
@@ -1291,7 +1310,7 @@ async function writeShellPages(
 
   for (const doc of docs) {
     const routeOutputPath = toRouteOutputPath(doc.route);
-    const initialView = buildInitialView(doc, docs, contentByDocId.get(doc.id) ?? "", manifestDocById);
+    const initialView = buildInitialView(doc, docs, contentByDocId.get(doc.id) ?? "", manifestDocById, pathBase);
     await writeOutputIfChanged(
       context,
       routeOutputPath,
@@ -1495,16 +1514,12 @@ export async function buildSite(options: BuildOptions): Promise<BuildResult> {
     outputContext.nextHashes[contentRelPath] = sourceHash;
 
     if (unchanged) {
-      skippedDocs += 1;
       const outputFile = Bun.file(outputPath);
       if (await outputFile.exists()) {
+        skippedDocs += 1;
         contentByDocId.set(doc.id, await outputFile.text());
-      } else {
-        const resolver = createWikiResolver(wikiLookup, doc);
-        const renderResult = await markdownRenderer.render(doc.body, resolver);
-        contentByDocId.set(doc.id, renderResult.html);
+        continue;
       }
-      continue;
     }
 
     const resolver = createWikiResolver(wikiLookup, doc);

package/src/config.ts

@@ -199,6 +199,13 @@ export async function loadPinnedMenuConfig(
   return normalizePinnedMenu((parsed as Record<string, unknown>).pinnedMenu, "[menu-config]");
 }
 
+function ensureIntegerOption(value: unknown, optionLabel: string, min: number): number {
+  if (typeof value !== "number" || !Number.isFinite(value) || !Number.isInteger(value) || value < min) {
+    throw new Error(`[config] "${optionLabel}" must be an integer >= ${min}`);
+  }
+  return value;
+}
+
 export function resolveBuildOptions(
   cli: CliArgs,
   userConfig: UserConfig,
@@ -219,14 +226,24 @@ export function resolveBuildOptions(
       : undefined;
   const configPinnedMenu = normalizePinnedMenu(userConfig.pinnedMenu, "[config]");
   const resolvedPinnedMenu = pinnedMenu ?? configPinnedMenu;
+  const newWithinDays = ensureIntegerOption(
+    cli.newWithinDays ?? userConfig.ui?.newWithinDays ?? DEFAULTS.newWithinDays,
+    "--new-within-days (or ui.newWithinDays)",
+    0,
+  );
+  const recentLimit = ensureIntegerOption(
+    cli.recentLimit ?? userConfig.ui?.recentLimit ?? DEFAULTS.recentLimit,
+    "--recent-limit (or ui.recentLimit)",
+    1,
+  );
 
   return {
     vaultDir,
     outDir,
     exclude: mergedExclude,
     staticPaths,
-    newWithinDays: cli.newWithinDays ?? userConfig.ui?.newWithinDays ?? DEFAULTS.newWithinDays,
-    recentLimit: cli.recentLimit ?? userConfig.ui?.recentLimit ?? DEFAULTS.recentLimit,
+    newWithinDays,
+    recentLimit,
     siteTitle,
     pinnedMenu: resolvedPinnedMenu,
     wikilinks: userConfig.markdown?.wikilinks ?? DEFAULTS.wikilinks,

package/src/runtime/app.js

@@ -37,15 +37,63 @@ function toSafeUrlPath(input) {
     .join("/");
 }
 
+function normalizePathname(pathname) {
+  let normalized = "/";
+  try {
+    normalized = decodeURIComponent(pathname || "/");
+  } catch {
+    normalized = String(pathname || "/");
+  }
+  if (!normalized.startsWith("/")) {
+    normalized = `/${normalized}`;
+  }
+  return normalized.replace(/\/+/g, "/") || "/";
+}
+
 function normalizeRoute(pathname) {
-  let route = decodeURIComponent(pathname || "/");
-  if (!route.startsWith("/")) {
-    route = `/${route}`;
+  const normalized = normalizePathname(pathname);
+  if (normalized.endsWith("/")) {
+    return normalized;
+  }
+  return `${normalized}/`;
+}
+
+function normalizePathBase(pathBase) {
+  if (typeof pathBase !== "string") {
+    return "";
   }
-  if (!route.endsWith("/")) {
-    route = `${route}/`;
+
+  const cleaned = pathBase.trim().replace(/\\/g, "/");
+  if (!cleaned || cleaned === "/") {
+    return "";
   }
-  return route;
+
+  return `/${cleaned.replace(/^\/+/, "").replace(/\/+$/, "")}`;
+}
+
+function stripPathBase(pathname, pathBase) {
+  const normalizedPath = normalizePathname(pathname);
+  if (!pathBase) {
+    return normalizedPath;
+  }
+  if (normalizedPath === pathBase) {
+    return "/";
+  }
+  if (normalizedPath.startsWith(`${pathBase}/`)) {
+    return normalizedPath.slice(pathBase.length) || "/";
+  }
+  return normalizedPath;
+}
+
+function toPathWithBase(pathname, pathBase) {
+  const normalizedPath = normalizePathname(pathname);
+  if (!pathBase) {
+    return toSafeUrlPath(normalizedPath);
+  }
+  if (normalizedPath === "/") {
+    return toSafeUrlPath(`${pathBase}/`);
+  }
+  return toSafeUrlPath(`${pathBase}${normalizedPath}`);
 }
 
 function loadInitialViewData() {
@@ -114,21 +162,9 @@ function loadInitialManifestData() {
   }
 }
 
-function resolveRouteFromLocation(routeMap) {
-  const direct = normalizeRoute(location.pathname);
-  if (routeMap[direct]) {
-    return direct;
-  }
-
-  if (location.search.length > 1) {
-    const recovered = normalizeRoute(`${location.pathname}?${location.search.slice(1)}`);
-    if (routeMap[recovered]) {
-      history.replaceState(null, "", toSafeUrlPath(recovered));
-      return recovered;
-    }
-  }
-
-  return direct;
+function resolveRouteFromLocation(routeMap, pathBase) {
+  const direct = normalizeRoute(stripPathBase(location.pathname, pathBase));
+  return routeMap[direct] ? direct : direct;
 }
 
 function resolveSiteTitle(manifest) {
@@ -612,7 +648,7 @@ function initializeTreeLabelTooltip(treeRoot, tooltipEl) {
   };
 }
 
-function createFolderNode(node, expandedSet, fileRowsById, depth = 0) {
+function createFolderNode(node, expandedSet, fileRowsById, pathBase, depth = 0) {
   const wrapper = document.createElement("div");
   wrapper.className = node.virtual ? "tree-folder virtual" : "tree-folder";
   wrapper.style.setProperty("--tree-depth", String(depth));
@@ -627,7 +663,7 @@ function createFolderNode(node, expandedSet, fileRowsById, depth = 0) {
   const isExpanded = node.virtual ? true : expandedSet.has(node.path);
   const iconName = isExpanded ? "folder_open" : "folder";
 
-  row.innerHTML = `<span class="material-symbols-outlined">${iconName}</span><span class="tree-label">${node.name}</span>`;
+  row.innerHTML = `<span class="material-symbols-outlined">${iconName}</span><span class="tree-label">${escapeHtmlAttr(node.name)}</span>`;
   row.setAttribute("aria-expanded", String(isExpanded));
 
   const children = document.createElement("div");
@@ -638,9 +674,9 @@ function createFolderNode(node, expandedSet, fileRowsById, depth = 0) {
 
   for (const child of node.children) {
     if (child.type === "folder") {
-      children.appendChild(createFolderNode(child, expandedSet, fileRowsById, depth + 1));
+      children.appendChild(createFolderNode(child, expandedSet, fileRowsById, pathBase, depth + 1));
     } else {
-      children.appendChild(createFileNode(child, fileRowsById, depth + 1));
+      children.appendChild(createFileNode(child, fileRowsById, pathBase, depth + 1));
     }
   }
 
@@ -649,9 +685,9 @@ function createFolderNode(node, expandedSet, fileRowsById, depth = 0) {
   return wrapper;
 }
 
-function createFileNode(node, fileRowsById, depth = 0) {
+function createFileNode(node, fileRowsById, pathBase, depth = 0) {
   const row = document.createElement("a");
-  row.href = node.route;
+  row.href = toPathWithBase(node.route, pathBase);
   row.className = "tree-row tree-file-row";
   row.dataset.rowType = "file";
   row.dataset.route = node.route;
@@ -751,7 +787,7 @@ function renderMeta(doc) {
   return items.join("");
 }
 
-function renderNav(docs, docIndexById, currentId) {
+function renderNav(docs, docIndexById, currentId, pathBase) {
   const currentIndex = docIndexById.get(currentId) ?? -1;
   if (currentIndex === -1) return "";
 
@@ -761,23 +797,23 @@ function renderNav(docs, docIndexById, currentId) {
   let html = "";
 
   if (prev) {
-    html += `<a href="${toSafeUrlPath(prev.route)}" class="nav-link nav-link-prev" data-route="${escapeHtmlAttr(prev.route)}">
+    html += `<a href="${toPathWithBase(prev.route, pathBase)}" class="nav-link nav-link-prev" data-route="${escapeHtmlAttr(prev.route)}">
       <div class="nav-link-label"><span class="material-symbols-outlined">arrow_back</span>Previous</div>
-      <div class="nav-link-title">${prev.title}</div>
+      <div class="nav-link-title">${escapeHtmlAttr(prev.title)}</div>
     </a>`;
   }
 
   if (next) {
-    html += `<a href="${toSafeUrlPath(next.route)}" class="nav-link nav-link-next" data-route="${escapeHtmlAttr(next.route)}">
+    html += `<a href="${toPathWithBase(next.route, pathBase)}" class="nav-link nav-link-next" data-route="${escapeHtmlAttr(next.route)}">
       <div class="nav-link-label">Next<span class="material-symbols-outlined">arrow_forward</span></div>
-      <div class="nav-link-title">${next.title}</div>
+      <div class="nav-link-title">${escapeHtmlAttr(next.title)}</div>
     </a>`;
   }
 
   return html;
 }
 
-function renderBacklinks(doc) {
+function renderBacklinks(doc, pathBase) {
   const backlinks = Array.isArray(doc.backlinks) ? doc.backlinks : [];
   if (backlinks.length === 0) {
     return "";
@@ -790,7 +826,7 @@ function renderBacklinks(doc) {
       : "";
     const route = typeof backlink.route === "string" ? normalizeRoute(backlink.route) : "/";
     const title = typeof backlink.title === "string" && backlink.title.trim().length > 0 ? backlink.title : route;
-    html += `<li class="backlinks-item"><a href="${toSafeUrlPath(route)}" class="backlink-link" data-route="${escapeHtmlAttr(route)}">${prefix}<span class="backlink-text">${escapeHtmlAttr(title)}</span></a></li>`;
+    html += `<li class="backlinks-item"><a href="${toPathWithBase(route, pathBase)}" class="backlink-link" data-route="${escapeHtmlAttr(route)}">${prefix}<span class="backlink-text">${escapeHtmlAttr(title)}</span></a></li>`;
   }
   html += "</ul>";
   return html;
@@ -1209,13 +1245,15 @@ async function start() {
   });
 
   let manifest = loadInitialManifestData();
+  const initialPathBase = normalizePathBase(manifest?.pathBase);
   if (!manifest) {
-    const manifestRes = await fetch("/manifest.json");
+    const manifestRes = await fetch(toPathWithBase("/manifest.json", initialPathBase));
     if (!manifestRes.ok) {
       throw new Error(`Failed to load manifest: ${manifestRes.status}`);
     }
     manifest = await manifestRes.json();
   }
+  const pathBase = normalizePathBase(manifest.pathBase);
   const siteTitle = resolveSiteTitle(manifest);
   const defaultBranch = normalizeBranch(manifest.defaultBranch) || DEFAULT_BRANCH;
   const availableBranchSet = new Set([defaultBranch]);
@@ -1312,9 +1350,9 @@ async function start() {
 
     for (const node of view.tree) {
       if (node.type === "folder") {
-        treeRoot.appendChild(createFolderNode(node, state.expanded, treeFileRowsById));
+        treeRoot.appendChild(createFolderNode(node, state.expanded, treeFileRowsById, pathBase));
       } else {
-        treeRoot.appendChild(createFileNode(node, treeFileRowsById));
+        treeRoot.appendChild(createFileNode(node, treeFileRowsById, pathBase));
       }
     }
 
@@ -1333,7 +1371,7 @@ async function start() {
       backlinksEl.hidden = true;
       return;
     }
-    const html = renderBacklinks(doc);
+    const html = renderBacklinks(doc, pathBase);
     backlinksEl.innerHTML = html;
     backlinksEl.hidden = html.length === 0;
   };
@@ -1377,7 +1415,7 @@ async function start() {
         markActive(treeFileRowsById, activeFileState, "");
         announceA11yStatus("탐색 실패: 요청한 문서를 찾을 수 없습니다.");
         if (push) {
-          history.pushState(null, "", toSafeUrlPath(route));
+          history.pushState(null, "", toPathWithBase(route, pathBase));
         }
         return;
       }
@@ -1388,7 +1426,7 @@ async function start() {
       }
 
       if (push) {
-        history.pushState(null, "", toSafeUrlPath(route));
+        history.pushState(null, "", toPathWithBase(route, pathBase));
       }
 
       state.currentDocId = id;
@@ -1406,7 +1444,7 @@ async function start() {
         titleEl.textContent = doc.title;
         metaEl.innerHTML = renderMeta(doc);
         updateBacklinks(doc);
-        navEl.innerHTML = renderNav(view.docs, view.docIndexById, id);
+        navEl.innerHTML = renderNav(view.docs, view.docIndexById, id, pathBase);
         document.title = composeDocumentTitle(doc.title, siteTitle);
         if (viewerEl instanceof HTMLElement) {
           viewerEl.scrollTo(0, 0);
@@ -1419,7 +1457,7 @@ async function start() {
       titleEl.textContent = doc.title;
       metaEl.innerHTML = renderMeta(doc);
 
-      const res = await fetch(toSafeUrlPath(doc.contentUrl));
+      const res = await fetch(toPathWithBase(doc.contentUrl, pathBase));
       if (!res.ok) {
         contentEl.innerHTML = '<p class="placeholder">본문을 불러오지 못했습니다.</p>';
         updateBacklinks(null);
@@ -1431,7 +1469,7 @@ async function start() {
       contentEl.innerHTML = await res.text();
 
       updateBacklinks(doc);
-      navEl.innerHTML = renderNav(view.docs, view.docIndexById, id);
+      navEl.innerHTML = renderNav(view.docs, view.docIndexById, id, pathBase);
 
       document.title = composeDocumentTitle(doc.title, siteTitle);
       if (viewerEl instanceof HTMLElement) {
@@ -1594,7 +1632,7 @@ async function start() {
     updateBranchInfo();
     renderTree(state);
 
-    const currentRoute = resolveRouteFromLocation(view.routeMap);
+    const currentRoute = resolveRouteFromLocation(view.routeMap, pathBase);
     if (view.routeMap[currentRoute]) {
       await state.navigate(currentRoute, false);
       return;
@@ -1608,20 +1646,25 @@ async function start() {
   updateBranchInfo();
   renderTree(state);
 
-  const currentRoute = resolveRouteFromLocation(view.routeMap);
+  const currentRoute = resolveRouteFromLocation(view.routeMap, pathBase);
   const initialRoute = currentRoute === "/" ? pickHomeRoute(view) : currentRoute;
   handleLayoutChange();
   await state.navigate(initialRoute, currentRoute === "/" && initialRoute !== "/");
 
   window.addEventListener("popstate", async () => {
-    await state.navigate(resolveRouteFromLocation(view.routeMap), false);
+    await state.navigate(resolveRouteFromLocation(view.routeMap, pathBase), false);
   });
 }
 
 start().catch((error) => {
   const contentEl = document.getElementById("viewer-content");
   if (contentEl) {
-    contentEl.innerHTML = `<p class="placeholder">초기화 실패: ${error.message}</p>`;
+    const message = error instanceof Error ? error.message : String(error);
+    contentEl.innerHTML = "";
+    const placeholder = document.createElement("p");
+    placeholder.className = "placeholder";
+    placeholder.textContent = `초기화 실패: ${message}`;
+    contentEl.appendChild(placeholder);
   }
   console.error(error);
 });

package/src/types.ts

@@ -127,6 +127,7 @@ export type TreeNode = FolderNode | FileNode;
 export interface Manifest {
   generatedAt: string;
   siteTitle: string;
+  pathBase: string;
   defaultBranch: string;
   branches: string[];
   ui: {