@xingwangzhe/stalux 1.2.0

package/src/utils/word-count-utils.ts

@@ -0,0 +1,83 @@
+/**
+ * 站点字数统计工具
+ *
+ * Astro 7.1 启用 deferRender 后，post.rendered 不再在 content sync 阶段预计算。
+ * 因此改为直接从 post.body（原始 markdown）统计字数，不再依赖 Sätteri 的渲染结果。
+ */
+import { getCollection } from "astro:content";
+
+// ---------------------------------------------------------------------------
+// 字数统计算法（基于 W3C Intl.Segmenter，body-based）
+// ---------------------------------------------------------------------------
+
+const bodySegmenter = new Intl.Segmenter("zh", { granularity: "word" });
+
+/**
+ * 从原始 markdown 正文估算字数。
+ * - 中文：`Intl.Segmenter` 逐字分割，每个汉字计 1
+ * - 英文：按词计 1
+ * - 纯数字序列：不计入（与旧正则行为一致）
+ * - 标点/空白不计
+ */
+function countWordsFromBody(body: string | undefined | null): number {
+    if (!body) return 0;
+    let count = 0;
+    for (const { segment, isWordLike } of bodySegmenter.segment(body)) {
+        // 排除纯数字序列（如年份、代码行号等），与旧正则行为保持一致
+        if (isWordLike && !/^\d+$/.test(segment)) count++;
+    }
+    return count;
+}
+
+// ---------------------------------------------------------------------------
+// 模块级缓存（整个构建周期只计算一次）
+// ---------------------------------------------------------------------------
+
+let _cachedTotal: number | null = null;
+
+/**
+ * 获取所有已发布文章的总字数（从 body 估算）。
+ * 结果会被缓存，同一构建周期内重复调用不会重新计算。
+ */
+export async function getTotalWordCount(): Promise<number> {
+    if (_cachedTotal !== null) return _cachedTotal;
+    try {
+        const posts = await getCollection("posts", ({ data }) => !data.draft);
+        _cachedTotal = posts.reduce((sum, post) => sum + countWordsFromBody(post.body), 0);
+        return _cachedTotal;
+    } catch (error) {
+        console.error("计算文章总字数时出错:", error);
+        return 0;
+    }
+}
+
+let _cachedDescriptions: Map<string, { desc: string; wordCount: number }> | null = null;
+
+/**
+ * 获取所有已发布文章的描述和字数缓存，供 RSS/Atom/LLMs feed 共享。
+ * - desc   ：直接从 frontmatter 读取（post.data.desc）
+ * - wordCount：从 post.body 估算
+ */
+export async function getPostDescriptions(): Promise<
+    Map<string, { desc: string; wordCount: number }>
+> {
+    if (_cachedDescriptions !== null) return _cachedDescriptions;
+    const posts = await getCollection("posts", ({ data }) => !data.draft);
+    const results = posts.map((post) => ({
+        id: String(post.data.abbrlink ?? post.id),
+        desc: post.data.desc || "",
+        wordCount: countWordsFromBody(post.body),
+    }));
+    _cachedDescriptions = new Map(
+        results.map((r) => [r.id, { desc: r.desc, wordCount: r.wordCount }]),
+    );
+    return _cachedDescriptions;
+}
+
+export function formatWordCount(count: number, lang?: string): string {
+    const isZh = lang?.startsWith("zh");
+    // 中文用"万"做万级单位；其他语言统一用"k"（千）。
+    if (isZh && count >= 10000) return `${(count / 10000).toFixed(1)}万`;
+    if (count >= 1000) return `${(count / 1000).toFixed(1)}k`;
+    return String(count);
+}

package/template/astro.config.mjs

