@jet-w/astro-blog 0.1.6 → 0.2.1

package/templates/default/package.json

@@ -14,7 +14,7 @@
     "@astrojs/rss": "^4.0.14",
     "@astrojs/tailwind": "^5.1.3",
     "@astrojs/vue": "^5.0.6",
-    "@jet-w/astro-blog": "^0.1.0",
+    "@jet-w/astro-blog": "file:../../",
     "@tailwindcss/typography": "^0.5.15",
     "astro": "^5.14.1",
     "echarts": "^6.0.0",

package/templates/default/src/config/footer.ts

@@ -1,25 +1,28 @@
 /**
  * Footer Configuration
  *
- * Configure footer links, copyright, and display options
+ * Configure footer links, copyright, and display options.
+ *
+ * NOTE: For multi-language support, language-specific settings
+ * (quickLinksTitle, quickLinks, contactTitle) should be configured
+ * in astro.config.mjs under localeConfigs.
+ * This file contains shared settings that are not language-specific.
  */
 
 import type { FooterConfig } from '@jet-w/astro-blog';
 import { socialLinks } from './social';
 
 /**
- * Footer configuration
+ * Footer configuration (shared settings)
+ *
+ * Language-specific quickLinks and titles are configured in astro.config.mjs
  */
 export const footerConfig: FooterConfig = {
-  quickLinksTitle: '快速链接',
-  quickLinks: [
-    { name: '首页', href: '/' },
-    { name: '文章', href: '/posts' },
-    { name: '标签', href: '/tags' },
-    { name: '归档', href: '/archives' },
-    { name: '关于', href: '/about' }
-  ],
-  contactTitle: '联系方式',
+  // These are fallback values; language-specific values are in astro.config.mjs
+  quickLinksTitle: 'Quick Links',
+  quickLinks: [],
+  contactTitle: 'Contact',
+  // Shared settings (not language-specific)
   socialLinks: socialLinks,
   showRss: true,
   rssUrl: '/rss.xml',

package/templates/default/src/config/locales/en/footer.ts

@@ -0,0 +1,17 @@
+/**
+ * English footer configuration
+ *
+ * When English is the default locale (prefixDefaultLocale: false),
+ * paths should NOT have /en/ prefix
+ */
+export const footer = {
+  quickLinksTitle: 'Quick Links',
+  quickLinks: [
+    { name: 'Home', href: '/' },
+    { name: 'Posts', href: '/posts' },
+    { name: 'Tags', href: '/tags' },
+    { name: 'Archives', href: '/archives' },
+    { name: 'About', href: '/about' },
+  ],
+  contactTitle: 'Contact',
+};

package/templates/default/src/config/locales/en/index.ts

@@ -0,0 +1,20 @@
+/**
+ * English (en) locale configuration
+ */
+import { site } from './site';
+import { menu } from './menu';
+import { footer } from './footer';
+import { sidebar } from './sidebar';
+import { ui } from './ui';
+
+export const enConfig = {
+  site,
+  menu,
+  footer,
+  sidebar,
+  ui,
+  // Content path prefix for filtering posts by locale
+  contentPathPrefix: 'blog_docs_en',
+};
+
+export { site, menu, footer, sidebar, ui };

package/templates/default/src/config/locales/en/menu.ts

@@ -0,0 +1,14 @@
+/**
+ * English navigation menu configuration
+ *
+ * When English is the default locale (prefixDefaultLocale: false),
+ * paths should NOT have /en/ prefix
+ */
+export const menu = [
+  { name: 'Home', href: '/', icon: 'home' },
+  { name: 'Get Started', href: '/posts/blog_docs_en/01.get-started', icon: 'posts' },
+  { name: 'Guide', href: '/posts/blog_docs_en/02.guide', icon: 'posts' },
+  { name: 'Config', href: '/posts/blog_docs_en/03.config', icon: 'posts' },
+  { name: 'Slides', href: '/slides', icon: 'slides' },
+  { name: 'About', href: '/about', icon: 'about' },
+];

package/templates/default/src/config/locales/en/sidebar.ts

@@ -0,0 +1,34 @@
+/**
+ * English sidebar configuration
+ *
+ * When English is the default locale (prefixDefaultLocale: false),
+ * paths should NOT have /en/ prefix
+ */
+export const sidebar = {
+  groups: [
+    {
+      type: 'scan' as const,
+      title: 'Documentation',
+      icon: 'ri:book-open-line',
+      scanPath: 'blog_docs_en/01.get-started',
+      collapsed: false,
+      showForPaths: ['/posts/blog_docs_en/01.get-started/**'],
+    },
+    {
+      type: 'scan' as const,
+      title: 'Documentation',
+      icon: 'ri:book-open-line',
+      scanPath: 'blog_docs_en/02.guide',
+      collapsed: false,
+      showForPaths: ['/posts/blog_docs_en/02.guide/**'],
+    },
+    {
+      type: 'scan' as const,
+      title: 'Documentation',
+      icon: 'ri:book-open-line',
+      scanPath: 'blog_docs_en/03.config',
+      collapsed: false,
+      showForPaths: ['/posts/blog_docs_en/03.config/**'],
+    },
+  ],
+};

package/templates/default/src/config/locales/en/site.ts

@@ -0,0 +1,7 @@
+/**
+ * English site configuration
+ */
+export const site = {
+  title: 'My Astro Blog',
+  description: '',
+};

package/templates/default/src/config/locales/en/ui.ts

@@ -0,0 +1,29 @@
+/**
+ * English UI translations
+ *
+ * Override any UI strings here. The library provides default English translations,
+ * so you only need to add strings you want to customize.
+ *
+ * See UITranslations interface for all available keys:
+ * - Navigation: home, blog, about, search
+ * - Posts: posts, postList, noPostsFound, readMore, readingTime, minuteRead
+ * - Tags & Categories: tags, categories, allTags, allCategories, taggedWith, inCategory
+ * - Archives: archives, postsInArchive
+ * - Sidebar: recentPosts, popularTags, friendLinks, documentTree
+ * - Footer: quickLinks, contact
+ * - Search: searchPlaceholder, searchResults, noResults, searching, searchArticles, etc.
+ * - Hero: browsePosts, aboutMe
+ * - Pagination: previousPage, nextPage, page, of
+ * - Article: publishedOn, updatedOn, author, tableOfContents, relatedPosts, etc.
+ * - Misc: backToTop, copyCode, copied, expand, collapse, viewMode, sortBy, etc.
+ * - Slides: slides, slidesList
+ * - RSS: rssFeed
+ */
+import type { UITranslations } from '@jet-w/astro-blog';
+
+export const ui: Partial<UITranslations> = {
+  // Example overrides:
+  // browsePosts: 'Browse Posts',
+  // aboutMe: 'About Me',
+  // searchPlaceholder: 'Search articles...',
+};

package/templates/default/src/config/locales/index.ts

@@ -0,0 +1,7 @@
+/**
+ * Locale configurations index
+ *
+ * Export all locale-specific configurations
+ */
+export { zhCNConfig } from './zh-CN';
+export { enConfig } from './en';

package/templates/default/src/config/locales/zh-CN/footer.ts

@@ -0,0 +1,17 @@
+/**
+ * 中文页脚配置
+ *
+ * 当英语是默认语言时 (prefixDefaultLocale: false)，
+ * 中文路径需要 /zh-CN 前缀
+ */
+export const footer = {
+  quickLinksTitle: '快速链接',
+  quickLinks: [
+    { name: '首页', href: '/zh-CN/' },
+    { name: '文章', href: '/zh-CN/posts' },
+    { name: '标签', href: '/zh-CN/tags' },
+    { name: '归档', href: '/zh-CN/archives' },
+    { name: '关于', href: '/zh-CN/about' },
+  ],
+  contactTitle: '联系方式',
+};

package/templates/default/src/config/locales/zh-CN/index.ts

@@ -0,0 +1,20 @@
+/**
+ * 中文 (zh-CN) 语言配置
+ */
+import { site } from './site';
+import { menu } from './menu';
+import { footer } from './footer';
+import { sidebar } from './sidebar';
+import { ui } from './ui';
+
+export const zhCNConfig = {
+  site,
+  menu,
+  footer,
+  sidebar,
+  ui,
+  // 内容路径前缀，用于按语言过滤文章
+  contentPathPrefix: 'blog_docs_zh',
+};
+
+export { site, menu, footer, sidebar, ui };

package/templates/default/src/config/locales/zh-CN/menu.ts

@@ -0,0 +1,14 @@
+/**
+ * 中文导航菜单配置
+ *
+ * 当英文是默认语言且 prefixDefaultLocale: false 时，
+ * 中文路径需要包含 /zh-CN/ 前缀
+ */
+export const menu = [
+  { name: '主页', href: '/zh-CN/', icon: 'home' },
+  { name: '开始使用', href: '/zh-CN/posts/blog_docs_zh/01.get-started', icon: 'posts' },
+  { name: '指南', href: '/zh-CN/posts/blog_docs_zh/02.guide', icon: 'posts' },
+  { name: '配置', href: '/zh-CN/posts/blog_docs_zh/03.config', icon: 'posts' },
+  { name: '幻灯片', href: '/zh-CN/slides', icon: 'slides' },
+  { name: '关于', href: '/zh-CN/about', icon: 'about' },
+];

package/templates/default/src/config/locales/zh-CN/sidebar.ts

@@ -0,0 +1,34 @@
+/**
+ * 中文侧边栏配置
+ *
+ * 当英文是默认语言且 prefixDefaultLocale: false 时，
+ * 中文路径需要包含 /zh-CN/ 前缀
+ */
+export const sidebar = {
+  groups: [
+    {
+      type: 'scan' as const,
+      title: '快速入门',
+      icon: 'ri:rocket-line',
+      scanPath: 'blog_docs_zh/01.get-started',
+      collapsed: false,
+      showForPaths: ['/zh-CN/posts/blog_docs_zh/01.get-started/**'],
+    },
+    {
+      type: 'scan' as const,
+      title: '使用指南',
+      icon: 'ri:book-open-line',
+      scanPath: 'blog_docs_zh/02.guide',
+      collapsed: false,
+      showForPaths: ['/zh-CN/posts/blog_docs_zh/02.guide/**'],
+    },
+    {
+      type: 'scan' as const,
+      title: '配置文档',
+      icon: 'ri:settings-3-line',
+      scanPath: 'blog_docs_zh/03.config',
+      collapsed: false,
+      showForPaths: ['/zh-CN/posts/blog_docs_zh/03.config/**'],
+    },
+  ],
+};

package/templates/default/src/config/locales/zh-CN/site.ts

@@ -0,0 +1,7 @@
+/**
+ * 中文站点配置
+ */
+export const site = {
+  title: '我的Astro博客',
+  description: '',
+};

package/templates/default/src/config/locales/zh-CN/ui.ts

@@ -0,0 +1,29 @@
+/**
+ * 中文 UI 翻译
+ *
+ * 在此覆盖任何 UI 字符串。库已提供默认中文翻译，
+ * 所以您只需要添加想要自定义的字符串。
+ *
+ * 可用的翻译键请参考 UITranslations 接口：
+ * - 导航: home, blog, about, search
+ * - 文章: posts, postList, noPostsFound, readMore, readingTime, minuteRead
+ * - 标签和分类: tags, categories, allTags, allCategories, taggedWith, inCategory
+ * - 归档: archives, postsInArchive
+ * - 侧边栏: recentPosts, popularTags, friendLinks, documentTree
+ * - 页脚: quickLinks, contact
+ * - 搜索: searchPlaceholder, searchResults, noResults, searching, searchArticles 等
+ * - Hero 区域: browsePosts, aboutMe
+ * - 分页: previousPage, nextPage, page, of
+ * - 文章详情: publishedOn, updatedOn, author, tableOfContents, relatedPosts 等
+ * - 其他: backToTop, copyCode, copied, expand, collapse, viewMode, sortBy 等
+ * - 演示: slides, slidesList
+ * - RSS: rssFeed
+ */
+import type { UITranslations } from '@jet-w/astro-blog';
+
+export const ui: Partial<UITranslations> = {
+  // 示例覆盖：
+  // browsePosts: '浏览文章',
+  // aboutMe: '关于我',
+  // searchPlaceholder: '搜索文章...',
+};

package/templates/default/src/config/sidebar.ts

@@ -1,13 +1,19 @@
 /**
  * Sidebar Configuration
  *
- * Configure sidebar display options, groups, and widgets
+ * Configure sidebar display options, groups, and widgets.
+ *
+ * NOTE: For multi-language support, sidebar groups (with titles)
+ * should be configured in astro.config.mjs under localeConfigs.
+ * This file contains shared settings that are not language-specific.
  */
 
 import type { SidebarConfig } from '@jet-w/astro-blog';
 
 /**
- * Sidebar configuration
+ * Sidebar configuration (shared settings)
+ *
+ * Language-specific groups are configured in astro.config.mjs
  */
 export const sidebarConfig: SidebarConfig = {
   enabled: true,
@@ -20,14 +26,6 @@ export const sidebarConfig: SidebarConfig = {
   archivesCount: 6,
   showFriendLinks: false,
   friendLinks: [],
-  groups: [
-    {
-      type: 'scan',
-      title: '博客指南',
-      icon: 'ri:book-open-line',
-      scanPath: 'blog_docs',
-      collapsed: true,
-      showForPaths: ['/posts/blog_docs/**']
-    }
-  ]
+  // Groups are configured per-language in astro.config.mjs localeConfigs
+  groups: []
 };

package/templates/default/src/config/site.ts

@@ -10,8 +10,8 @@ import type { SiteConfig } from '@jet-w/astro-blog';
  * Site configuration
  */
 export const siteConfig: SiteConfig = {
-  title: 'My Astro Blog',
-  description: '基于 Astro + Vue + Tailwind 构建的个人技术博客',
+  title: 'My Astro Blog22',
+  description: '',
   author: 'Author',
   email: 'email@example.com',
   avatar: '/images/avatar.svg',

package/templates/default/src/content.config.ts

@@ -2,7 +2,11 @@ import { defineCollection, z } from 'astro:content';
 import { glob } from 'astro/loaders';
 
 const posts = defineCollection({
-  loader: glob({ pattern: '**/*.{md,mdx}', base: './content/posts' }),
+  loader: glob({
+    pattern: '**/*.{md,mdx}',
+    base: './content/posts',
+    generateId: ({ entry }) => entry.replace(/\.(md|mdx)$/, ''),
+  }),
   schema: z.object({
     title: z.string(),
     description: z.string().optional(),
@@ -60,7 +64,11 @@ const posts = defineCollection({
 });
 
 const pages = defineCollection({
-  loader: glob({ pattern: '**/*.{md,mdx}', base: './content/pages' }),
+  loader: glob({
+    pattern: '**/*.{md,mdx}',
+    base: './content/pages',
+    generateId: ({ entry }) => entry.replace(/\.(md|mdx)$/, ''),
+  }),
   schema: z.object({
     title: z.string(),
     description: z.string().optional(),
@@ -70,7 +78,11 @@ const pages = defineCollection({
 });
 
 const slides = defineCollection({
-  loader: glob({ pattern: '**/*.{md,mdx}', base: './content/slides' }),
+  loader: glob({
+    pattern: '**/*.{md,mdx}',
+    base: './content/slides',
+    generateId: ({ entry }) => entry.replace(/\.(md|mdx)$/, ''),
+  }),
   schema: z.object({
     title: z.string(),
     description: z.string().optional(),

package/templates/default/src/env.d.ts

@@ -0,0 +1,7 @@
+/// <reference types="astro/client" />
+
+// Virtual module for i18n config (injected by @jet-w/astro-blog integration)
+declare module 'virtual:astro-blog-i18n' {
+  import type { I18nConfig } from '@jet-w/astro-blog/config';
+  export const i18nConfig: I18nConfig;
+}

package/dist/chunk-MQXPSOYB.js

@@ -1,124 +0,0 @@
-// src/integration.ts
-import { fileURLToPath } from "url";
-import path from "path";
-var defaultOptions = {
-  routes: {
-    posts: true,
-    tags: true,
-    categories: true,
-    archives: true,
-    slides: true,
-    search: true,
-    rss: true
-  }
-};
-function astroBlogIntegration(options = {}) {
-  const mergedOptions = {
-    ...defaultOptions,
-    routes: { ...defaultOptions.routes, ...options.routes }
-  };
-  const currentDir = path.dirname(fileURLToPath(import.meta.url));
-  const pagesDir = path.resolve(currentDir, "../src/pages");
-  return {
-    name: "@jet-w/astro-blog",
-    hooks: {
-      "astro:config:setup": ({ injectRoute, logger }) => {
-        logger.info("Injecting @jet-w/astro-blog routes...");
-        const routes = mergedOptions.routes;
-        if (routes.posts) {
-          injectRoute({
-            pattern: "/posts",
-            entrypoint: `${pagesDir}/posts/index.astro`
-          });
-          injectRoute({
-            pattern: "/posts/page/[page]",
-            entrypoint: `${pagesDir}/posts/page/[page].astro`
-          });
-          injectRoute({
-            pattern: "/posts/[...slug]",
-            entrypoint: `${pagesDir}/posts/[...slug].astro`
-          });
-        }
-        if (routes.tags) {
-          injectRoute({
-            pattern: "/tags",
-            entrypoint: `${pagesDir}/tags/index.astro`
-          });
-          injectRoute({
-            pattern: "/tags/[tag]",
-            entrypoint: `${pagesDir}/tags/[tag].astro`
-          });
-          injectRoute({
-            pattern: "/tags/[tag]/page/[page]",
-            entrypoint: `${pagesDir}/tags/[tag]/page/[page].astro`
-          });
-        }
-        if (routes.categories) {
-          injectRoute({
-            pattern: "/categories",
-            entrypoint: `${pagesDir}/categories/index.astro`
-          });
-          injectRoute({
-            pattern: "/categories/[category]",
-            entrypoint: `${pagesDir}/categories/[category].astro`
-          });
-          injectRoute({
-            pattern: "/categories/[category]/page/[page]",
-            entrypoint: `${pagesDir}/categories/[category]/page/[page].astro`
-          });
-        }
-        if (routes.archives) {
-          injectRoute({
-            pattern: "/archives",
-            entrypoint: `${pagesDir}/archives/index.astro`
-          });
-          injectRoute({
-            pattern: "/archives/[year]/[month]",
-            entrypoint: `${pagesDir}/archives/[year]/[month].astro`
-          });
-          injectRoute({
-            pattern: "/archives/[year]/[month]/page/[page]",
-            entrypoint: `${pagesDir}/archives/[year]/[month]/page/[page].astro`
-          });
-        }
-        if (routes.slides) {
-          injectRoute({
-            pattern: "/slides",
-            entrypoint: `${pagesDir}/slides/index.astro`
-          });
-          injectRoute({
-            pattern: "/slides/[...slug]",
-            entrypoint: `${pagesDir}/slides/[...slug].astro`
-          });
-        }
-        if (routes.search) {
-          injectRoute({
-            pattern: "/search",
-            entrypoint: `${pagesDir}/search.astro`
-          });
-          injectRoute({
-            pattern: "/search-index.json",
-            entrypoint: `${pagesDir}/search-index.json.ts`
-          });
-        }
-        if (routes.rss) {
-          injectRoute({
-            pattern: "/rss.xml",
-            entrypoint: `${pagesDir}/rss.xml.ts`
-          });
-        }
-        injectRoute({
-          pattern: "/[...slug]",
-          entrypoint: `${pagesDir}/[...slug].astro`
-        });
-        logger.info("Routes injected successfully!");
-      }
-    }
-  };
-}
-var integration_default = astroBlogIntegration;
-
-export {
-  astroBlogIntegration,
-  integration_default
-};