# BloomDocs

**Repository Path**: ljbgetee/bloom-docs

## Basic Information

- **Project Name**: BloomDocs
- **Description**: 使用Cursor开发一个面试文档资料库，目前文档资料主要为.NET后端方向，持续更新中...
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-01-10
- **Last Updated**: 2026-01-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# BloomDocs - 面试题集合文档

> 基于 VitePress 构建的技术面试知识库

🌐 **文档地址**: [https://bloom-docs.bloomlx.com/](https://bloom-docs.bloomlx.com/)

## 特性

- 📝 **Markdown 驱动** - 使用 Markdown 编写文档，专注于内容创作
- ⚡️ **极速体验** - 基于 Vite，开发服务器秒启动，热更新响应迅速
- 🎨 **主题美观** - 开箱即用的现代化主题设计，支持深色/浅色模式切换
- 🔍 **内置搜索** - 无需配置的全文搜索功能，支持快捷键 Ctrl+K
- 📦 **开箱即用** - 简单的配置，丰富的功能
- 🚀 **静态部署** - 构建生成纯静态 HTML，可部署到任何静态托管服务
- 🐳 **Docker 支持** - 提供 Docker 镜像，一键部署
- 📱 **响应式设计** - 完美适配桌面端和移动端

## 快速开始

### 安装依赖

```bash
npm install
```

### 启动开发服务器

```bash
npm run dev
```

访问 <http://localhost:5173> 查看你的文档站点。

### 构建生产版本

```bash
npm run build
```

构建后的文件将输出到项目根目录的 `dist` 目录。

### 预览构建结果

```bash
npm run preview
```

## 项目结构

```text
bloomdocs/
├── docs/                    # 文档目录
│   ├── .vitepress/         # VitePress 配置
│   │   ├── config.mjs       # 配置文件
│   │   ├── theme/          # 自定义主题
│   │   │   ├── index.js
│   │   │   └── custom.css
│   │   ├── public/         # 静态资源（图片、SVG等）
│   │   └── cache/          # 构建缓存
│   ├── 面试题/             # 面试题文档
│   │   ├── 1.前端/
│   │   ├── 2.后端/
│   │   ├── 3.数据库/
│   │   ├── 4.微服务/
│   │   ├── 5.网络/
│   │   └── 6.运维/
│   └── index.md            # 首页
├── assets/                 # 资源文件（SVG图标等）
├── nginx/                  # Nginx 配置文件
│   └── nginx.conf
├── dist/                   # 构建输出目录（构建后生成）
├── Dockerfile              # Docker 镜像配置
├── package.json
└── README.md
```

## 编写文档

在 `docs/面试题` 目录下创建 Markdown 文件，然后在 `docs/.vitepress/config.mjs` 中配置导航和侧边栏。

### 基本语法

```markdown
# 标题

这是正文内容。

## 二级标题

- 列表项 1
- 列表项 2

\`\`\`javascript
// 代码块
console.log('Hello World')
\`\`\`
```

### VitePress 扩展语法

```markdown
::: tip 提示
这是一个提示框
:::

::: warning 警告
这是一个警告框
:::

::: danger 危险
这是一个危险提示框
:::
```

## 部署

### Docker 部署（推荐）

1. **构建项目**

   ```bash
   npm run build
   ```

2. **构建 Docker 镜像**

   ```bash
   docker build -t bloomdocs .
   ```

3. **运行容器**

   ```bash
   docker run -d -p 80:80 --name bloomdocs bloomdocs
   ```

   访问 <http://localhost> 查看站点。

## 技术栈

- [VitePress](https://vitepress.dev/) - 静态站点生成器
- [Vue 3](https://cn.vuejs.org/) - 渐进式 JavaScript 框架
- [Vite](https://cn.vitejs.dev/) - 下一代前端构建工具

## 文档

查看 [官方文档](https://vitepress.dev/) 了解更多功能和配置选项。

## 许可证

MIT License