@@ -0,0 +1,51 @@
+import { defineConfig } from "astro/config";
+import { satteri } from "@astrojs/markdown-satteri";
+import sitemap from "@astrojs/sitemap";
+import expressiveCode from "astro-expressive-code";
+import stalux from "stalux";
+import { mermaidMdast, mermaidHast } from "@xingwangzhe/satteri-mermaid";
+import { photoswipe } from "@xingwangzhe/satteri-photoswipe";
+
+// https://astro.build/config
+export default defineConfig({
+    output: "static",
+    site: "https://example.com",
+    prefetch: {
+        prefetchAll: false,
+        defaultStrategy: "hover",
+    },
+    integrations: [
+        // Stalux 主题集成 — 自动注入所有页面、组件、路由
+        stalux({
+            contentDir: "stalux",
+        }),
+        sitemap(),
+        expressiveCode({
+            themes: ["dark-plus", "github-light"],
+            styleOverrides: {
+                borderRadius: "0.5rem",
+                codeFontFamily:
+                    '"JetBrains Mono", "Fira Code", "Consolas", "Courier New", monospace',
+            },
+            useDarkModeMediaQuery: true,
+        }),
+    ],
+    markdown: {
+        processor: satteri({
+            features: {
+                math: true,
+                smartPunctuation: true,
+                gfm: true,
+                frontmatter: true,
+            },
+            mdastPlugins: [],
+            hastPlugins: [
+                photoswipe(),
+                mermaidHast({
+                    responsive: true,
+                    theme: "dark",
+                }),
+            ],
+        }),
+    },
+});

package/template/package.json

@@ -0,0 +1,27 @@
+{
+    "name": "my-stalux-blog",
+    "version": "1.0.0",
+    "type": "module",
+    "scripts": {
+        "dev": "astro dev",
+        "build": "astro build",
+        "preview": "astro preview",
+        "astro": "astro"
+    },
+    "dependencies": {
+        "astro": "^7.0.0",
+        "stalux": "^2.0.0",
+        "@astrojs/markdown-satteri": "^1.0.0",
+        "astro-expressive-code": "^0.44.0",
+        "@xingwangzhe/satteri-mermaid": "^0.7.0",
+        "@xingwangzhe/satteri-photoswipe": "^0.2.0",
+        "@astrojs/sitemap": "^4.0.0",
+        "pagefind": "^1.5.0",
+        "@pagefind/component-ui": "^1.5.0"
+    },
+    "devDependencies": {
+        "@astrojs/rss": "^4.0.0",
+        "@lucide/astro": "^1.0.0",
+        "typescript": "^7.0.0"
+    }
+}

package/template/public/robots.txt

@@ -0,0 +1,3 @@
+User-agent: *
+Allow: /
+Sitemap: https://example.com/sitemap-index.xml

package/template/src/content.config.ts

@@ -0,0 +1,11 @@
+/**
+ * Stalux 内容集合配置
+ *
+ * 使用 stalux 包提供的 defineCollections 快速配置。
+ * 如需自定义内容路径，修改 contentDir 参数即可。
+ */
+import { defineCollections } from "stalux/schemas";
+
+export const collections = defineCollections({
+    contentDir: "stalux",
+});

package/template/stalux/about/index.md

