@xingwangzhe/stalux 1.2.0

package/src/pages/links.md.ts

@@ -0,0 +1,18 @@
+import { getSite, isMarkdownExportEnabled, loadConfig, renderLinksMd } from "@utils/ai-discovery";
+import { createTranslator } from "@utils/i18n";
+import type { APIRoute } from "astro";
+
+export const prerender = true;
+
+export const GET: APIRoute = async (context) => {
+    const config = await loadConfig();
+    if (!isMarkdownExportEnabled(config)) return new Response(null, { status: 404 });
+
+    const site = getSite(config, context.site?.toString());
+    const lang = (config.get("site")?.lang as string) || "zh-CN";
+    const { t } = createTranslator(lang);
+    const text = renderLinksMd(config, site, t);
+    return new Response(text, {
+        headers: { "Content-Type": "text/markdown; charset=utf-8" },
+    });
+};

package/src/pages/llms-full.txt.ts

@@ -0,0 +1,25 @@
+import { getSite, isAiFileEnabled, loadConfig, renderLlmsFullTxt } from "@utils/ai-discovery";
+import { getAiDiscoveryData } from "@utils/config-utils";
+import type { APIRoute } from "astro";
+import { getCollection } from "astro:content";
+
+export const prerender = true;
+
+export const GET: APIRoute = async (context) => {
+    const configEntries = await getCollection("config");
+    const aiConfig = getAiDiscoveryData(configEntries);
+    if (!isAiFileEnabled(aiConfig?.conformance, "llms-full.txt")) {
+        return new Response("File disabled by ai-discovery config.\n", {
+            headers: { "Content-Type": "text/plain; charset=utf-8" },
+        });
+    }
+    const config = await loadConfig();
+    const site = getSite(config, context.site?.toString());
+    const text = await renderLlmsFullTxt(config, site);
+
+    return new Response(text, {
+        headers: {
+            "Content-Type": "text/plain; charset=utf-8",
+        },
+    });
+};

package/src/pages/llms.txt.ts

@@ -0,0 +1,26 @@
+import { getSite, loadConfig, renderLlmsTxt } from "@utils/ai-discovery";
+import { isAiFileEnabled } from "@utils/ai-discovery";
+import { getAiDiscoveryData } from "@utils/config-utils";
+import type { APIRoute } from "astro";
+import { getCollection } from "astro:content";
+
+export const prerender = true;
+
+export const GET: APIRoute = async (context) => {
+    const configEntries = await getCollection("config");
+    const aiConfig = getAiDiscoveryData(configEntries);
+    if (!isAiFileEnabled(aiConfig?.conformance, "llms.txt")) {
+        return new Response("File disabled by ai-discovery config.\n", {
+            headers: { "Content-Type": "text/plain; charset=utf-8" },
+        });
+    }
+    const config = await loadConfig();
+    const site = getSite(config, context.site?.toString());
+    const text = await renderLlmsTxt(config, site);
+
+    return new Response(text, {
+        headers: {
+            "Content-Type": "text/plain; charset=utf-8",
+        },
+    });
+};

package/src/pages/posts/[post].astro

