@jet-w/astro-blog 0.2.4 → 0.2.6

package/src/pages/posts/index.astro

@@ -6,14 +6,19 @@ import NavigationTabs from '@jet-w/astro-blog/components/blog/NavigationTabs.vue
 import { getCollection } from 'astro:content';
 import { i18nConfig as virtualI18nConfig } from 'virtual:astro-blog-i18n';
 import { defaultI18nConfig } from '../../config/i18n';
-import { getLocaleFromPath, getLocaleConfig, getLocalePrefix, filterPostsByLocale } from '../../utils/i18n';
+import { getLocaleFromPath, getLocaleConfig, getLocalePrefix, filterPostsByLocale, removeBase } from '../../utils/i18n';
 
 // Get i18n config
 const i18nConfig = virtualI18nConfig || defaultI18nConfig;
-const currentLocale = getLocaleFromPath(Astro.url.pathname, i18nConfig);
+const base = import.meta.env.BASE_URL;
+
+// Remove base URL from current path for locale detection
+const pathWithoutBase = removeBase(Astro.url.pathname, base);
+
+const currentLocale = getLocaleFromPath(pathWithoutBase, i18nConfig);
 const localeConfig = getLocaleConfig(currentLocale, i18nConfig);
 const ui = localeConfig.ui;
-const localePrefix = getLocalePrefix(currentLocale, i18nConfig);
+const localePrefix = getLocalePrefix(currentLocale, i18nConfig, base);
 
 // 从新的内容目录获取文章数据
 const allPostsCollection = await getCollection('posts');

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

@@ -25,10 +25,16 @@ const currentPage = parseInt(page as string, 10);
 
 // Get i18n config
 const i18nConfig = virtualI18nConfig || defaultI18nConfig;
-const currentLocale = getLocaleFromPath(Astro.url.pathname, i18nConfig);
+const base = import.meta.env.BASE_URL;
+
+// Remove base URL from current path for locale detection
+const { removeBase } = await import('../../../utils/i18n');
+const pathWithoutBase = removeBase(Astro.url.pathname, base);
+
+const currentLocale = getLocaleFromPath(pathWithoutBase, i18nConfig);
 const localeConfig = getLocaleConfig(currentLocale, i18nConfig);
 const ui = localeConfig.ui;
-const localePrefix = getLocalePrefix(currentLocale, i18nConfig);
+const localePrefix = getLocalePrefix(currentLocale, i18nConfig, base);
 
 // 从新的内容目录获取文章数据
 const allPostsCollection = await getCollection('posts');

package/src/pages/search.astro

@@ -4,7 +4,7 @@ import SearchInterface from '@jet-w/astro-blog/components/ui/SearchInterface.vue
 import type { I18nConfig } from '../config/i18n';
 import { defaultI18nConfig } from '../config/i18n';
 import { i18nConfig as virtualI18nConfig } from 'virtual:astro-blog-i18n';
