# blog

**Repository Path**: xvcenh/blog

## Basic Information

- **Project Name**: blog
- **Description**: 公司的内部blog门户
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-12
- **Last Updated**: 2026-03-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# VuePress 博客

基于 VuePress 2.0 + vuepress-theme-hope 的静态博客，部署在 Gitee Pages。

## 特性

- 🚀 **快速加载**：基于VuePress的静态网站生成
- 📱 **响应式设计**：完美适配手机和电脑
- 🎨 **现代化界面**：使用vuepress-theme-hope主题
- 🔍 **全文搜索**：快速找到需要的内容
- 📝 **Markdown写作**：支持丰富的Markdown扩展
- 🏷️ **标签分类**：完善的内容组织系统
- 💬 **评论功能**：支持多种评论系统
- 📊 **阅读统计**：文章阅读时间和字数统计

## 快速开始

### 环境要求
- Node.js 14.18.0+
- npm 6.14.15+

### 安装依赖
```bash
npm install
```

### 本地开发
```bash
npm run docs:dev
```
访问 http://localhost:8080

### 构建静态文件
```bash
npm run docs:build
```
生成的静态文件在 `dist` 目录中。

## 项目结构

```
blog/
├── docs/                    # 文档目录
│   ├── .vuepress/          # VuePress配置
│   │   └── config.js       # 配置文件
│   ├── posts/              # 博客文章
│   │   └── first-post.md   # 示例文章
│   ├── about.md            # 关于页面
│   └── README.md           # 首页
├── package.json            # 项目配置
├── package-lock.json       # 依赖锁文件
└── README.md               # 项目说明
```

## 写作指南

### 创建新文章
在 `docs/posts/` 目录下创建Markdown文件，使用以下Front Matter：

```yaml
---
title: 文章标题
date: 2026-03-13
author: xvcenh13
category:
  - 分类1
  - 分类2
tag:
  - 标签1
  - 标签2
---
```

### Markdown扩展
VuePress支持丰富的Markdown扩展：

- **代码块**：支持语法高亮和行号
- **数学公式**：使用LaTeX语法
- **图表**：支持Mermaid、ECharts等
- **提示框**：支持多种类型的提示框
- **任务列表**：支持待办事项列表

## 部署

### Gitee Pages
1. 将代码推送到Gitee仓库
2. 在Gitee仓库设置中启用Pages服务
3. 选择部署分支（通常是master）
4. 访问 https://xvcenh.gitee.io/blog/

### 自动化部署
项目已配置VuePress，构建后推送到gh-pages分支即可自动部署。

## 主题配置

主题使用 [vuepress-theme-hope](https://theme-hope.vuejs.press/)，详细配置请参考主题文档。

主要配置在 `docs/.vuepress/config.js` 中。

## 许可证

MIT License

## 联系

- **GitHub**: [xvcenh](https://github.com/xvcenh)
- **Gitee**: [xvcenh](https://gitee.com/xvcenh)

## 更新日志

### 2026-03-13
- 从Hugo迁移到VuePress
- 使用vuepress-theme-hope主题
- 创建基础内容和配置
- 配置Gitee Pages部署