@jet-w/astro-blog 0.2.3 → 0.2.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jet-w/astro-blog",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "A modern Astro blog theme with Vue and Tailwind CSS support",
   "type": "module",
   "exports": {

package/src/plugins/remark-containers.mjs

@@ -2,105 +2,223 @@ import { visit } from 'unist-util-visit';
 
 export function remarkContainers() {
   return (tree, file) => {
-    // Pre-process: Handle complete containers in a single paragraph
+    // Pre-process: Handle containers that span across multiple sibling nodes
     // This handles cases like:
-    // ::: tip
-    // Content without blank lines
+    // ::: tip Title
+    // Content text here
+    // - list item 1
+    // - list item 2
     // :::
-    // Where the entire thing is parsed as one paragraph with text "::: tip\nContent\n:::"
-    // Also handles paragraphs with mixed content (text + inline code, etc.)
-    visit(tree, 'paragraph', (node, index, parent) => {
-      if (!node.children || node.children.length === 0) return;
-
-      const firstChild = node.children[0];
-      const lastChild = node.children[node.children.length - 1];
+    // Where the container starts in one paragraph, has sibling nodes (lists, etc),
+    // and the closing ::: may be in a later text node
+    function processMultiNodeContainers(tree) {
+      visit(tree, 'paragraph', (node, index, parent) => {
+        if (!node.children || node.children.length === 0) return;
+        if (!parent || !parent.children) return;
 
-      // First child must be text starting with :::
-      if (firstChild.type !== 'text') return;
-      // Last child must be text ending with :::
-      if (lastChild.type !== 'text') return;
+        const firstChild = node.children[0];
+        if (firstChild.type !== 'text') return;
 
-      const firstText = firstChild.value;
-      const lastText = lastChild.value;
+        const firstText = firstChild.value;
+
+        // Check if first text starts with ::: type [title]
+        // Allow content to follow on subsequent lines within this paragraph
+        const startMatch = firstText.match(/^(:{3,})\s+(tip|note|warning|danger|info|details)([ \t]+[^\n]*)?\n?/);
+        if (!startMatch) return;
+
+        const [fullMatch, openColons, type, titlePart] = startMatch;
+        const colonCount = openColons.length;
+        const customTitle = titlePart ? titlePart.trim() : '';
+        const title = customTitle || getDefaultTitle(type);
+
+        // Now we need to find the closing ::: which could be:
+        // 1. At the end of this same paragraph's text
+        // 2. In a sibling paragraph
+        // 3. Inside a text node in a list item (no blank line before :::)
+
+        const siblings = parent.children;
+        let endIndex = -1;
+        let endNodeInfo = null; // { siblingIndex, childPath, closeMatch }
+
+        // First check if closing is in the same paragraph
+        const lastChild = node.children[node.children.length - 1];
+        if (lastChild.type === 'text') {
+          const closeInSame = lastChild.value.match(/\n(:{3,})\s*$/);
+          if (closeInSame && closeInSame[1].length === colonCount) {
+            // Closing is in the same paragraph - handle as single paragraph container
+            endNodeInfo = { type: 'same-paragraph', closeMatch: closeInSame };
+          }
+        }
 
-      // Check if first text starts with ::: type
-      const startMatch = firstText.match(/^(:{3,})\s+(tip|note|warning|danger|info|details)([ \t]+[^\n]*)?\n?/);
-      if (!startMatch) return;
+        if (!endNodeInfo) {
+          // Search through siblings for the closing :::
+          for (let i = index + 1; i < siblings.length; i++) {
+            const sibling = siblings[i];
 
-      // Check if last text ends with :::
-      const endMatch = lastText.match(/\n(:{3,})\s*$/);
-      if (!endMatch) return;
+            // Check if sibling is a paragraph with just :::
+            if (sibling.type === 'paragraph' &&
+                sibling.children &&
+                sibling.children.length === 1 &&
+                sibling.children[0].type === 'text') {
+              const text = sibling.children[0].value.trim();
+              const closeMatch = text.match(/^(:{3,})$/);
+              if (closeMatch && closeMatch[1].length === colonCount) {
+                endIndex = i;
+                endNodeInfo = { type: 'sibling-paragraph', siblingIndex: i };
+                break;
+              }
+            }
 
-      // Verify the closing colons match the opening
-      const [, openColons, type, titlePart] = startMatch;
-      const [, closeColons] = endMatch;
-      if (openColons.length !== closeColons.length) return;
+            // Check if closing ::: is embedded in a text node (e.g., after a list item)
+            // This happens when there's no blank line before :::
+            if (sibling.type === 'list' && sibling.children) {
+              // Check the last item of the list
+              const lastItem = sibling.children[sibling.children.length - 1];
+              if (lastItem.children) {
+                const lastItemPara = lastItem.children[lastItem.children.length - 1];
+                if (lastItemPara.type === 'paragraph' && lastItemPara.children) {
+                  const lastText = lastItemPara.children[lastItemPara.children.length - 1];
+                  if (lastText.type === 'text') {
+                    const closeMatch = lastText.value.match(/\n(:{3,})\s*$/);
+                    if (closeMatch && closeMatch[1].length === colonCount) {
+                      endIndex = i;
+                      endNodeInfo = {
+                        type: 'in-list',
+                        siblingIndex: i,
+                        lastText: lastText,
+                        closeMatch: closeMatch
+                      };
+                      break;
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
 
-      const customTitle = titlePart ? titlePart.trim() : '';
-      const title = customTitle || getDefaultTitle(type);
+        if (!endNodeInfo) return; // No closing found
 
-      // Create HTML wrapper
-      let openingHTML, closingHTML;
-      if (type === 'details') {
-        openingHTML = `<details class="container-details custom-container" data-container-type="details">
+        // Create HTML wrapper
+        let openingHTML, closingHTML;
+        if (type === 'details') {
+          openingHTML = `<details class="container-details custom-container" data-container-type="details">
 <summary class="container-title">${title}</summary>
 <div class="container-content">`;
-        closingHTML = `</div>
+          closingHTML = `</div>
 </details>`;
-      } else {
-        openingHTML = `<div class="container-${type} custom-container" data-container-type="${type}">
+        } else {
+          openingHTML = `<div class="container-${type} custom-container" data-container-type="${type}">
 <div class="container-title">${title}</div>
 <div class="container-content">`;
-        closingHTML = `</div>
+          closingHTML = `</div>
 </div>`;
-      }
+        }
 
-      // Extract content by modifying the first and last text nodes
-      // Remove the ::: opening from first text
-      const newFirstText = firstText.slice(startMatch[0].length);
-      // Remove the ::: closing from last text
-      const newLastText = lastText.slice(0, endMatch.index);
+        const htmlStartNode = { type: 'html', value: openingHTML };
+        const htmlEndNode = { type: 'html', value: closingHTML };
+
+        if (endNodeInfo.type === 'same-paragraph') {
+          // Handle single paragraph container
+          const lastChild = node.children[node.children.length - 1];
+          const newFirstText = firstText.slice(fullMatch.length);
+          const newLastText = lastChild.value.slice(0, endNodeInfo.closeMatch.index);
+
+          const contentChildren = [];
+          for (let i = 0; i < node.children.length; i++) {
+            const child = node.children[i];
+            if (i === 0) {
+              if (node.children.length === 1) {
+                // Single text node
+                const middleText = newFirstText.slice(0, newFirstText.length - (firstText.length - lastChild.value.length) - endNodeInfo.closeMatch[0].length);
+                if (middleText.trim()) {
+                  contentChildren.push({ ...child, value: middleText.trim() });
+                }
+              } else if (newFirstText.trim()) {
+                contentChildren.push({ ...child, value: newFirstText });
+              }
+            } else if (i === node.children.length - 1) {
+              if (newLastText.trim()) {
+                contentChildren.push({ ...child, value: newLastText });
+              }
+            } else {
+              contentChildren.push({ ...child });
+            }
+          }
 
-      // Build new content children
-      const contentChildren = [];
-      for (let i = 0; i < node.children.length; i++) {
-        const child = node.children[i];
-        if (i === 0) {
-          // First child - use trimmed text
-          if (node.children.length === 1) {
-            // Single text node - extract middle content
-            const middleText = newFirstText.slice(0, newFirstText.length - (firstText.length - lastText.length) - endMatch[0].length);
-            if (middleText.trim()) {
-              contentChildren.push({ ...child, value: middleText.trim() });
+          if (contentChildren.length === 0) return;
+
+          const contentParagraph = { type: 'paragraph', children: contentChildren };
+          parent.children.splice(index, 1, htmlStartNode, contentParagraph, htmlEndNode);
+          return index + 3;
+
+        } else if (endNodeInfo.type === 'sibling-paragraph') {
+          // Closing is in a sibling paragraph
+          // Extract content from opening paragraph (after the ::: line)
+          const newFirstText = firstText.slice(fullMatch.length);
+          const contentNodes = [];
+
+          // Add remaining content from opening paragraph if any
+          if (newFirstText.trim() || node.children.length > 1) {
+            const newParaChildren = [];
+            if (newFirstText.trim()) {
+              newParaChildren.push({ ...firstChild, value: newFirstText });
+            }
+            for (let i = 1; i < node.children.length; i++) {
+              newParaChildren.push({ ...node.children[i] });
+            }
+            if (newParaChildren.length > 0) {
+              contentNodes.push({ type: 'paragraph', children: newParaChildren });
             }
-          } else if (newFirstText.trim()) {
-            contentChildren.push({ ...child, value: newFirstText });
           }
-        } else if (i === node.children.length - 1) {
-          // Last child - use trimmed text
-          if (newLastText.trim()) {
-            contentChildren.push({ ...child, value: newLastText });
+
+          // Add all siblings between opening and closing
+          for (let i = index + 1; i < endIndex; i++) {
+            contentNodes.push(siblings[i]);
           }
-        } else {
-          // Middle children - keep as-is
-          contentChildren.push({ ...child });
-        }
-      }
 
-      // If no content, skip
-      if (contentChildren.length === 0) return;
+          const replaceCount = endIndex - index + 1;
+          const newNodes = [htmlStartNode, ...contentNodes, htmlEndNode];
+          parent.children.splice(index, replaceCount, ...newNodes);
+          return index + newNodes.length;
 
-      // Replace with HTML nodes and content paragraph
-      const htmlStartNode = { type: 'html', value: openingHTML };
-      const contentParagraph = {
-        type: 'paragraph',
-        children: contentChildren
-      };
-      const htmlEndNode = { type: 'html', value: closingHTML };
+        } else if (endNodeInfo.type === 'in-list') {
+          // Closing ::: is inside the last list item
+          // Remove the closing from the text node
+          endNodeInfo.lastText.value = endNodeInfo.lastText.value.slice(0, endNodeInfo.closeMatch.index);
 
-      parent.children.splice(index, 1, htmlStartNode, contentParagraph, htmlEndNode);
-      return index + 3;
-    });
+          // Extract content from opening paragraph
+          const newFirstText = firstText.slice(fullMatch.length);
+          const contentNodes = [];
+
+          if (newFirstText.trim() || node.children.length > 1) {
+            const newParaChildren = [];
+            if (newFirstText.trim()) {
+              newParaChildren.push({ ...firstChild, value: newFirstText });
+            }
+            for (let i = 1; i < node.children.length; i++) {
+              newParaChildren.push({ ...node.children[i] });
+            }
+            if (newParaChildren.length > 0) {
+              contentNodes.push({ type: 'paragraph', children: newParaChildren });
+            }
+          }
+
+          // Add all siblings including the list (which now has the ::: removed)
+          for (let i = index + 1; i <= endIndex; i++) {
+            contentNodes.push(siblings[i]);
+          }
+
+          const replaceCount = endIndex - index + 1;
+          const newNodes = [htmlStartNode, ...contentNodes, htmlEndNode];
+          parent.children.splice(index, replaceCount, ...newNodes);
+          return index + newNodes.length;
+        }
+      });
+    }
+
+    // Run the multi-node container processor
+    processMultiNodeContainers(tree);
 
     // Pre-process: Extract ::: from text nodes where it appears at the end
     // This handles cases where ::: is on a new line but without a blank line separator
@@ -355,11 +473,35 @@ export function remarkContainers() {
         console.log('DEBUG containerDirective:', type, 'children:', node.children?.length || 0, JSON.stringify(node.children?.map(c => c.type)));
       }
 
-      // Get custom title from directive label (text after ::: type on same line)
+      // Get custom title from directive label
+      // remark-directive v4 may store label in different places:
+      // 1. node.data.directiveLabel (standard location)
+      // 2. node.children[0] as a paragraph with the label text
       let customTitle = '';
+      let contentChildren = node.children || [];
+
+      // Check node.data.directiveLabel first (standard remark-directive behavior)
       if (node.data && node.data.directiveLabel) {
         customTitle = node.data.directiveLabel;
       }
+      // Check if first child is a paragraph that contains just the title text
+      // This happens when label is on same line: ::: warning Title Here
+      else if (contentChildren.length > 0) {
+        const firstChild = contentChildren[0];
+        // If first child is paragraph with single text node, it might be the title
+        if (firstChild.type === 'paragraph' &&
+            firstChild.children &&
+            firstChild.children.length === 1 &&
+            firstChild.children[0].type === 'text') {
+          const text = firstChild.children[0].value.trim();
+          // Check if this looks like a title (single line, no markdown formatting)
+          // and the directive has more children (actual content)
+          if (!text.includes('\n') && contentChildren.length > 1) {
+            customTitle = text;
+            contentChildren = contentChildren.slice(1); // Remove title from content
+          }
+        }
+      }
 
       const title = customTitle || getDefaultTitle(type);
 
@@ -382,7 +524,7 @@ export function remarkContainers() {
       const htmlStartNode = { type: 'html', value: openingHTML };
       const htmlEndNode = { type: 'html', value: closingHTML };
 
-      const newNodes = [htmlStartNode, ...node.children, htmlEndNode];
+      const newNodes = [htmlStartNode, ...contentChildren, htmlEndNode];
       parent.children.splice(index, 1, ...newNodes);
 
       return index + newNodes.length;
@@ -395,10 +537,24 @@ export function remarkContainers() {
         return;
       }
 
+      // Get custom title from directive label
       let customTitle = '';
+      let contentChildren = node.children || [];
+
       if (node.data && node.data.directiveLabel) {
         customTitle = node.data.directiveLabel;
       }
+      // Check if first child is a text node that could be the title
+      else if (contentChildren.length > 0) {
+        const firstChild = contentChildren[0];
+        if (firstChild.type === 'text') {
+          const text = firstChild.value.trim();
+          if (!text.includes('\n') && contentChildren.length > 1) {
+            customTitle = text;
+            contentChildren = contentChildren.slice(1);
+          }
+        }
+      }
 
       const title = customTitle || getDefaultTitle(type);
 
@@ -421,7 +577,7 @@ export function remarkContainers() {
       const htmlStartNode = { type: 'html', value: openingHTML };
       const htmlEndNode = { type: 'html', value: closingHTML };
 
-      const newNodes = [htmlStartNode, ...node.children, htmlEndNode];
+      const newNodes = [htmlStartNode, ...contentChildren, htmlEndNode];
       parent.children.splice(index, 1, ...newNodes);
 
       return index + newNodes.length;

package/templates/default/content/posts/blog_docs_en/01.get-started/03-create-post.md

@@ -1,6 +1,6 @@
 ---
-title: Create Your First Post
-description: Write and publish your first blog article
+title: Create Blog & First Post
+description: Use CLI to create a blog project and write your first article
 pubDate: 2025-01-01
 author: jet-w
 categories:
@@ -8,13 +8,114 @@ categories:
 tags:
   - Getting Started
   - Writing
+  - CLI
 ---
 
-# Create Your First Post
+# Create Blog & First Post
 
-Let's write your first blog post! This is where the fun begins.
+This guide will walk you through creating a blog project using the CLI tool and writing your first post.
 
-## Where Posts Live
+## Create a Blog Project with CLI
+
+### Quick Start
+
+Use `@jet-w/astro-blog-cli` to quickly create a new blog project:
+
+```bash
+npx @jet-w/astro-blog-cli my-blog
+```
+
+### Interactive Mode
+
+Run without options to enter interactive mode, which guides you through the configuration:
+
+```bash
+npx @jet-w/astro-blog-cli
+```
+
+You will be prompted for:
+- Project name
+- Blog title (English & Chinese)
+- Blog description (English & Chinese)
+- Author name
+- Author email
+- Site URL
+- Template selection
+
+### Non-Interactive Mode
+
+Use `-y` flag to skip prompts and use defaults or provided options:
+
+```bash
+# Quick create with defaults
+npx @jet-w/astro-blog-cli my-blog -y
+
+# With custom options
+npx @jet-w/astro-blog-cli my-blog -y \
+  --title "My Awesome Blog" \
+  --title-zh "我的博客" \
+  --description "A blog about tech" \
+  --description-zh "一个关于技术的博客" \
+  --author "John Doe" \
+  --email "john@example.com" \
+  --site "https://myblog.com"
+```
+
+### CLI Command Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `-t, --template <template>` | Template to use | `default` |
+| `--title <title>` | Blog title (English) | `My Astro Blog` |
+| `--title-zh <titleZh>` | Blog title (Chinese) | `我的Astro博客` |
+| `--description <description>` | Blog description (English) | - |
+| `--description-zh <descriptionZh>` | Blog description (Chinese) | - |
+| `--author <author>` | Author name | `Author` |
+| `--email <email>` | Author email | `email@example.com` |
+| `--site <site>` | Site URL | `https://example.com` |
+| `--lang <lang>` | CLI language (`en`/`zh`) | Auto-detect |
+| `-y, --yes` | Skip prompts, use defaults | - |
+| `-f, --force` | Overwrite existing directory | - |
+
+### Start Development Server
+
+After project creation:
+
+```bash
+cd my-blog
+npm install
+npm run dev
+```
+
+Your blog will be running at `http://localhost:4321`.
+
+### Project Structure
+
+The created project includes:
+
+```
+my-blog/
+├── astro.config.mjs        # Astro configuration
+├── package.json
+├── src/
+│   ├── config/
+│   │   ├── site.ts         # Main site configuration
+│   │   └── locales/        # i18n configurations
+│   │       ├── en/         # English locale
+│   │       └── zh-CN/      # Chinese locale
+│   └── content.config.ts   # Content collections schema
+├── content/
+│   ├── posts/              # Blog posts (Markdown/MDX)
+│   ├── pages/              # Static pages
+│   └── slides/             # Presentation slides
+└── public/                 # Static assets
+```
+
+## Create Your First Post
+
+Now let's write your first blog post!
+
+### Where Posts Live
 
 All blog posts go in the `content/posts/` directory:
 
@@ -27,7 +128,7 @@ content/
         └── tutorial.md
 ```
 
-## Create a New Post
+### Create a New Post
 
 Create a file called `hello-world.md` in `content/posts/`:
 
@@ -68,7 +169,7 @@ Stay tuned for more posts about:
 Thanks for reading!
 ```
 
-## View Your Post
+### View Your Post
 
 Save the file and visit:
 
@@ -98,6 +199,7 @@ star: false                # true = featured post
 ```
 
 ::: tip Required vs Optional
+
 Only `title` is required. All other fields are optional but recommended for better organization and SEO.
 :::
 
@@ -171,6 +273,20 @@ Then use:
 ![Cover](/images/posts/hello-world/cover.jpg)
 ```
 
+## Blog Features Overview
+
+Blogs created with this theme support the following features:
+
+- **Multi-language support (i18n)**: Switch between English and Chinese
+- **Markdown & MDX**: Powerful content authoring capabilities
+- **Code syntax highlighting**: Built-in syntax highlighting support
+- **Mermaid diagrams**: Flowcharts, sequence diagrams, and more
+- **LaTeX math equations**: Math formula rendering support
+- **Custom containers**: tip, warning, danger, and other callout blocks
+- **RSS feed**: Auto-generated RSS feed
+- **Tailwind CSS**: Modern styling support
+- **Vue.js components**: Use Vue components in MDX
+
 ---
 
-Congratulations on your first post! Next, let's understand the [project structure](./04-structure).
+Congratulations on creating your blog and publishing your first post! Next, let's understand the [project structure](./04-structure).

package/templates/default/content/posts/blog_docs_zh/01.get-started/03-create-post.md

@@ -1,6 +1,6 @@
 ---
-title: 创建第一篇文章
-description: 编写并发布你的第一篇博客文章
+title: 创建博客与文章
+description: 使用 CLI 创建博客项目并编写你的第一篇文章
 pubDate: 2025-01-01
 author: jet-w
 categories:
@@ -8,13 +8,114 @@ categories:
 tags:
   - 入门
   - 写作
+  - CLI
 ---
 
-# 创建第一篇文章
+# 创建博客与文章
 
-让我们来写你的第一篇博客文章！这才是真正有趣的开始。
+本文将指导你使用 CLI 工具快速创建博客项目，并编写发布你的第一篇文章。
 
-## 文章存放位置
+## 使用 CLI 创建博客项目
+
+### 快速开始
+
+使用 `@jet-w/astro-blog-cli` 可以快速创建一个新的博客项目：
+
+```bash
+npx @jet-w/astro-blog-cli my-blog
+```
+
+### 交互模式
+
+不带参数运行命令进入交互模式，系统会逐步引导你配置：
+
+```bash
+npx @jet-w/astro-blog-cli
+```
+
+你将被提示输入：
+- 项目名称
+- 博客标题（中英文）
+- 博客描述（中英文）
+- 作者名称
+- 作者邮箱
+- 网站 URL
+- 模板选择
+
+### 非交互模式
+
+使用 `-y` 参数跳过提示，直接使用默认值或指定的选项：
+
+```bash
+# 使用默认配置快速创建
+npx @jet-w/astro-blog-cli my-blog -y
+
+# 指定自定义选项
+npx @jet-w/astro-blog-cli my-blog -y \
+  --title "我的技术博客" \
+  --title-zh "我的技术博客" \
+  --description "A blog about tech" \
+  --description-zh "一个关于技术的博客" \
+  --author "张三" \
+  --email "zhangsan@example.com" \
+  --site "https://myblog.com"
+```
+
+### CLI 命令选项
+
+| 选项 | 描述 | 默认值 |
+|------|------|--------|
+| `-t, --template <template>` | 使用的模板 | `default` |
+| `--title <title>` | 博客标题（英文） | `My Astro Blog` |
+| `--title-zh <titleZh>` | 博客标题（中文） | `我的Astro博客` |
+| `--description <description>` | 博客描述（英文） | - |
+| `--description-zh <descriptionZh>` | 博客描述（中文） | - |
+| `--author <author>` | 作者名称 | `Author` |
+| `--email <email>` | 作者邮箱 | `email@example.com` |
+| `--site <site>` | 网站 URL | `https://example.com` |
+| `--lang <lang>` | CLI 语言（`en`/`zh`） | 自动检测 |
+| `-y, --yes` | 跳过提示，使用默认值 | - |
+| `-f, --force` | 覆盖已存在的目录 | - |
+
+### 启动开发服务器
+
+项目创建完成后：
+
+```bash
+cd my-blog
+npm install
+npm run dev
+```
+
+博客将在 `http://localhost:4321` 运行。
+
+### 项目结构
+
+创建的项目包含以下结构：
+
+```
+my-blog/
+├── astro.config.mjs        # Astro 配置文件
+├── package.json
+├── src/
+│   ├── config/
+│   │   ├── site.ts         # 网站主配置
+│   │   └── locales/        # i18n 配置
+│   │       ├── en/         # 英文语言包
+│   │       └── zh-CN/      # 中文语言包
+│   └── content.config.ts   # 内容集合配置
+├── content/
+│   ├── posts/              # 博客文章（Markdown/MDX）
+│   ├── pages/              # 静态页面
+│   └── slides/             # 演示幻灯片
+└── public/                 # 静态资源
+```
+
+## 创建第一篇文章
+
+现在让我们来写你的第一篇博客文章！
+
+### 文章存放位置
 
 所有博客文章都放在 `content/posts/` 目录：
 
@@ -27,7 +128,7 @@ content/
         └── tutorial.md
 ```
 
-## 创建新文章
+### 创建新文章
 
 在 `content/posts/` 中创建一个名为 `hello-world.md` 的文件：
 
@@ -68,7 +169,7 @@ categories:
 感谢阅读！
 ```
 
-## 查看你的文章
+### 查看你的文章
 
 保存文件后访问：
 
@@ -101,7 +202,7 @@ star: false                # true = 精选文章
 只有 `title` 是必填的。其他字段都是可选的，但建议填写以便更好地组织和优化 SEO。
 :::
 
-## 使用子目录
+## 使用子目录组织文章
 
 使用子目录来组织相关文章：
 
@@ -171,6 +272,20 @@ public/
 ![封面](/images/posts/hello-world/cover.jpg)
 ```
 
+## 博客特性一览
+
+使用本主题创建的博客支持以下特性：
+
+- **多语言支持（i18n）**：中英文双语切换
+- **Markdown & MDX**：强大的内容编写能力
+- **代码高亮**：内置语法高亮支持
+- **Mermaid 图表**：流程图、时序图等
+- **LaTeX 数学公式**：支持数学公式渲染
+- **自定义容器**：tip、warning、danger 等提示块
+- **RSS 订阅**：自动生成 RSS feed
+- **Tailwind CSS**：现代化的样式支持
+- **Vue.js 组件**：可在 MDX 中使用 Vue 组件
+
 ---
 
-恭喜你发布了第一篇文章！接下来，让我们了解 [项目结构](./04-structure)。
+恭喜你创建了博客并发布了第一篇文章！接下来，让我们了解 [项目结构](./04-structure)。

package/templates/default/package-lock.json

@@ -12,7 +12,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",
@@ -29,7 +29,7 @@
     },
     "../..": {
       "name": "@jet-w/astro-blog",
-      "version": "0.1.6",
+      "version": "0.2.3",
       "license": "MIT",
       "dependencies": {
         "@tailwindcss/typography": "^0.5.15",