@@ -0,0 +1,14 @@
+---
+title: About Me
+description: About this blog and the author
+---
+
+Hello! Welcome to my blog.
+
+This is my personal space where I share technology, life, and thoughts.
+
+## About This Site
+
+- Built with [Astro](https://astro.build) + [Stalux](https://stalux.needhelp.icu)
+- Content licensed under CC-BY-NC-SA-4.0
+- Source code hosted on GitHub

package/template/stalux/config/ai-discovery.yml

@@ -0,0 +1,2 @@
+id: ai-discovery
+conformance: "essential"

package/template/stalux/config/author.yml

@@ -0,0 +1,4 @@
+id: author
+name: Your Name
+avatar: /avatar.png
+bio: A passionate developer and writer

package/template/stalux/config/comment.yml

@@ -0,0 +1,5 @@
+id: comment
+enabled: false
+waline:
+    serverURL: ""
+    lang: en

package/template/stalux/config/footer.yml

@@ -0,0 +1,13 @@
+id: footer
+copyright:
+    enabled: true
+    startYear: 2026
+theme:
+    showPoweredBy: true
+    showThemeInfo: true
+beian:
+    icp:
+        enabled: false
+    security:
+        enabled: false
+badges: []

package/template/stalux/config/head.yml

@@ -0,0 +1,7 @@
+id: head
+# googleAnalyticsId: ""
+# bingClarityId: ""
+# umami:
+#   id: ""
+#   url: ""
+anyhead: ""

package/template/stalux/config/links.yml

@@ -0,0 +1,4 @@
+id: links
+title: Friends
+description: Friendly neighbors sharing great content
+sites: []

package/template/stalux/config/media-links.yml

@@ -0,0 +1,8 @@
+id: media-links
+items:
+    - icon: github
+      link: https://github.com/
+    - icon: bilibili
+      link: https://bilibili.com/
+    - icon: maildotru
+      link: mailto:hello@example.com

package/template/stalux/config/navs.yml

@@ -0,0 +1,23 @@
+id: navs
+items:
+    - icon: home
+      link: /
+      title: Home
+    - icon: archive
+      link: /archives/
+      title: Archives
+    - icon: folder
+      link: /categories/
+      title: Categories
+    - icon: tag
+      link: /tags/
+      title: Tags
+    - icon: quote
+      link: /words/
+      title: Words
+    - icon: link
+      link: /links/
+      title: Links
+    - icon: user
+      link: /about/
+      title: About

package/template/stalux/config/promote.yml

@@ -0,0 +1,2 @@
+id: promote
+export_md: false

package/template/stalux/config/site.yml

@@ -0,0 +1,7 @@
+id: site
+lang: en
+title: My Blog
+url: https://example.com
+description: A personal blog powered by the Stalux theme
+timezone: Asia/Shanghai
+favicon: /favicon.ico

package/template/stalux/config/typetexts.yml

@@ -0,0 +1,5 @@
+id: typetexts
+items:
+    - "Hello World!"
+    - "Stay hungry, Stay foolish"
+    - "Hello Stalux!"

package/template/stalux/posts/hello-stalux.md

@@ -0,0 +1,47 @@
+---
+title: Hello Stalux!
+abbrlink: hello-stalux
+date: 2026-07-27 10:00:00
+tags: [Stalux, Getting Started]
+categories: [Blog]
+desc: Welcome to Stalux! This is your first blog post.
+cc: CC-BY-NC-SA-4.0
+---
+
+Welcome to my blog! This is the first post created with the **Stalux** theme.
+
+## About Stalux
+
+Stalux is a modern, high-performance Astro blog theme featuring:
+
+- 🌙 Dark mode with elegant glassmorphism design
+- 🔍 Full-text search (Pagefind)
+- 📡 RSS & Atom feeds
+- 🤖 LLM discovery files (llms.txt)
+- 💬 Comment system (Waline)
+- 📊 Mermaid diagrams
+- 📐 Math formula rendering
+- 🖼️ PhotoSwipe lightbox
+- 📱 Fully responsive
+
+## Markdown Examples
+
+**Bold**, *italic*, ~~strikethrough~~, `inline code`
+
+```javascript
+// Code block
+function hello() {
+    console.log("Hello, Stalux!");
+}
+```
+
+> Blockquote example
+
+- List item 1
+- List item 2
+- List item 3
+
+1. Ordered list 1
+2. Ordered list 2
+
+For more features, check the [Stalux documentation](https://stalux.needhelp.icu).

package/template/stalux/words/_template.md

@@ -0,0 +1,12 @@
+---
+# source: "Source or Author"
+# link: "https://source-link"  # Optional; when present, source becomes clickable
+# sourceDate: "1999"           # Optional; source date
+# date: "2026-07-27 20:45:00"  # Optional; when recorded
+# updated: "2026-07-27 21:00:00"
+# draft: false                  # Optional; true hides the entry
+# title: "Title"               # Optional
+# abbrlink: "custom-id"        # Optional
+# tags: [tag1, tag2]           # Optional
+---
+Write the quote body here. Supports **Markdown**, `inline code`, and code blocks.

package/template/stalux/words/einstein-imagination.md

@@ -0,0 +1,8 @@
+---
+source: "Albert Einstein"
+link: "https://example.com"
+sourceDate: "1950"
+date: "2026-07-27 10:00:00"
+---
+
+Imagination is more important than knowledge.

package/template/tsconfig.json

@@ -0,0 +1,9 @@
+{
+    "extends": "astro/tsconfigs/strict",
+    "include": [".astro/types.d.ts", "**/*"],
+    "exclude": ["dist"],
+    "compilerOptions": {
+        "strictNullChecks": true,
+        "allowJs": true
+    }
+}