-import { getLocaleFromPath, getLocaleConfig } from '../utils/i18n';
+import { getLocaleFromPath, getLocaleConfig, removeBase } from '../utils/i18n';
 
 export interface Props {
   i18nConfig?: I18nConfig;
@@ -12,8 +12,14 @@ export interface Props {
 
 const { i18nConfig = virtualI18nConfig || defaultI18nConfig } = Astro.props;
 
-// Get current locale from URL
-const currentLocale = getLocaleFromPath(Astro.url.pathname, i18nConfig);
+// Get base URL for prefixing links
+const base = import.meta.env.BASE_URL;
+
+// Remove base URL from current path for locale detection
+const pathWithoutBase = removeBase(Astro.url.pathname, base);
+
+// Get current locale from URL (use path without base)
+const currentLocale = getLocaleFromPath(pathWithoutBase, i18nConfig);
 const localeConfig = getLocaleConfig(currentLocale, i18nConfig);
 const ui = localeConfig.ui;
 

package/src/pages/slides/index.astro

@@ -3,14 +3,19 @@ import { getCollection } from 'astro:content';
 import PageLayout from '@jet-w/astro-blog/layouts/PageLayout.astro';
 import { i18nConfig as virtualI18nConfig } from 'virtual:astro-blog-i18n';
 import { defaultI18nConfig } from '../../config/i18n';
-import { getLocaleFromPath, getLocaleConfig, getLocalePrefix } from '../../utils/i18n';
+import { getLocaleFromPath, getLocaleConfig, getLocalePrefix, removeBase } from '../../utils/i18n';
 
 // Get i18n config
 const i18nConfig = virtualI18nConfig || defaultI18nConfig;
-const currentLocale = getLocaleFromPath(Astro.url.pathname, i18nConfig);
+const base = import.meta.env.BASE_URL;
+
+// Remove base URL from current path for locale detection
+const pathWithoutBase = removeBase(Astro.url.pathname, base);
+
+const currentLocale = getLocaleFromPath(pathWithoutBase, i18nConfig);
 const localeConfig = getLocaleConfig(currentLocale, i18nConfig);
 const ui = localeConfig.ui;
-const localePrefix = getLocalePrefix(currentLocale, i18nConfig);
+const localePrefix = getLocalePrefix(currentLocale, i18nConfig, base);
 
 // 获取所有非草稿的 slides
 const slides = (await getCollection('slides', ({ data }) => !data.draft))

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

@@ -3,6 +3,9 @@ import { getCollection } from 'astro:content';
 import PageLayout from '@jet-w/astro-blog/layouts/PageLayout.astro';
 import PostCard from '@jet-w/astro-blog/components/blog/PostCard.astro';
 import Pagination from '@jet-w/astro-blog/components/ui/Pagination.astro';
+import { i18nConfig as virtualI18nConfig } from 'virtual:astro-blog-i18n';
+import { defaultI18nConfig } from '../../../../config/i18n';
+import { getLocaleFromPath, getLocaleConfig, getLocalePrefix, filterPostsByLocale, removeBase } from '../../../../utils/i18n';
 
 export async function getStaticPaths() {
   const postsPerPage = 10;
@@ -53,8 +56,23 @@ export async function getStaticPaths() {
 const { tagSlug, tagName, page: currentPage, totalPages } = Astro.props;
 const postsPerPage = 10;
 
+// Get i18n config
+const i18nConfig = virtualI18nConfig || defaultI18nConfig;
+const base = import.meta.env.BASE_URL;
+
+// Remove base URL from current path for locale detection
+const pathWithoutBase = removeBase(Astro.url.pathname, base);
+
+const currentLocale = getLocaleFromPath(pathWithoutBase, i18nConfig);
+const localeConfig = getLocaleConfig(currentLocale, i18nConfig);
+const ui = localeConfig.ui;
+const localePrefix = getLocalePrefix(currentLocale, i18nConfig, base);
+
 // 获取所有文章并筛选包含该标签的文章
-const allPosts = await getCollection('posts', ({ data }) => !data.draft);
+const allPostsCollection = await getCollection('posts', ({ data }) => !data.draft);
+
+// Filter posts by current locale
+const allPosts = filterPostsByLocale(allPostsCollection, currentLocale, i18nConfig);
 
 // 筛选包含该标签的文章
 const filteredPosts = allPosts
@@ -95,25 +113,26 @@ const relatedTags = Array.from(relatedTagMap.entries())
 ---
 
 <PageLayout
-  title={`标签: ${tagName} - 第 ${currentPage} 页`}
-  description={`浏览所有关于 ${tagName} 的文章 - 第 ${currentPage} 页`}
+  title={`${ui.taggedWith}: ${tagName} - ${ui.page} ${currentPage}`}
+  description={`${ui.taggedWith} ${tagName} - ${ui.page} ${currentPage}`}
   showSidebar={true}
+  i18nConfig={i18nConfig}
 >
   <!-- 面包屑导航 -->
   <nav class="flex items-center space-x-2 text-sm text-slate-600 dark:text-slate-400 mb-8">
-    <a href="/" class="hover:text-primary-500 transition-colors">首页</a>
+    <a href={`${localePrefix}/`} class="hover:text-primary-500 transition-colors">{ui.home}</a>
     <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
       <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 5l7 7-7 7" />
     </svg>
-    <a href="/tags" class="hover:text-primary-500 transition-colors">标签</a>
+    <a href={`${localePrefix}/tags`} class="hover:text-primary-500 transition-colors">{ui.allTags}</a>
     <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
       <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 5l7 7-7 7" />
     </svg>
-    <a href={`/tags/${tagSlug}`} class="hover:text-primary-500 transition-colors">{tagName}</a>
+    <a href={`${localePrefix}/tags/${tagSlug}`} class="hover:text-primary-500 transition-colors">{tagName}</a>
     <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
       <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 5l7 7-7 7" />
     </svg>
-    <span class="text-slate-900 dark:text-slate-100">第 {currentPage} 页</span>
+    <span class="text-slate-900 dark:text-slate-100">{ui.page} {currentPage}</span>
   </nav>
 
   <!-- 页面头部 -->
@@ -129,16 +148,16 @@ const relatedTags = Array.from(relatedTagMap.entries())
     </h1>
 
     <p class="text-xl text-slate-600 dark:text-slate-400 mb-8">
-      找到 {totalPosts} 篇关于 {tagName} 的文章
+      {totalPosts} {ui.posts}
     </p>
 
     <!-- 标签统计 -->
     <div class="inline-flex items-center space-x-6 text-sm text-slate-500 dark:text-slate-400 bg-slate-50 dark:bg-slate-800 px-6 py-3 rounded-lg">
       <span>#{tagName}</span>
       <span>•</span>
-      <span>{totalPosts} 篇文章</span>
+      <span>{totalPosts} {ui.posts}</span>
       <span>•</span>
-      <span>第 {currentPage} / {totalPages} 页</span>
+      <span>{ui.page} {currentPage} / {totalPages}</span>
     </div>
   </div>
 
@@ -158,6 +177,9 @@ const relatedTags = Array.from(relatedTagMap.entries())
             image: post.data.image
           }}
           layout="horizontal"
+          localePrefix={localePrefix}
+          locale={localeConfig.locale.dateLocale}
+          ui={ui}
         />
       ))}
     </div>