@@ -0,0 +1,69 @@
+---
+import Stalux from "@layouts/Stalux.astro";
+import PostLayout from "@layouts/PostLayout.astro";
+import { getCollection, type CollectionEntry, render } from "astro:content";
+import { toTimestamp } from "@utils/dayjs";
+import Navs from "@components/stalux/layout/navs.astro";
+import { getSiteData, getAuthorData, getHeadData, getNavsData, getLinksData, getCommentData, getFooterData, getPromoteData, getTypetextsData, getMediaLinksData } from "@utils/config-utils";
+interface Props {
+    post: CollectionEntry<"posts">;
+    prev?: { url: string; title: string };
+    next?: { url: string; title: string };
+}
+const configEntries = await getCollection("config");
+const siteConfig = getSiteData(configEntries);
+const authorConfig = getAuthorData(configEntries);
+const props = Astro.props as Props;
+const { Content, headings, remarkPluginFrontmatter } = await render(props.post);
+
+// 从 remarkPluginFrontmatter 读取 feature flags 和字数统计（由 satteri 插件在构建时写入）
+const flags = {
+    hasImage: remarkPluginFrontmatter?.hasImage ?? false,
+};
+
+// 字数统计直接从 frontmatter 读取
+const minutesRead = (remarkPluginFrontmatter?.minutesRead as string) ?? "";
+const readingMinutes = (remarkPluginFrontmatter?.readingMinutes as number) ?? 0;
+const wordCount = (remarkPluginFrontmatter?.wordCount as number) ?? 0;
+// desc 可能为空字符串，需用 || 做“空串回退”，不能用 ??（?? 会把 "" 当作有效值）
+const autoDesc = props.post.data.desc || (remarkPluginFrontmatter?.desc as string) || "";
+
+export async function getStaticPaths() {
+    const posts = await getCollection("posts", ({ data }) => !data.draft);
+    const sorted = posts.sort((a,b) => toTimestamp(b.data.date) - toTimestamp(a.data.date));
+    return sorted.map((post, i) => {
+        // sorted 按日期降序：sorted[i-1] 比当前新（next），sorted[i+1] 比当前旧（prev）
+        const nextPost = i > 0 ? sorted[i - 1] : undefined;
+        const prevPost = i < sorted.length - 1 ? sorted[i + 1] : undefined;
+        return {
+            params: { post: post.data.abbrlink },
+            props: {
+                post,
+                prev: prevPost
+                    ? { url: "/posts/" + prevPost.data.abbrlink, title: prevPost.data.title }
+                    : undefined,
+                next: nextPost
+                    ? { url: "/posts/" + nextPost.data.abbrlink, title: nextPost.data.title }
+                    : undefined,
+            },
+        };
+    });
+}
+---
+<Stalux
+    title={props.post.data.title + " | " + siteConfig.title}
+    description={autoDesc}
+    cover={props.post.data.cover}
+    isArticle={true}
+    date={props.post.data.date}
+    updated={props.post.data.updated}
+    tags={props.post.data.tags}
+    categories={props.post.data.categories}
+    author={authorConfig.name}
+>
+    <div style="height:3em"></div>
+    <Navs /><div style="height:3em"></div>
+        <PostLayout title={props.post.data.title} date={props.post.data.date} updated={props.post.data.updated} readingTime={minutesRead} readingMinutes={readingMinutes} tags={props.post.data.tags||[]} categories={props.post.data.categories||[]} headings={headings} author={authorConfig.name} authorAvatar={authorConfig.avatar} prev={props.prev} next={props.next} cc={props.post.data.cc} wordCount={wordCount} hasImage={flags.hasImage}>
+        <Content/>
+    </PostLayout>
+</Stalux>

package/src/pages/posts/[post].md.ts

