@xingwangzhe/stalux 1.56.0 → 1.57.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@xingwangzhe/stalux",
-    "version": "1.56.0",
+    "version": "1.57.0",
     "description": "A powerful, modern Astro blog theme — use as template or install as plugin",
     "keywords": [
         "astro",

package/src/components/stalux/archives/archivesList.astro

@@ -98,7 +98,7 @@ const archiveYears = [...archivesByYearMonth.entries()]
                                                 )}
                                             </time>
                                             <a
-                                                href={`/posts/${post.data.abbrlink}/`}
+                                                href={`/posts/${post.data.abbrlink}`}
                                                 class="stalux-archive-post-link"
                                                 data-archive-description={post.data.desc || ""}
                                             >

package/src/components/stalux/categories/categoriesCard.astro

@@ -23,7 +23,7 @@ const { t } = createTranslator((siteConfig.lang as string) || "zh-CN");
 <!-- Modern Web Guidance (html): 分类卡本身即 <article>；外层曾经的 <div class="stalux-category-shell">
      已上移到列表的 <li>（见 categoriesList.astro），避免多一层无语义容器。 -->
 <article class="stalux-category-card" data-stalux-control="category-card">
-    <a href={`/categories/${props.category.name}/`} class="stalux-categoryheader a-none">
+    <a href={`/categories/${props.category.name}`} class="stalux-categoryheader a-none">
         <span class="stalux-category-icon">
             <svg
                 aria-hidden="true"

package/src/components/stalux/posts/PostTaxonomy.astro