@@ -165,13 +187,13 @@ const relatedTags = Array.from(relatedTagMap.entries())
     <div class="text-center py-16">
       <div class="text-6xl mb-4">📝</div>
       <h3 class="text-xl font-semibold text-slate-900 dark:text-slate-100 mb-2">
-        暂无相关文章
+        {ui.noPostsFound}
       </h3>
       <p class="text-slate-600 dark:text-slate-400 mb-6">
-        目前还没有关于 {tagName} 的文章，请查看其他标签。
+        {ui.noPostsFound}
       </p>
-      <a href="/tags" class="btn-secondary">
-        浏览所有标签
+      <a href={`${localePrefix}/tags`} class="btn-secondary">
+        {ui.allTags}
       </a>
     </div>
   )}
@@ -181,7 +203,7 @@ const relatedTags = Array.from(relatedTagMap.entries())
     <Pagination
       currentPage={currentPage}
       totalPages={totalPages}
-      baseUrl={`/tags/${tagSlug}`}
+      baseUrl={`${localePrefix}/tags/${tagSlug}`}
     />
   )}
 
@@ -189,12 +211,12 @@ const relatedTags = Array.from(relatedTagMap.entries())
   {relatedTags.length > 0 && (
     <section class="mt-16 pt-8 border-t border-slate-200 dark:border-slate-700">
       <h2 class="text-2xl font-bold text-slate-900 dark:text-slate-100 mb-6">
-        相关标签
+        {ui.popularTags}
       </h2>
       <div class="flex flex-wrap gap-3">
         {relatedTags.map((relatedTag) => (
           <a
-            href={`/tags/${relatedTag.slug}`}
+            href={`${localePrefix}/tags/${relatedTag.slug}`}
             class="inline-flex items-center px-4 py-2 bg-white dark:bg-slate-800 border border-slate-300 dark:border-slate-600 rounded-lg hover:border-primary-300 dark:hover:border-primary-600 hover:shadow-md transition-all duration-200 group"
           >
             <span class="font-medium text-slate-900 dark:text-slate-100 group-hover:text-primary-500 transition-colors">

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

@@ -35,10 +35,16 @@ const { tagSlug, tagName, tagCount } = Astro.props;
 
 // Get i18n config
 const i18nConfig = virtualI18nConfig || defaultI18nConfig;
-const currentLocale = getLocaleFromPath(Astro.url.pathname, i18nConfig);
+const base = import.meta.env.BASE_URL;
+
+// Remove base URL from current path for locale detection
+const { removeBase } = await import('../../utils/i18n');
+const pathWithoutBase = removeBase(Astro.url.pathname, base);
+
+const currentLocale = getLocaleFromPath(pathWithoutBase, i18nConfig);
 const localeConfig = getLocaleConfig(currentLocale, i18nConfig);
 const ui = localeConfig.ui;
-const localePrefix = getLocalePrefix(currentLocale, i18nConfig);
+const localePrefix = getLocalePrefix(currentLocale, i18nConfig, base);
 
 // 获取所有文章并筛选包含该标签的文章
 const allPostsCollection = await getCollection('posts', ({ data }) => !data.draft);

package/src/pages/tags/index.astro

@@ -4,14 +4,19 @@ import PageLayout from '@jet-w/astro-blog/layouts/PageLayout.astro';
 import TagCloud from '@jet-w/astro-blog/components/blog/TagCloud.astro';
 import { i18nConfig as virtualI18nConfig } from 'virtual:astro-blog-i18n';
 import { defaultI18nConfig } from '../../config/i18n';
-import { getLocaleFromPath, getLocaleConfig, getLocalePrefix, filterPostsByLocale } from '../../utils/i18n';
+import { getLocaleFromPath, getLocaleConfig, getLocalePrefix, filterPostsByLocale, removeBase } from '../../utils/i18n';
 
 // Get i18n config
 const i18nConfig = virtualI18nConfig || defaultI18nConfig;
-const currentLocale = getLocaleFromPath(Astro.url.pathname, i18nConfig);
+const base = import.meta.env.BASE_URL;
+
+// Remove base URL from current path for locale detection
+const pathWithoutBase = removeBase(Astro.url.pathname, base);
+
+const currentLocale = getLocaleFromPath(pathWithoutBase, i18nConfig);
 const localeConfig = getLocaleConfig(currentLocale, i18nConfig);
 const ui = localeConfig.ui;
-const localePrefix = getLocalePrefix(currentLocale, i18nConfig);
+const localePrefix = getLocalePrefix(currentLocale, i18nConfig, base);
 
 // 从文章集合动态获取所有标签
 const allPostsCollection = await getCollection('posts', ({ data }) => !data.draft);

package/src/plugins/rehype-relative-links.mjs

@@ -1,10 +1,63 @@
 /**
- * Rehype 插件：修复 Markdown 中的相对链接
- * 将相对链接转换为正确的绝对路径
+ * Rehype 插件：修复 Markdown 中的相对链接和图片链接
+ * 将相对链接转换为正确的绝对路径，支持 base URL
+ * 同时处理绝对路径链接，添加 base URL 前缀
  */
 import { visit } from 'unist-util-visit';
 
+/**
+ * Helper function to check if a path is a relative link
+ * @param {string} path - The path to check
+ * @returns {boolean} - True if the path is relative
+ */
+function isRelativePath(path) {
+  return (
+    path.startsWith('./') ||
+    path.startsWith('../') ||
+    (!path.startsWith('/') &&
+     !path.startsWith('#') &&
+     !path.startsWith('http://') &&
+     !path.startsWith('https://') &&
+     !path.startsWith('mailto:') &&
+     !path.startsWith('data:'))
+  );
+}
+
+/**
+ * Helper function to check if a path is an internal absolute path
+ * (starts with / but not an external URL or special protocol)
+ * @param {string} path - The path to check
+ * @returns {boolean} - True if the path is an internal absolute path
+ */
+function isInternalAbsolutePath(path) {
+  return (
+    path.startsWith('/') &&
+    !path.startsWith('//') // Exclude protocol-relative URLs like //example.com
+  );
+}
+
+/**
+ * Helper function to normalize the base URL
+ * @param {string} base - The base URL
+ * @returns {string} - Normalized base URL (with leading slash, without trailing slash)
+ */
+function normalizeBase(base) {
+  if (!base || base === '/') return '';
+  // Ensure leading slash, remove trailing slash
+  let normalized = base.startsWith('/') ? base : `/${base}`;
+  normalized = normalized.endsWith('/') ? normalized.slice(0, -1) : normalized;
+  return normalized;
+}
+
+/**
+ * Rehype plugin to fix relative links in Markdown
+ * @param {Object} options - Plugin options
+ * @param {string} options.base - The base URL path (e.g., '/blog')
+ * @returns {Function} - The plugin function
+ */
 export function rehypeRelativeLinks(options = {}) {
+  const base = normalizeBase(options.base || process.env.BASE_PATH || '');
+
   return (tree, file) => {
     // 获取当前文件的路径信息
     const filePath = file.history[0] || '';
@@ -12,28 +65,51 @@ export function rehypeRelativeLinks(options = {}) {
     // 从文件路径中提取目录信息
     // 例如：/path/to/content/posts/blog_docs/README.md -> blog_docs
     const match = filePath.match(/content\/posts\/(.+?)\/[^/]+\.(md|mdx)$/i);
-    if (!match) return;
 
-    const dirPath = match[1]; // 例如：blog_docs 或 tech/subfolder
+    // dirPath 用于相对链接的解析
+    const dirPath = match ? match[1] : ''; // 例如：blog_docs 或 tech/subfolder
 
     visit(tree, 'element', (node) => {
+      // Handle anchor links
       if (node.tagName === 'a' && node.properties?.href) {
         const href = node.properties.href;
 
-        // 只处理相对链接（以 ./ 或不以 / # http 开头的链接）
-        if (href.startsWith('./') ||
-            (!href.startsWith('/') &&
-             !href.startsWith('#') &&
-             !href.startsWith('http://') &&
-             !href.startsWith('https://') &&
-             !href.startsWith('mailto:'))) {
-
+        if (isRelativePath(href) && dirPath) {
           // 移除 ./ 前缀
           const cleanHref = href.replace(/^\.\//, '');
 
-          // 构建新的绝对路径
-          const newHref = `/posts/${dirPath}/${cleanHref}`;
+          // 构建新的绝对路径（包含 base URL）
+          const newHref = `${base}/posts/${dirPath}/${cleanHref}`;
           node.properties.href = newHref;
+        } else if (isInternalAbsolutePath(href) && base) {
+          // 处理内部绝对路径：添加 base URL 前缀
+          // 例如：/posts/xxx -> /blog/posts/xxx
+          // 避免重复添加 base（如果已经包含）
+          if (!href.startsWith(base + '/') && href !== base) {
+            node.properties.href = base + href;
+          }
+        }
+      }
+
+      // Handle image links
+      if (node.tagName === 'img' && node.properties?.src) {
+        const src = node.properties.src;
+
+        if (isRelativePath(src) && dirPath) {
+          // 移除 ./ 前缀
+          const cleanSrc = src.replace(/^\.\//, '');
+
+          // 构建新的绝对路径（包含 base URL）
+          // 图片通常相对于当前文档，保持目录结构
+          const newSrc = `${base}/posts/${dirPath}/${cleanSrc}`;
+          node.properties.src = newSrc;
+        } else if (isInternalAbsolutePath(src) && base) {
+          // 处理内部绝对路径图片：添加 base URL 前缀
+          // 例如：/images/xxx.png -> /blog/images/xxx.png
+          // 避免重复添加 base（如果已经包含）
+          if (!src.startsWith(base + '/') && src !== base) {
+            node.properties.src = base + src;
+          }
         }
       }
     });

package/src/utils/i18n.ts

@@ -353,15 +353,38 @@ export function isMultiLanguageEnabled(
 /**
  * Get prefix for a locale in routes
  * Returns empty string for default locale if prefixDefaultLocale is false
+ * If base is provided, it will be prepended to the locale prefix
+ *
+ * @example
+ * // Without base
+ * getLocalePrefix('en', config) // '' (for default locale)
+ * getLocalePrefix('zh-CN', config) // '/zh-CN'
+ *
+ * // With base '/my-blog'
+ * getLocalePrefix('en', config, '/my-blog') // '/my-blog'
+ * getLocalePrefix('zh-CN', config, '/my-blog') // '/my-blog/zh-CN'
  */
 export function getLocalePrefix(
   locale: string,
-  config: I18nConfig = defaultI18nConfig
+  config: I18nConfig = defaultI18nConfig,
+  base?: string
 ): string {
-  if (locale === config.defaultLocale && !config.routing.prefixDefaultLocale) {
-    return '';
+  // Normalize base: remove trailing slash
+  const normalizedBase = base ? base.replace(/\/$/, '') : '';
+
+  // Get locale prefix
+  let localePrefix = '';
+  if (locale !== config.defaultLocale || config.routing.prefixDefaultLocale) {
+    localePrefix = `/${locale}`;
+  }
+
+  // If base is just '/' or empty, return locale prefix as before
+  if (!normalizedBase || normalizedBase === '') {
+    return localePrefix;
   }
-  return `/${locale}`;
+
+  // Combine base and locale prefix
+  return `${normalizedBase}${localePrefix}`;
 }
 
 /**
@@ -406,6 +429,62 @@ export function filterPostsByLocale<T extends { id: string }>(
   });
 }
 
+/**
+ * Add base URL prefix to a path
+ * This is used when the site is deployed to a subdirectory (e.g., /jet-w.astro-blog/)
+ *
+ * @example
+ * // If BASE_URL is '/jet-w.astro-blog'
+ * withBase('/posts') // '/jet-w.astro-blog/posts'
+ * withBase('/') // '/jet-w.astro-blog/'
+ *
+ * // If BASE_URL is '/'
+ * withBase('/posts') // '/posts'
+ */
+export function withBase(path: string, base?: string): string {
+  // Get base URL - in Astro components, pass import.meta.env.BASE_URL
+  // Remove trailing slash from base
+  const baseUrl = (base || '/').replace(/\/$/, '');
+
+  // If base is empty or just '/', return path as-is
+  if (!baseUrl || baseUrl === '') {
+    return path;
+  }
+
+  // Ensure path starts with /
+  const normalizedPath = path.startsWith('/') ? path : `/${path}`;
+
+  // If path is just '/', return base with trailing slash
+  if (normalizedPath === '/') {
+    return `${baseUrl}/`;
+  }
+
+  return `${baseUrl}${normalizedPath}`;
+}
+
+/**
+ * Remove base URL prefix from a path
+ * Useful for getting the actual path without base prefix
+ *
+ * @example
+ * // If BASE_URL is '/jet-w.astro-blog'
+ * removeBase('/jet-w.astro-blog/posts', '/jet-w.astro-blog') // '/posts'
+ */
+export function removeBase(path: string, base?: string): string {
+  const baseUrl = (base || '/').replace(/\/$/, '');
+
+  if (!baseUrl || baseUrl === '') {
+    return path;
+  }
+
+  if (path.startsWith(baseUrl)) {
+    const rest = path.slice(baseUrl.length);
+    return rest || '/';
+  }
+
+  return path;
+}
+
 // Re-export types and config functions
 export type { I18nConfig, Locale, LocaleConfig, UITranslations } from '../config/i18n';
 export {

package/templates/default/.claude/ralph-loop.local.md

@@ -1,48 +1,9 @@
 ---
-active: false
-iteration: 2
+active: true
+iteration: 1
 max_iterations: 20
 completion_promise: "DONE"
-started_at: "2026-01-29T01:25:08Z"
-completed_at: "2026-01-29T01:48:00Z"
+started_at: "2026-01-29T23:41:34Z"
 ---
 
-DONE
-
-## Issue Fixed
-
-The i18n URL routing and navigation link issue has been resolved.
-
-### Root Cause Analysis
-
-When English is set as the default locale with `prefixDefaultLocale: false`:
-- English pages use URLs without prefix: `/posts/...`
-- Chinese pages should use URLs with prefix: `/zh-CN/posts/...`
-
-However, the navigation menu and sidebar tree links in the zh-CN locale config were missing the `/zh-CN/` prefix, causing navigation links to point to the wrong locale.
-
-### Files Modified
-
-1. **`templates/default/src/config/locales/zh-CN/menu.ts`**
-   - Updated all menu links to include `/zh-CN/` prefix
-   - Changed `href: '/'` to `href: '/zh-CN/'`
-   - Changed `href: '/posts/...'` to `href: '/zh-CN/posts/...'`
-   - Changed `href: '/slides'` to `href: '/zh-CN/slides'`
-   - Changed `href: '/about'` to `href: '/zh-CN/about'`
-
-2. **`templates/default/src/config/locales/zh-CN/sidebar.ts`**
-   - Updated sidebar group titles to Chinese: '快速入门', '使用指南', '配置文档'
-   - Updated comments to Chinese
-
-3. **`src/components/layout/Sidebar.astro`**
-   - Fixed all tree links to use `${localePrefix}/posts/...` instead of hardcoded `/posts/...`
-   - This ensures sidebar tree navigation respects the current locale
-
-### URL Behavior (Correct)
-
-| Language | URL Pattern |
-|----------|-------------|
-| English (default) | `/posts/...`, `/slides`, `/about` |
-| Chinese | `/zh-CN/posts/...`, `/zh-CN/slides`, `/zh-CN/about` |
-
-This is the expected behavior with `prefixDefaultLocale: false`.
+When the base url was set up, the hyper link in markdown, such as [/xxx/fse](text) and image link cannot change accordingly, please help to check similar link at the same time. please help to fix it

package/templates/default/Makefile

@@ -0,0 +1,37 @@
+.PHONY: dev prod install clean help
+
+# Default target
+help:
+	@echo "Usage:"
+	@echo "  make dev   - Switch to development mode (uses local @jet-w/astro-blog)"
+	@echo "  make prod  - Switch to production mode (uses npm package @jet-w/astro-blog)"
+	@echo "  make install - Run npm install after switching modes"
+	@echo "  make clean - Remove node_modules and package-lock.json"
+
+# Switch to development mode (local package)
+dev:
+	@echo "Switching to development mode..."
+	@cp package.dev.json package.json
+	@echo "Done! Run 'make install' or 'npm install' to install dependencies."
+
+# Switch to production mode (npm package)
+prod:
+	@echo "Switching to production mode..."
+	@cp package.prod.json package.json
+	@echo "Done! Run 'make install' or 'npm install' to install dependencies."
+
+# Install dependencies
+install:
+	npm install
+
+# Clean node_modules and package-lock.json
+clean:
+	@echo "Cleaning..."
+	@rm -rf node_modules package-lock.json
+	@echo "Done!"
+
+# Switch to dev and install
+dev-install: dev install
+
+# Switch to prod and install
+prod-install: prod install

package/templates/default/astro.config.mjs

@@ -1,4 +1,5 @@
 import { defineConfig } from 'astro/config';
+import { loadEnv } from 'vite';
 import vue from '@astrojs/vue';
 import tailwind from '@astrojs/tailwind';
 import mdx from '@astrojs/mdx';
@@ -7,6 +8,9 @@ import remarkMath from 'remark-math';
 import rehypeKatex from 'rehype-katex';
 import rehypeRaw from 'rehype-raw';
 
+// Load environment variables from .env file
+const { SITE_URL, BASE_PATH } = loadEnv(process.env.NODE_ENV || 'production', process.cwd(), '');
+
 // Import plugins and integration from @jet-w/astro-blog
 import { astroBlog, defineI18nConfig } from '@jet-w/astro-blog';
 import { remarkProtectCode, rehypeRestoreCode } from '@jet-w/astro-blog/plugins/remark-protect-code.mjs';
@@ -59,7 +63,7 @@ export default defineConfig({
       rehypeKatex,
       rehypeCleanContainers,
       rehypeTabs,
-      rehypeRelativeLinks,
+      [rehypeRelativeLinks, { base: BASE_PATH || process.env.BASE_PATH || '/' }],
       rehypeRestoreCode,  // Must run LAST to restore ::: in code blocks
     ],
     shikiConfig: {
@@ -68,8 +72,8 @@ export default defineConfig({
       wrap: true
     }
   },
-  site: 'https://example.com',
-  base: '/',
+  site: SITE_URL || process.env.SITE_URL || 'https://example.com',
+  base: BASE_PATH || process.env.BASE_PATH || '/',
   build: {
     assets: 'assets'
   },

package/templates/default/{package.dev.json → package.prod.json}

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