@jet-w/astro-blog 0.2.3 → 0.2.5

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)。