@jet-w/astro-blog 0.2.0 → 0.2.1

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/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/content/posts/blog_docs/01-quick-start.md

@@ -1,162 +0,0 @@
----
-title: 快速开始
-description: 5分钟创建你的第一篇博客文章
-pubDate: 2025-12-11
-author: Astro Blog
-categories:
-  - 博客教程
-tags:
-  - 入门
-  - 教程
----
-
-# 快速开始
-
-本章将带你快速上手博客系统，从安装到发布第一篇文章。
-
-## 环境准备
-
-确保已安装以下工具：
-
-- **Node.js** 18.x 或更高版本
-- **npm** 或 **pnpm** 包管理器
-
-```bash
-# 检查 Node.js 版本
-node --version
-
-# 检查 npm 版本
-npm --version
-```
-
-## 安装与运行
-
-```bash
-# 安装依赖
-npm install
-
-# 启动开发服务器
-npm run dev
-```
-
-开发服务器启动后，访问 `http://localhost:4321` 即可预览博客。
-
-::: tip 热更新
-开发模式下修改文件会自动刷新页面，无需手动重启服务器。
-:::
-
-## 目录结构
-
-```
-content/posts/
-├── blog_docs/          # 博客文档
-├── tech/               # 技术文章
-│   ├── README.md       # 目录首页
-│   └── article.md      # 具体文章
-└── my-first-post.md    # 根目录文章
-```
-
-::: note 目录组织
-- 相关主题文章放在同一目录
-- 每个目录可添加 `README.md` 作为首页
-- 访问目录路径会自动展示 README 内容
-:::
-
-## 创建第一篇文章
-
-在 `content/posts/` 目录下创建 `hello-world.md`：
-
-```markdown
----
-title: Hello World
-description: 我的第一篇博客文章
-pubDate: 2025-01-01
-author: 你的名字
-tags:
-  - 入门
-categories:
-  - 随笔
----
-
-# Hello World
-
-欢迎来到我的博客！
-
-## 为什么开始写博客
-
-写博客可以帮助我：
-
-1. 整理和巩固知识
-2. 分享经验和见解
-3. 记录成长过程
-
-> 千里之行，始于足下。
-```
-
-保存后，访问 `http://localhost:4321/posts/hello-world` 即可查看。
-
-## Frontmatter 基础
-
-文章开头 `---` 之间的部分是 Frontmatter（元数据）：
-
-```yaml
----
-title: 文章标题          # 必填
-description: 文章描述    # 推荐，用于 SEO 和列表展示
-pubDate: 2025-01-01     # 推荐，发布日期
-author: 作者名           # 可选
-tags:                   # 可选，标签列表
-  - 标签1
-  - 标签2
-categories:             # 可选，分类列表
-  - 分类名
-draft: false            # 可选，草稿状态
-star: false             # 可选，星标/置顶
----
-```
-
-::: info 日期字段
-支持 `pubDate` 和 `date` 两种写法，系统会自动识别。
-:::
-
-## 添加图片
-
-将图片放入 `public/images/` 目录，然后在文章中引用：
-
-```markdown
-![图片描述](/images/my-image.png)
-```
-
-## 构建部署
-
-```bash
-# 构建生产版本
-npm run build
-
-# 本地预览构建结果
-npm run preview
-```
-
-构建产物在 `dist/` 目录，可部署到任何静态托管服务。
-
-## 常见问题
-
-### 文章不显示？
-
-检查以下几点：
-
-1. Frontmatter 格式正确（`---` 标记完整）
-2. `title` 字段存在且非空
-3. `draft` 不是 `true`
-
-### URL 路径规则
-
-- 文件路径决定 URL：`content/posts/tech/intro.md` → `/posts/tech/intro`
-- 路径自动转小写
-- `README.md` 对应目录路径：`content/posts/tech/README.md` → `/posts/tech`
-
-## 下一步
-
-- [Frontmatter 配置](./02-frontmatter) - 了解所有配置项
-- [Markdown 基础](./03-markdown-basic) - 复习 Markdown 语法
-- [容器语法](./04-containers) - 使用提示框等组件

package/templates/default/content/posts/blog_docs/02-frontmatter.md

