# md-bolg

**Repository Path**: wengxh/md-bolg

## Basic Information

- **Project Name**: md-bolg
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-13
- **Last Updated**: 2025-08-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 有追求的开发者 · 博客

基于 Vue 3 + TypeScript + Vite + Element Plus 的个人博客。文章来源于仓库内 `articles/*.md`，内置可视化统计、目录/进度条、摘要与阅读时长、相关推荐、代码复制/折叠、RSS 与站点地图等。

## 功能
- 首页：标签饼图、月度文章折线图（浅色主题）
- 列表：摘要、预计阅读时长、标签筛选（写入 URL 可分享）
- 文章页：目录（H2/H3）、阅读进度条、预计阅读时长、相关推荐、复制链接、代码复制与长代码折叠
- 页面：关于我、我的作品、常用工具
- 资源：RSS、Sitemap、Robots 一键生成

## 技术栈
- Vue 3 + Vite 5 + TypeScript
- Pinia、Vue Router、Element Plus、ECharts

## 目录结构
```
ai-blog/
  articles/
  public/
  scripts/
    generate-feeds.mjs
  src/
    components/
    views/
    stores/
    router/
  index.html
  package.json
  vite.config.ts
```

## 本地开发
- Node.js ≥ 18
```bash
npm i
npm run dev
# 构建与预览
npm run build
npm run preview
```

## 写作（Frontmatter 可选）
将 Markdown 放入 `articles/`，可添加 YAML frontmatter：
```markdown
---
title: 你的标题
date: 2024-03-15
tags: [Vue, Vite]
cover: /path/to/cover.png
---

# 你的标题
正文内容...
```
系统会自动生成摘要（约 120 字）与预计阅读时长。

## RSS / Sitemap 生成
生成 `public/rss.xml`、`public/sitemap.xml`、`public/robots.txt`：
```bash
SITE_URL=https://yourdomain.com \
SITE_TITLE="你的博客名" \
SITE_DESC="你的博客描述" \
npm run feeds
```
未设置时默认：`SITE_URL=https://example.com`，`SITE_TITLE=有追求的开发者`，`SITE_DESC` 留空（可在 `index.html` 维护 description/OG/Twitter）。

## 自定义
- 工具页：编辑 `src/views/Tools.vue` 的 `tools` 数组
- 作品页：编辑 `src/views/Projects.vue` 的 `projects` 数组
- 主题配色：在 `src/App.vue` 的 `:root` 修改 `--bg` / `--text` / `--accent`

## 许可
按你的仓库协议发布与使用。