@@ -51,7 +51,7 @@ const cfg = {
         <ul class={cfg.listClass} data-stalux-reveal>
             {items.map((item) => (
                 <li data-stalux-reveal-item>
-                    <a href={`${cfg.prefix}${item}/`} class={`${cfg.itemClass} a-none`}>
+                    <a href={`${cfg.prefix}${item}`} class={`${cfg.itemClass} a-none`}>
                         {item}
                     </a>
                 </li>

package/src/components/stalux/posts/postCard.astro

@@ -27,7 +27,7 @@ const description = post.data.desc || "";
     class="stalux-post-card-shell stalux-post-card h-full text-inherit no-underline stalux-u-flex stalux-u-flex-col stalux-u-w-full stalux-u-min-w-0"
 >
     {post.data.cover && (
-        <a href={`/posts/${post.data.abbrlink}/`} class="a-none" aria-label={post.data.title}>
+        <a href={`/posts/${post.data.abbrlink}`} class="a-none" aria-label={post.data.title}>
             <span class="stalux-card-post-cover stalux-u-w-full stalux-u-min-w-0">
                 <img
                     src={post.data.cover}
@@ -43,7 +43,7 @@ const description = post.data.desc || "";
         </a>
     )}
     <h2 class="stalux-card-post-title">
-        <a href={`/posts/${post.data.abbrlink}/`} class="a-none">
+        <a href={`/posts/${post.data.abbrlink}`} class="a-none">
             {post.data.title}
         </a>
     </h2>
@@ -90,5 +90,5 @@ const description = post.data.desc || "";
             ))}
         </ul>
     </footer>
-    <a href={`/posts/${post.data.abbrlink}/`} class="stalux-card-read-more a-none"> Read More </a>
+    <a href={`/posts/${post.data.abbrlink}`} class="stalux-card-read-more a-none"> Read More </a>
 </article>

package/src/components/stalux/tags/tagHeader.astro

@@ -21,9 +21,9 @@ const { t } = createTranslator(siteConfig.lang || "zh-CN");
 const typeKey = props.typeKey || props.type;
 let typeUrl = "";
 if (typeKey === "category" || typeKey === "categories" || typeKey === "分类") {
-    typeUrl = "/categories/";
+    typeUrl = "/categories";
 } else if (typeKey === "tag" || typeKey === "tags" || typeKey === "标签") {
-    typeUrl = "/tags/";
+    typeUrl = "/tags";
 }
 ---
 

package/src/components/stalux/tags/tagsCloud.astro

@@ -17,7 +17,7 @@ const cloudDensity = Math.sqrt(Math.max(tagList.length, 100) / 100);
 const tagLinks = tagList.map((t) => ({
     type: "link" as const,
     text: t.name,
-    url: `/tags/${t.name}/`,
+    url: `/tags/${t.name}`,
 }));
 ---
 
@@ -36,7 +36,7 @@ const tagLinks = tagList.map((t) => ({
                 {group.map(({ name, count }) => (
                     <li data-stalux-reveal-item>
                         <a
-                            href={`/tags/${name}/`}
+                            href={`/tags/${name}`}
                             class="stalux-cloud-tag-card"
                             data-stalux-card
                             data-stalux-tag-card

package/src/index.ts

@@ -53,6 +53,7 @@ import { createPageOutputCache } from "./internal/page-output-cache";
 import { loadCoverEncoder, restoreCoverFiles, upgradeCoverImages } from "./internal/post-cover";
 import { isPluginProject } from "./internal/project-mode";
 import { syncBackgroundSvgs, syncFontAssets } from "./internal/public-assets";
+import { normalizeRouteHrefs } from "./internal/route-hrefs";
 import { createRuntimeCacheKey } from "./internal/runtime-cache-key";
 import {
     appendUniquePlugin,
@@ -529,6 +530,8 @@ export function stalux(options: StaluxOptions = {}): AstroIntegration[] {
                     promoteCodeStyles(document);
                     containMermaidSvgs(document);
                     removePageFontStyles(document);
+                    // 正文里手写的 /posts/x/ 也统一成路由器实际提供的形态
+                    normalizeRouteHrefs(document);
                     const images = findHtmlImages(before, document);
                     await updateLocalImageDimensions(images, outDir, {
                         cache: dimensionsCache,
@@ -740,6 +743,16 @@ export function stalux(options: StaluxOptions = {}): AstroIntegration[] {
                 ...userSitemap,
                 customPages,
                 filter,
+                // Page routes are served without a trailing slash; keep the root
+                // and real files (`.md`, `.json`, `.xml`, images) exactly as built.
+                async serialize(item) {
+                    const next = userSitemap?.serialize ? await userSitemap.serialize(item) : item;
+                    if (!next) return next;
+                    const url = new URL(next.url);
+                    if (url.pathname !== "/") url.pathname = url.pathname.replace(/\/+$/u, "");
+                    next.url = url.href;
+                    return next;
+                },
             }),
             {
                 name: "stalux/sitemap-alias",

package/src/internal/html-output.ts

@@ -1,4 +1,5 @@
 import { type DefaultTreeAdapterMap, serialize, serializeOuter } from "parse5";
+import { normalizeRouteHref } from "./route-hrefs";
 
 type Element = DefaultTreeAdapterMap["element"];
 
@@ -17,6 +18,9 @@ export function createHtmlMutationEmitter(
         attrs: Element["attrs"];
         text: string[];
     }> = [];
+    // Anchor hrefs are rewritten by value range only: reserializing the whole
+    // element would re-escape attribute text the emitter never touched.
+    const hrefSnapshots: Array<{ node: Element; start: number; end: number }> = [];
     let head: Element | undefined;
     function visit(node: DefaultTreeAdapterMap["node"]) {
         if ("tagName" in node) {
@@ -37,6 +41,10 @@ export function createHtmlMutationEmitter(
                     attrs: node.attrs.map((attribute) => ({ ...attribute })),
                     text: node.childNodes.map((child) => ("value" in child ? child.value : "")),
                 });
+            } else if (node.tagName === "a") {
+                const href = location?.attrs?.href;
+                if (href)
+                    hrefSnapshots.push({ node, start: href.startOffset, end: href.endOffset });
             }
         }
         if ("childNodes" in node) for (const child of node.childNodes) visit(child);
@@ -45,6 +53,16 @@ export function createHtmlMutationEmitter(
 
     return () => {
         const edits: Array<{ start: number; end: number; value: string }> = [];
+        for (const { node, start, end } of hrefSnapshots) {
+            const current = node.attrs.find((attribute) => attribute.name === "href")?.value;
+            if (current === undefined) continue;
+            const raw = source.slice(start, end);
+            const parsed = /^(href\s*=\s*["'])([^"']*)(["'])$/u.exec(raw);
+            if (!parsed) continue;
+            const next = normalizeRouteHref(parsed[2] ?? "");
+            if (next === parsed[2]) continue;
+            edits.push({ start, end, value: `${parsed[1]}${next}${parsed[3]}` });
+        }
         for (const snapshot of snapshots) {
             const { node, start, end, attrs, text } = snapshot;
             if (!node.parentNode) {

package/src/internal/route-hrefs.ts

@@ -0,0 +1,47 @@
+import type { DefaultTreeAdapterMap } from "parse5";
+
+type Document = DefaultTreeAdapterMap["document"];
+
+/** Endpoints that are real files: the extension identifies them, never a slash. */
+const REAL_FILE =
+    /\.(?:md|json|xml|txt|html?|pdf|png|webp|avif|svg|jpe?g|gif|ico|css|js|mjs|map|zip|mp4|webm|woff2?|ttf|otf)$/iu;
+
+/**
+ * Rewrite a site-absolute href to the form the router actually serves.
+ *
+ * Page routes carry no trailing slash (`/posts/x`, `/archives`), while real
+ * files keep theirs (`/posts/x.md`, `/api/posts.json`). Only rooted paths are
+ * touched: relative links, protocol-relative URLs and anchors pass through.
+ */
+export function normalizeRouteHref(href: string): string {
+    if (!href.startsWith("/") || href.startsWith("//")) return href;
+    const match = /^([^?#]*)([?#].*)?$/u.exec(href);
+    const path = match?.[1] ?? href;
+    const suffix = match?.[2] ?? "";
+    if (path === "/" || !path.endsWith("/") || REAL_FILE.test(path)) return href;
+    return `${path.replace(/\/+$/u, "")}${suffix}`;
+}
+
+/**
+ * Content-authored links still use the old trailing-slash form. Normalising the
+ * parsed document here keeps hand-written Markdown from reintroducing a URL
+ * shape the router no longer serves, without touching the author's source.
+ */
+export function normalizeRouteHrefs(document: Document): number {
+    let changed = 0;
+    const visit = (node: DefaultTreeAdapterMap["node"]): void => {
+        if ("tagName" in node && node.tagName === "a") {
+            for (const attribute of node.attrs) {
+                if (attribute.name !== "href") continue;
+                const next = normalizeRouteHref(attribute.value);
+                if (next !== attribute.value) {
+                    attribute.value = next;
+                    changed++;
+                }
+            }
+        }
+        if ("childNodes" in node) for (const child of node.childNodes) visit(child);
+    };
+    visit(document);
+    return changed;
+}

package/src/internal/social-card-data.ts

@@ -22,7 +22,7 @@ export function createSocialCardData(
         siteTitle: site.title,
         author: author.name,
         host: siteUrl.host,
-        postUrl: new URL(`/posts/${encodeURIComponent(post.abbrlink)}/`, siteUrl).href,
+        postUrl: new URL(`/posts/${encodeURIComponent(post.abbrlink)}`, siteUrl).href,
         tags: post.tags ?? [],
         date: formatInTimeZone(
             parseDate(post.date, site.timezone || "Asia/Shanghai"),

package/src/pages/404.astro

@@ -25,7 +25,7 @@ const { t } = createTranslator(siteConfig.lang || "zh-CN");
             <p data-stalux-motion-content>{t("page404.pageNotFound")}</p>
             <p class="agent-recovery" data-stalux-motion-content>
                 This URL does not exist. Continue at the <a href="/">home page</a>, browse the
-                <a href="/archives/">archive</a>, read <a href="/llms.txt">llms.txt</a>, or inspect
+                <a href="/archives">archive</a>, read <a href="/llms.txt">llms.txt</a>, or inspect
                 the
                 <a href="/sitemap-index.xml">sitemap</a>
                 to find published content.

package/src/pages/api/posts.json.ts

@@ -29,7 +29,7 @@ export const GET: APIRoute = async ({ logger }) => {
         categories: post.data.categories ?? [],
         desc: post.data.desc ?? "",
         wordCount: descriptions.get(String(post.data.abbrlink))?.wordCount ?? 0,
-        url: sitePath(`posts/${encodeURIComponent(String(post.data.abbrlink))}/`),
+        url: sitePath(`posts/${encodeURIComponent(String(post.data.abbrlink))}`),
     }));
 
     return new Response(JSON.stringify(payload), {

package/src/pages/atom.xml.ts

@@ -19,6 +19,8 @@ export const GET: APIRoute = async ({ logger }) => {
         title: stalux?.title || "Stalux Blog",
         description: stalux?.description || "A blog powered by Stalux theme",
         site: stalux.url,
+        // 页面路由不带尾斜杠，feed 里的条目链接要与之保持一致
+        trailingSlash: false,
         items,
         customData: `<language>${langToFeedLanguage(lang)}</language>\n<copyright>${t("rss.copyright")}</copyright>`,
         xmlns: {

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

@@ -17,8 +17,8 @@ function generateCCFooter(post: CollectionEntry<"posts">, config: ConfigMap): st
     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}/`;
+        ? `${baseUrl}/posts/${post.data.abbrlink}`
+        : `/posts/${post.data.abbrlink}`;
 
     const lines: string[] = [];
     lines.push(`**${t("post.author")}**${author}`);

package/src/pages/rss.xml.ts

@@ -19,6 +19,8 @@ export const GET: APIRoute = async ({ logger }) => {
         title: stalux?.title || "Stalux Blog",
         description: stalux?.description || "A blog powered by Stalux theme",
         site: stalux.url,
+        // 页面路由不带尾斜杠，feed 里的条目链接要与之保持一致
+        trailingSlash: false,
         items,
         customData: `<language>${langToFeedLanguage(lang)}</language>\n<copyright>${t("rss.copyright")}</copyright>`,
         xmlns: {

package/src/utils/ai-discovery.ts

@@ -103,7 +103,7 @@ function pageUrl(site: string, path: string, exportMd: boolean): string {
 
 /** 生成文章链接，可切换 .md 源码版本 */
 export function postUrl(site: string, abbrlink: string | number, exportMd: boolean): string {
-    return exportMd && abbrlink ? `${site}/posts/${abbrlink}.md` : `${site}/posts/${abbrlink}/`;
+    return exportMd && abbrlink ? `${site}/posts/${abbrlink}.md` : `${site}/posts/${abbrlink}`;
 }
 
 /** 获取已发布文章并按日期降序排列 */

package/src/utils/feed.ts

@@ -70,7 +70,7 @@ export async function buildFeedItems(
             title: post.data.title,
             pubDate: new Date(toMachineDateTime(post.data.date, stalux.timezone)),
             description: cached?.desc || post.data.desc || "",
-            link: `/posts/${post.data.abbrlink}/`,
+            link: `/posts/${post.data.abbrlink}`,
             categories: post.data.categories || [],
             customData,
         };

package/src/utils/public-routes.ts

@@ -45,10 +45,20 @@ export function getMarkdownPath(pathname: string): string | undefined {
     return undefined;
 }
 
+/**
+ * The public form of an HTML route. Every page route is emitted without a
+ * trailing slash (`/posts/x`, `/tags/x`, `/archives`); only the root keeps its
+ * single slash. Real files — Markdown exports, JSON/XML endpoints, images —
+ * are returned untouched so they keep the extension that identifies them.
+ */
+export function toRoutePath(pathname: string): string {
+    const path = normalizePublicPath(pathname);
+    return path === "/" ? "/" : path;
+}
+
 export function toPublicUrl(site: string, pathname: string, markdown = false): string {
     const base = site.replace(/\/+$/u, "");
-    const normalized = normalizePublicPath(pathname);
-    const path = markdown ? getMarkdownPath(normalized) : normalized;
-    if (!path) return `${base}${normalized === "/" ? "/" : `${normalized}/`}`;
-    return markdown ? `${base}${path}` : `${base}${path === "/" ? "/" : `${path}/`}`;
+    const path = markdown ? getMarkdownPath(pathname) : toRoutePath(pathname);
+    if (!path) return `${base}${toRoutePath(pathname)}`;
+    return `${base}${path}`;
 }

package/src/utils/seo-document.ts

@@ -59,8 +59,9 @@ export function buildSeoDocument(input: SeoDocumentInput): SeoDocument {
     const routeKind = getRouteKind(pathname);
     const siteUrl = normalizeSiteUrl(site.canonical ?? site.url);
     const normalizedPath = normalizePublicPath(pathname);
-    const canonicalPath = normalizedPath === "/" ? "/" : `${normalizedPath}/`;
-    const canonical = new URL(canonicalPath, `${siteUrl}/`).href;
+    // Canonical mirrors the URL the router actually serves: page routes carry no
+    // trailing slash, so /posts/x and /archives are canonical, /posts/x/ is not.
+    const canonical = new URL(normalizedPath, `${siteUrl}/`).href;
     const title = routeKind === "home" && site.seoTitle ? site.seoTitle : page.title;
     const siteName = site.title;
     const siteTitleSuffix = ` | ${site.title}`;