@@ -1,277 +0,0 @@
----
-title: Frontmatter 配置
-description: 文章元数据配置完整指南
-pubDate: 2025-12-11
-author: Astro Blog
-categories:
-  - 博客教程
-tags:
-  - 配置
-  - Frontmatter
----
-
-# Frontmatter 配置
-
-Frontmatter 是文章开头 `---` 之间的 YAML 格式元数据，用于定义文章的标题、日期、标签等信息。
-
-## 完整字段列表
-
-```yaml
----
-# 基础字段（必填/推荐）
-title: 文章标题              # 必填
-description: 文章描述         # 推荐，用于 SEO 和列表展示
-pubDate: 2025-01-01          # 推荐，发布日期
-
-# 分类与标签
-tags:                        # 可选，标签列表
-  - 标签1
-  - 标签2
-categories:                  # 可选，分类列表
-  - 分类名
-
-# 作者与来源
-author: 作者名               # 可选，默认使用站点配置
-
-# 显示控制
-image: /images/cover.jpg     # 可选，封面图片
-icon: ri:article-line        # 可选，侧边栏图标
-draft: false                 # 可选，草稿不会发布
-star: false                  # 可选，星标/推荐文章
-index: true                  # 可选，是否加入索引
-
-# 时间相关
-updatedDate: 2025-01-02      # 可选，最后更新日期
----
-```
-
-## 字段详解
-
-### title（标题）
-
-**必填字段**，显示在页面、列表和 SEO 中。
-
-```yaml
-title: 深入理解 JavaScript 闭包
-```
-
-::: warning 特殊字符
-标题包含冒号、引号等特殊字符时，需用引号包裹：
-```yaml
-title: "Vue 3: 新特性详解"
-```
-:::
-
-### description（描述）
-
-用于 SEO 和文章列表展示，建议 50-160 字符。
-
-```yaml
-description: 本文详细介绍 JavaScript 闭包的概念、原理和实际应用
-```
-
-### pubDate / date（发布日期）
-
-系统同时支持 `pubDate` 和 `date` 两种写法：
-
-```yaml
-pubDate: 2025-01-01
-# 或
-date: 2025-01-01
-```
-
-支持的格式：
-
-```yaml
-pubDate: 2025-01-01              # 仅日期
-pubDate: 2025-01-01T10:30:00     # ISO 格式
-pubDate: 2025-01-01 10:30        # 简写格式
-```
-
-### tags（标签）
-
-用于文章分类和标签云展示：
-
-```yaml
-tags:
-  - JavaScript
-  - 前端
-  - 教程
-```
-
-也支持行内数组格式：
-
-```yaml
-tags: [JavaScript, 前端, 教程]
-```
-
-::: tip 标签建议
-- 3-5 个标签为宜
-- 使用有意义的关键词
-- 同类文章使用统一标签
-:::
-
-### categories（分类）
-
-宏观的内容分类，与标签不同：
-
-```yaml
-categories:
-  - 技术教程
-```
-
-系统同时支持 `categories` 和 `category` 两种写法，也支持单个字符串：
-
-```yaml
-category: 技术教程
-# 等同于
-categories:
-  - 技术教程
-```
-
-### author（作者）
-
-文章作者，不填则使用站点配置中的默认作者：
-
-```yaml
-author: 张三
-```
-
-### image（封面图）
-
-文章封面图片，用于列表展示和社交分享：
-
-```yaml
-image: /images/posts/my-cover.jpg
-```
-
-图片放置于 `public/images/` 目录。
-
-### icon（图标）
-
-侧边栏和列表中显示的图标，支持多种格式：
-
-```yaml
-icon: ri:vue-line              # Remix Icon
-icon: fa:code                  # Font Awesome
-icon: bi:terminal              # Bootstrap Icons
-```
-
-详见 [图标系统](./09-icons)。
-
-### draft（草稿）
-
-设为 `true` 时文章不会发布：
-
-```yaml
-draft: true
-```
-
-草稿文章：
-- 不在列表中显示
-- 不会构建到生产环境
-- 开发环境可通过 URL 直接访问预览
-
-### star（星标）
-
-标记推荐文章：
-
-```yaml
-star: true
-```
-
-星标文章可用于首页精选展示。
-
-### updatedDate（更新日期）
-
-文章最后更新时间，显示在文章底部：
-
-```yaml
-updatedDate: 2025-01-15
-```
-
-## 实际示例
-
-### 技术教程
-
-```yaml
----
-title: Vue 3 组合式 API 指南
-description: 全面掌握 Vue 3 Composition API
-pubDate: 2025-01-01
-updatedDate: 2025-01-10
-author: 张三
-tags:
-  - Vue
-  - Vue 3
-  - 前端
-categories:
-  - 技术教程
-image: /images/vue3-guide.jpg
----
-```
-
-### 系列文章首页
-
-```yaml
----
-title: TypeScript 入门教程
-description: 从零开始学习 TypeScript
-pubDate: 2025-01-01
-categories:
-  - 教程系列
-star: true
----
-```
-
-### 草稿文章
-
-```yaml
----
-title: 正在撰写的文章
-pubDate: 2025-01-01
-draft: true
----
-```
-
-## 常见问题
-
-### YAML 解析错误
-
-```yaml
-# 错误：冒号后需要空格
-title:标题
-
-# 正确
-title: 标题
-```
-
-### 日期格式问题
-
-```yaml
-# 错误
-date: 12-01-2025       # 格式不对
-date: 2025/01/01       # 斜杠不支持
-
-# 正确
-date: 2025-01-01       # YYYY-MM-DD
-```
-
-### 列表格式问题
-
-```yaml
-# 错误
-tags: JavaScript, Vue  # 逗号分隔不行
-
-# 正确
-tags:
-  - JavaScript
-  - Vue
-# 或
-tags: [JavaScript, Vue]
-```
-
-## 下一步
-
-- [Markdown 基础](./03-markdown-basic) - 学习文章内容写作
-- [图标系统](./09-icons) - 了解 icon 字段的使用