@@ -0,0 +1,109 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+
+import { isMarkdownExportEnabled, loadConfig, type ConfigMap } from "@utils/ai-discovery";
+import { buildCCName, buildCCLink } from "@utils/cc";
+import { createTranslator } from "@utils/i18n";
+import type { APIRoute, GetStaticPaths } from "astro";
+import { getCollection, type CollectionEntry } from "astro:content";
+
+export const prerender = true;
+
+function reconstructMarkdown(post: CollectionEntry<"posts">): string {
+    const d = post.data;
+    const lines: string[] = ["---"];
+
+    lines.push(`title: ${yamlScalar(d.title)}`);
+    if (d.tags?.length)
+        lines.push(`tags:\n${d.tags.map((t) => `    - ${yamlScalar(t)}`).join("\n")}`);
+    if (d.categories?.length)
+        lines.push(`categories:\n${d.categories.map((c) => `    - ${yamlScalar(c)}`).join("\n")}`);
+    lines.push(`date: ${yamlScalar(d.date)}`);
+    if (d.updated) lines.push(`updated: ${yamlScalar(d.updated)}`);
+    lines.push(`desc: ${yamlScalar(d.desc)}`);
+    lines.push(`abbrlink: ${yamlScalar(String(d.abbrlink))}`);
+    if (d.draft) lines.push(`draft: true`);
+    if (d.cc && d.cc !== "CC-BY-NC-SA-4.0") lines.push(`cc: ${yamlScalar(d.cc)}`);
+    if (d.cover) lines.push(`cover: ${yamlScalar(d.cover)}`);
+
+    lines.push("---", "");
+    const body = typeof post.body === "string" ? post.body : "";
+    return lines.join("\n") + body + (body.endsWith("\n") ? "" : "\n");
+}
+
+function yamlScalar(value: string): string {
+    if (
+        value === "" ||
+        /[:#{}[\],&*?|>!%@`]/.test(value) ||
+        value.includes("\n") ||
+        value.startsWith(" ") ||
+        value.endsWith(" ") ||
+        value === "true" ||
+        value === "false" ||
+        value === "null"
+    ) {
+        return JSON.stringify(value);
+    }
+    return value;
+}
+
+/** 生成 Markdown 格式的版权脚注 */
+function generateCCFooter(post: CollectionEntry<"posts">, config: ConfigMap): string {
+    const siteConfig = config.get("site") ?? {};
+    const lang = (siteConfig.lang as string) || "zh-CN";
+    const { t } = createTranslator(lang);
+    const cc = (post.data.cc as string) || "CC-BY-NC-SA-4.0";
+    const baseUrl = (siteConfig.url as string) || "";
+    const author = (config.get("author")?.name as string) || "";
+    const postUrl = baseUrl
+        ? `${baseUrl}/posts/${post.data.abbrlink}/`
+        : `/posts/${post.data.abbrlink}/`;
+
+    const lines: string[] = [];
+    lines.push(`**${t("post.author")}**${author}`);
+    lines.push(`**${t("post.articleLink")}**[${postUrl}](${postUrl})`);
+    lines.push(
+        `${t("post.licensedUnder")}[${buildCCName(cc, t)}](${buildCCLink(cc)})${t("post.licenseSuffix")}`,
+    );
+
+    return lines.join("\n\n");
+}
+
+export const getStaticPaths = (async () => {
+    const config = await loadConfig();
+    if (!isMarkdownExportEnabled(config)) {
+        return [];
+    }
+
+    const posts = await getCollection("posts", ({ data }) => !data.draft);
+    return posts.map((post) => ({
+        params: { post: String(post.data.abbrlink) },
+        props: { post },
+    }));
+}) satisfies GetStaticPaths;
+
+export const GET: APIRoute = async ({ props }) => {
+    const config = await loadConfig();
+    if (!isMarkdownExportEnabled(config)) return new Response(null, { status: 404 });
+
+    const { post } = props as { post: CollectionEntry<"posts"> };
+
+    let markdown: string;
+    if (post.filePath) {
+        const abs = path.resolve(process.cwd(), post.filePath);
+        markdown = await readFile(abs, "utf-8");
+    } else {
+        markdown = reconstructMarkdown(post);
+    }
+
+    // 追加版权脚注（不修改原始 md 文件）
+    const footer = generateCCFooter(post, config);
+    markdown += "\n\n---\n\n" + footer;
+
+    return new Response(markdown, {
+        status: 200,
+        headers: {
+            "Content-Type": "text/markdown; charset=utf-8",
+        },
+    });
+};

package/src/pages/rss.xml.ts

@@ -0,0 +1,29 @@
+import rss from "@astrojs/rss";
+import { buildFeedItems } from "@utils/feed";
+import { createTranslator, langToFeedLanguage } from "@utils/i18n";
+import type { APIRoute } from "astro";
+import { getCollection } from "astro:content";
+
+export const GET: APIRoute = async (context) => {
+    const configCollection = await getCollection("config");
+    const siteEntry = configCollection.find((e) => e.id === "site");
+    if (!siteEntry) throw new Error("Missing site config");
+    const stalux = siteEntry.data;
+
+    const posts = await getCollection("posts", ({ data }) => !data.draft);
+    const items = await buildFeedItems(stalux, posts, "atom:updated");
+
+    const lang = stalux?.lang || "zh-CN";
+    const { t } = createTranslator(lang);
+
+    return rss({
+        title: stalux?.title || "Stalux Blog",
+        description: stalux?.description || "A blog powered by Stalux theme",
+        site: stalux?.url || context.site?.toString(),
+        items,
+        customData: `<language>${langToFeedLanguage(lang)}</language>\n<copyright>${t("rss.copyright")}</copyright>`,
+        xmlns: {
+            atom: "http://www.w3.org/2005/Atom",
+        },
+    });
+};

package/src/pages/tags/[tag].astro

@@ -0,0 +1,37 @@
+---
+import PostList from "@components/stalux/posts/postList.astro";
+import TagHeader from "@components/stalux/tags/tagHeader.astro";
+import { getCollection, type CollectionEntry } from "astro:content";
+import Stalux from "@layouts/Stalux.astro";
+import { createTranslator } from "@utils/i18n";
+import { buildTaxonomyStaticPaths } from "@utils/taxonomy";
+import Navs from "@components/stalux/layout/navs.astro";
+import { getSiteData, getAuthorData, getHeadData, getNavsData, getLinksData, getCommentData, getFooterData, getPromoteData, getTypetextsData, getMediaLinksData } from "@utils/config-utils";
+const configEntries = await getCollection("config");
+const siteConfig = getSiteData(configEntries);
+const { t } = createTranslator(siteConfig.lang || "zh-CN");
+
+export async function getStaticPaths() {
+    return buildTaxonomyStaticPaths("tags");
+}
+
+interface Props {
+    tag: string;
+    count: number;
+    posts: CollectionEntry<"posts">[];
+    lastUpdateDate: string;
+}
+
+const props = Astro.props as Props;
+---
+
+<Stalux
+    title={t("taxonomy.tag") + ": " + props.tag + " | " + siteConfig.title}
+    description={t("taxonomy.browseTag", { title: siteConfig.title, tag: props.tag, count: props.count })}
+    noindex={props.count < 3}
+>
+    <div style="height: 3em;"></div>
+    <Navs />
+    <TagHeader type={t("taxonomy.tag")} name={props.tag} count={props.count} />
+    <PostList posts={props.posts} />
+</Stalux>

package/src/pages/tags/[tag].md.ts

@@ -0,0 +1,34 @@
+import {
+    getSite,
+    isMarkdownExportEnabled,
+    loadConfig,
+    renderTaxonomyPageMd,
+} from "@utils/ai-discovery";
+import { buildTaxonomyStaticPaths } from "@utils/taxonomy";
+import type { APIRoute } from "astro";
+import type { CollectionEntry } from "astro:content";
+
+export const prerender = true;
+
+export async function getStaticPaths() {
+    const config = await loadConfig();
+    if (!isMarkdownExportEnabled(config)) return [];
+
+    return buildTaxonomyStaticPaths("tags");
+}
+
+export const GET: APIRoute = async (context) => {
+    const config = await loadConfig();
+    const exportMd = isMarkdownExportEnabled(config);
+    if (!exportMd) return new Response(null, { status: 404 });
+
+    const { tag, posts } = context.props as {
+        tag: string;
+        posts: CollectionEntry<"posts">[];
+    };
+    const site = getSite(config, context.site?.toString());
+    const text = renderTaxonomyPageMd(tag, posts, site, "tags", exportMd);
+    return new Response(text, {
+        headers: { "Content-Type": "text/markdown; charset=utf-8" },
+    });
+};

package/src/pages/tags/index.astro

@@ -0,0 +1,23 @@
+---
+import Stalux from "@layouts/Stalux.astro";
+import { getCollection } from "astro:content";
+import { createTranslator } from "@utils/i18n";
+import Navs from "@components/stalux/layout/navs.astro";
+import styles from "@styles/pages/tags.module.css";
+import TagsCloud from "@components/stalux/tags/tagsCloud.astro";
+import { getSiteData, getAuthorData, getHeadData, getNavsData, getLinksData, getCommentData, getFooterData, getPromoteData, getTypetextsData, getMediaLinksData } from "@utils/config-utils";
+const configEntries = await getCollection("config");
+const siteConfig = getSiteData(configEntries);
+const { t } = createTranslator(siteConfig.lang || "zh-CN");
+---
+
+<Stalux
+    title={t("tags.title") + " | " + siteConfig.title}
+    description={t("tags.description", { title: siteConfig.title })}
+>
+    <div style="height: 3em;"></div>
+    <Navs />
+    <h1 class={styles.title}>{t("tags.heading")}</h1>
+    <div class={styles.description}>{t("tags.explore")}</div>
+    <TagsCloud />
+</Stalux>

package/src/pages/tags/index.md.ts

@@ -0,0 +1,27 @@
+import {
+    buildTaxonomyMap,
+    getPublishedPosts,
+    getSite,
+    isMarkdownExportEnabled,
+    loadConfig,
+    renderTaxonomyListMd,
+} from "@utils/ai-discovery";
+import { createTranslator } from "@utils/i18n";
+import type { APIRoute } from "astro";
+
+export const prerender = true;
+
+export const GET: APIRoute = async (context) => {
+    const config = await loadConfig();
+    if (!isMarkdownExportEnabled(config)) return new Response(null, { status: 404 });
+
+    const site = getSite(config, context.site?.toString());
+    const lang = (config.get("site")?.lang as string) || "zh-CN";
+    const { t } = createTranslator(lang);
+    const posts = await getPublishedPosts();
+    const map = buildTaxonomyMap(posts, "tags");
+    const text = renderTaxonomyListMd(map, site, "tags", t("ai.allTags"));
+    return new Response(text, {
+        headers: { "Content-Type": "text/markdown; charset=utf-8" },
+    });
+};

package/src/pages/words.astro

@@ -0,0 +1,24 @@
+---
+import Navs from "@components/stalux/layout/navs.astro";
+import Stalux from "@layouts/Stalux.astro";
+import WordList from "@components/stalux/words/wordList.astro";
+import { getCollection } from "astro:content";
+import { createTranslator } from "@utils/i18n";
+import styles from "@styles/pages/words.module.css";
+import { getSiteData, getAuthorData, getHeadData, getNavsData, getLinksData, getCommentData, getFooterData, getPromoteData, getTypetextsData, getMediaLinksData } from "@utils/config-utils";
+
+const configEntries = await getCollection("config");
+const siteConfig = getSiteData(configEntries);
+const { t } = createTranslator(siteConfig.lang || "zh-CN");
+const entries = await getCollection("words", ({ data }) => !data.draft);
+---
+
+<Stalux title={t("words.title") + " | " + siteConfig.title} description={t("words.description")}>
+    <div style="height: 3em;"></div>
+    <Navs />
+    <h1 class={styles.title}>{t("words.heading")}</h1>
+    <div class={styles.description}>
+        {t("words.desc", { n: entries.length })}
+    </div>
+    <WordList entries={entries} timezone={siteConfig.timezone} />
+</Stalux>

package/src/pages/words.md.ts

@@ -0,0 +1,14 @@
+import { isMarkdownExportEnabled, loadConfig, renderWordsMd } from "@utils/ai-discovery";
+import type { APIRoute } from "astro";
+
+export const prerender = true;
+
+export const GET: APIRoute = async () => {
+    const config = await loadConfig();
+    if (!isMarkdownExportEnabled(config)) return new Response(null, { status: 404 });
+
+    const text = await renderWordsMd();
+    return new Response(text, {
+        headers: { "Content-Type": "text/markdown; charset=utf-8" },
+    });
+};

package/src/plugins/feature-flags.ts

@@ -0,0 +1,68 @@
+/**
+ * Sätteri 插件：在构建时完成字数统计和特性标记，
+ * 通过 ctx.data.astro.frontmatter 把最终结果传递到 frontmatter，运行时无需再算。
+ *
+ * 字数统计策略：
+ * - 只数 heading 和 paragraph 的内容（用 ctx.textContent 获取纯文本）。
+ * - 独立的 code 块、math/displayMath 公式不参与计数
+ *   （代码是"看"不是"读"，符号表达式不按词计）。
+ * - 行内 code 和行内 math 会被 textContent(paragraph) 自然包含。
+ *
+ * 特性标记：
+ * - HAST 阶段 <img> 检测      → hasImage
+ * - mermaid 处理交由 @xingwangzhe/satteri-mermaid 的 mdast + hast 插件
+ * - 数学公式由 satteri-temml 插件直接输出 MathML，无需额外标记
+ */
+import { defineMdastPlugin, defineHastPlugin } from "satteri";
+
+import { countWords } from "../utils/count-words.ts";
+
+const WORDS_PER_MINUTE = 400;
+
+/** 从纯文本统计字数并累加到 frontmatter。 */
+function flushWordCount(ctx: any, text: string) {
+    const prev = (ctx.data.astro.frontmatter.wordCount as number) ?? 0;
+    const wc = prev + countWords(text);
+    const fm = ctx.data.astro.frontmatter;
+    fm.wordCount = wc;
+    fm.readingMinutes = Math.ceil(wc / WORDS_PER_MINUTE);
+    // 搜索全文：拼接所有 heading + paragraph 的纯文本
+    fm.searchText = ((fm.searchText as string) || "") + " " + text;
+}
+
+export const featureFlagsMdast = defineMdastPlugin({
+    name: "feature-flags-mdast",
+
+    code(_node, _ctx) {
+        // 独立的 code 块不参与字数统计
+    },
+
+    heading(node, ctx) {
+        flushWordCount(ctx, ctx.textContent(node));
+    },
+
+    paragraph(node, ctx) {
+        flushWordCount(ctx, ctx.textContent(node));
+    },
+});
+
+/**
+ * HAST 插件：检测图片，写入 frontmatter，并添加懒加载属性
+ */
+export const featureFlagsHast = defineHastPlugin({
+    name: "feature-flags-hast",
+
+    element: {
+        filter: ["img"],
+        visit(node, ctx) {
+            ctx.data.astro.frontmatter.hasImage = true;
+            // 添加懒加载和异步解码（封面图不在此处理，由 postCard.astro 控制）
+            if (!node.properties?.loading) {
+                ctx.setProperty(node, "loading", "lazy");
+            }
+            if (!node.properties?.decoding) {
+                ctx.setProperty(node, "decoding", "async");
+            }
+        },
+    },
+});

package/src/plugins/satteri-temml.ts

@@ -0,0 +1,81 @@
+/**
+ * Sätteri temml 插件 — 用 temml (TeX → MathML) 替代 KaTeX。
+ *
+ * 与 @nullpinter/satteri-katex 的接口兼容：
+ * - math 节点 → { rawHtml: string }   (display math → <math display="block">)
+ * - inlineMath 节点 → { type: "html", value: string }  (inline math → <math>)
+ *
+ * 输出纯 MathML，浏览器原生渲染，无需额外的 CSS/字体。
+ */
+import { defineMdastPlugin } from "satteri";
+import temmlLib from "temml";
+
+const emptyOptions = {};
+
+function escapeHtml(value: string): string {
+    return value
+        .replaceAll("&", "&amp;")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;")
+        .replaceAll("'", "&#39;");
+}
+
+function renderTemmlError(value: string, error: unknown, options: Record<string, any>): string {
+    const title = escapeHtml(String(error));
+    const color = escapeHtml(options.errorColor ?? "#cc0000");
+    return `<span class="temml-error" style="color:${color}" title="${title}">${escapeHtml(value)}</span>`;
+}
+
+function renderMath(
+    node: { value: string },
+    displayMode: boolean,
+    options: Record<string, any>,
+    ctx: any,
+): string {
+    const value = node.value;
+    try {
+        return temmlLib.renderToString(value, {
+            ...options,
+            displayMode,
+            throwOnError: true,
+        });
+    } catch (error) {
+        const cause = error instanceof Error ? error : new Error(String(error));
+        ctx.report({
+            message: `Could not render math with Temml: ${cause.message}`,
+            node,
+            severity: "error",
+        });
+        try {
+            return temmlLib.renderToString(value, {
+                ...options,
+                displayMode,
+                strict: false,
+                throwOnError: false,
+            });
+        } catch {
+            return renderTemmlError(value, error, options);
+        }
+    }
+}
+
+/**
+ * 创建一个 Sätteri temml mdast 插件。
+ * @param options - 透传给 temml.renderToString 的选项（displayMode 除外）
+ */
+export function temml(options?: Record<string, any>) {
+    const settings = options ?? emptyOptions;
+    return defineMdastPlugin({
+        name: "temml",
+        math(node: any, ctx: any) {
+            return { rawHtml: renderMath(node, true, settings, ctx) };
+        },
+        inlineMath(node: any, ctx: any) {
+            return {
+                type: "html",
+                value: renderMath(node, false, settings, ctx),
+            };
+        },
+    });
+}