czon 0.6.7 → 0.6.8

package/dist/build/pipeline.js

@@ -60,6 +60,10 @@ async function applyConfig(options) {
     if (options.baseUrl !== undefined) {
         metadata_1.MetaData.options.baseUrl = options.baseUrl;
     }
+    if (options.siteTitle !== undefined) {
+        console.log(`🏷️ Site title: ${options.siteTitle}`);
+        metadata_1.MetaData.options.siteTitle = options.siteTitle;
+    }
 }
 /**
  * 构建管道（函数组合）

package/dist/cli.js

@@ -169,12 +169,16 @@ class BuildCommand extends clipanion_1.Command {
         this.baseUrl = clipanion_1.Option.String('--baseUrl', {
             description: 'Base URL for sitemap generation (e.g., https://yoursite.com). If not provided, sitemap will not be generated.',
         });
+        this.siteTitle = clipanion_1.Option.String('--siteTitle', {
+            description: 'Site title to replace "CZON" in the header (e.g., "My Docs")',
+        });
     }
     async execute() {
         try {
             await (0, pipeline_1.buildSite)({
                 langs: this.lang,
                 baseUrl: this.baseUrl,
+                siteTitle: this.siteTitle,
             });
             return 0;
         }
@@ -191,10 +195,11 @@ BuildCommand.usage = clipanion_1.Command.Usage({
       This command builds a documentation site from Markdown files in the current directory.
       The output will be placed in the .czon/dist directory.
 
-      Examples:
-        $ czon build
-        $ czon build --lang en-US --lang ja-JP (translate to English and Japanese)
-        $ czon build --baseUrl https://yoursite.com (generate sitemap.xml)
+       Examples:
+         $ czon build
+         $ czon build --lang en-US --lang ja-JP (translate to English and Japanese)
+         $ czon build --baseUrl https://yoursite.com (generate sitemap.xml)
+         $ czon build --siteTitle "My Docs" (replace "CZON" in header)
     `,
 });
 // 创建 CLI 应用

package/dist/process/template.js

@@ -43,12 +43,31 @@ const ssg_1 = require("../ssg");
 const resourceMap_1 = require("../ssg/resourceMap");
 const convertMarkdownToHtml_1 = require("../utils/convertMarkdownToHtml");
 const frontmatter_1 = require("../utils/frontmatter");
+const isExists_1 = require("../utils/isExists");
 const writeFile_1 = require("../utils/writeFile");
+const copyFavicon = async () => {
+    const faviconSource = path.join(paths_1.CZON_DIR, 'icons', 'favicon.ico');
+    const faviconTarget = path.join(paths_1.CZON_DIST_DIR, 'favicon.ico');
+    // 如果存在 .czon/icons/favicon.ico，则复制到输出目录
+    if (await (0, isExists_1.isExists)(faviconSource)) {
+        await fs.mkdir(path.dirname(faviconTarget), { recursive: true });
+        await fs.copyFile(faviconSource, faviconTarget);
+        console.info(`📄 Copied favicon from ${faviconSource} to: ${faviconTarget}`);
+        return;
+    }
+    // 否则，使用 CZON 源码目录下的默认图标
+    const defaultFaviconSource = path.join(__dirname, '../../templates/favicon.ico');
+    await fs.mkdir(path.dirname(faviconTarget), { recursive: true });
+    await fs.copyFile(defaultFaviconSource, faviconTarget);
+    console.info(`📄 Copied default favicon to: ${faviconTarget}`);
+};
 /**
  * 使用简单的爬虫抓取生成的站点页面
  */
 const spiderStaticSiteGenerator = async () => {
     (0, sitemap_1.clearSitemapCollection)();
+    // 复制 favicon 图标
+    await copyFavicon();
     const queue = ['/index.html', '/404.html'];
     // 将每个语言的首页加入队列
     for (const lang of metadata_1.MetaData.options.langs || []) {
@@ -114,6 +133,8 @@ const spiderStaticSiteGenerator = async () => {
             const resolvedPath = path.resolve('/', path.dirname(currentPath), link);
             if (resolvedPath.startsWith('/__raw__/'))
                 continue; // 跳过原始内容目录
+            if (resolvedPath === '/favicon.ico')
+                continue; // 跳过 favicon.ico
             console.info(`   ➕ Found link: ${link} -> ${resolvedPath} (${isVisited.has(resolvedPath) ? 'visited' : 'new'})`);
             if (!isVisited.has(resolvedPath)) {
                 queue.push(resolvedPath);

package/dist/ssg/ContentPage.js

@@ -25,11 +25,13 @@ const ContentPage = props => {
     // 查找指向当前文章的其他文章
     const thisPath = (0, node_path_1.resolve)('/', props.file.path);
     const referencedFiles = props.ctx.site.files.filter(f => f.links.some(link => (0, node_path_1.resolve)('/', (0, node_path_1.dirname)(f.path), link) === thisPath));
+    const faviconUrl = (0, resourceMap_1.getFaviconUrlFrom)(props.ctx.path);
     return (react_1.default.createElement("html", { lang: props.lang },
         react_1.default.createElement("head", null,
             react_1.default.createElement("meta", { charSet: "UTF-8" }),
             react_1.default.createElement("meta", { name: "viewport", content: "width=device-width, initial-scale=1.0" }),
             react_1.default.createElement("title", null, title),
+            react_1.default.createElement("link", { rel: "icon", href: faviconUrl, type: "image/x-icon" }),
             react_1.default.createElement("meta", { name: "description", content: `tags: ${tags.join(', ')}` }),
             react_1.default.createElement("script", { src: (0, resourceMap_1.getResourceUrlFrom)(props.ctx.path, 'tailwindcss.js') }),
             react_1.default.createElement("style", null, style_1.style),

package/dist/ssg/IndexPage.js

@@ -21,10 +21,12 @@ const IndexPage = props => {
         [x => x.metadata?.inferred_date || '', 'desc'],
     ]);
     const allCategories = Array.from(new Set([undefined].concat(props.ctx.site.files.map(f => f.category))));
+    const faviconUrl = (0, resourceMap_1.getFaviconUrlFrom)(props.ctx.path);
     return (react_1.default.createElement("html", null,
         react_1.default.createElement("head", null,
             react_1.default.createElement("meta", { charSet: "UTF-8" }),
             react_1.default.createElement("title", null, `Index of ${props.lang.toString()}`),
+            react_1.default.createElement("link", { rel: "icon", href: faviconUrl, type: "image/x-icon" }),
             react_1.default.createElement("meta", { name: "viewport", content: "width=device-width, initial-scale=1.0" }),
             react_1.default.createElement("meta", { name: "description", content: `Index page for language ${props.lang}` }),
             react_1.default.createElement("script", { src: (0, resourceMap_1.getResourceUrlFrom)(props.ctx.path, 'tailwindcss.js') }),

package/dist/ssg/RedirectPage.js

@@ -6,8 +6,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.RedirectPage = void 0;
 const node_path_1 = require("node:path");
 const react_1 = __importDefault(require("react"));
+const resourceMap_1 = require("./resourceMap");
 const RedirectPage = props => {
     const toURL = (0, node_path_1.relative)((0, node_path_1.dirname)(props.from), props.to);
+    const faviconUrl = (0, resourceMap_1.getFaviconUrlFrom)(props.from);
     return (react_1.default.createElement("html", { lang: "en" },
         react_1.default.createElement("head", null,
             react_1.default.createElement("meta", { charSet: "UTF-8" }),
@@ -15,6 +17,7 @@ const RedirectPage = props => {
             react_1.default.createElement("meta", { name: "viewport", content: "width=device-width, initial-scale=1.0" }),
             react_1.default.createElement("meta", { httpEquiv: "refresh", content: `0; url=${toURL}` }),
             react_1.default.createElement("title", null, "Redirecting..."),
+            react_1.default.createElement("link", { rel: "icon", href: faviconUrl, type: "image/x-icon" }),
             react_1.default.createElement("script", { dangerouslySetInnerHTML: {
                     __html: `
           (function() {

package/dist/ssg/RootPage.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.RootPage = void 0;
 const react_1 = __importDefault(require("react"));
 const languages_1 = require("../languages");
+const resourceMap_1 = require("./resourceMap");
 // /index.html 的根页面
 // 需要实现多语言选择，自动重定向到用户浏览器语言对应的首页
 // 需要对 SEO 友好，提供适当的 meta 标签
@@ -18,11 +19,13 @@ const RootPage = props => {
             mapUserLangToSupported[langPrefix] = lang;
         }
     }
+    const faviconUrl = (0, resourceMap_1.getFaviconUrlFrom)(props.ctx.path);
     return (react_1.default.createElement("html", { lang: "en" },
         react_1.default.createElement("head", null,
             react_1.default.createElement("meta", { charSet: "UTF-8" }),
             react_1.default.createElement("meta", { name: "viewport", content: "width=device-width, initial-scale=1.0" }),
             react_1.default.createElement("title", null, "CZON Multilingual Site Navigator"),
+            react_1.default.createElement("link", { rel: "icon", href: faviconUrl, type: "image/x-icon" }),
             react_1.default.createElement("meta", { name: "description", content: "Select your preferred language to explore our content." }),
             props.ctx.site.options.langs.map(lang => (react_1.default.createElement("link", { key: lang, rel: "alternate", hrefLang: lang, href: `${lang}/index.html` }))),
             react_1.default.createElement("link", { rel: "alternate", hrefLang: "x-default", href: `${props.ctx.site.options.langs[0]}/index.html` }),

package/dist/ssg/components/CZONHeader.js

@@ -10,7 +10,7 @@ const LanguageSwitch_1 = require("./LanguageSwitch");
 const CZONHeader = props => {
     return (react_1.default.createElement("header", { className: "czon-header py-4 border-b flex justify-between items-center px-6" },
         react_1.default.createElement("h1", { className: "text-2xl font-bold" },
-            react_1.default.createElement("a", { href: "index.html" }, "CZON")),
+            react_1.default.createElement("a", { href: "index.html" }, props.ctx.site.options.siteTitle ?? 'CZON')),
         react_1.default.createElement("div", { className: "flex items-center gap-4" },
             react_1.default.createElement(DarkModeSwitch_1.DarkModeSwitch, null),
             props.lang && react_1.default.createElement(LanguageSwitch_1.LanguageSwitch, { ctx: props.ctx, lang: props.lang, file: props.file }))));

package/dist/ssg/resourceMap.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getResourceUrlFrom = exports.EXTERNAL_RESOURCES = void 0;
+exports.getFaviconUrlFrom = exports.getResourceUrlFrom = exports.EXTERNAL_RESOURCES = void 0;
 const path_1 = require("path");
 exports.EXTERNAL_RESOURCES = [
     {
@@ -20,4 +20,12 @@ const getResourceUrlFrom = (path, name) => {
     return (0, path_1.relative)((0, path_1.dirname)(path), `/assets/${resource.name}`);
 };
 exports.getResourceUrlFrom = getResourceUrlFrom;
+/**
+ * 获取 favicon 的相对引用 URL
+ * @param path - 当前文件路径 (e.g. `/en-US/index.html`)
+ */
+const getFaviconUrlFrom = (path) => {
+    return (0, path_1.relative)((0, path_1.dirname)(path), '/favicon.ico');
+};
+exports.getFaviconUrlFrom = getFaviconUrlFrom;
 //# sourceMappingURL=resourceMap.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "czon",
-  "version": "0.6.7",
+  "version": "0.6.8",
   "description": "CZone - AI enhanced Markdown content engine",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",