# docusu-test

**Repository Path**: windrunner1/docusu-test

## Basic Information

- **Project Name**: docusu-test
- **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-12-26
- **Last Updated**: 2026-01-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Docusaurus 文档网站（中文版）

这是一个基于 Docusaurus 的文档网站，支持 Mermaid 图表渲染。

## 功能特性

- **Docusaurus 3.x**: 现代化文档框架
- **Mermaid 支持**: 在 Markdown 文件中渲染 Mermaid 图表
- **博客**: 内置博客功能
- **中文支持**: 完整的中文本地化
- **主题**: 可定制的亮色和暗色主题

## 快速开始

### 安装依赖

```bash
pnpm install
```

### 开发模式

```bash
pnpm start
```

网站将在 `http://localhost:5000` 上运行

### 构建

```bash
pnpm build
```

### 预览生产构建

```bash
pnpm serve
```

## Mermaid 图表

在 Markdown 文件中使用 `mermaid` 代码块来添加图表：

```markdown
\`\`\`mermaid
graph TD
    A[开始] --> B[结束]
\`\`\`
```

### 支持的图表类型

- 流程图
- 时序图
- 甘特图
- 饼图
- 思维导图
- 以及更多...

### 配置

Mermaid 支持在 `docusaurus.config.ts` 中启用：

```typescript
markdown: {
  mermaid: true,
},

themes: ['@docusaurus/theme-mermaid'],
```

## 项目结构

```
.
├── blog/          # 博客文章
├── docs/          # 文档页面
├── src/           # 源文件（CSS、组件、页面）
├── static/        # 静态资源
├── docusaurus.config.ts  # Docusaurus 配置
└── package.json   # 项目依赖
```

## 自定义

### 样式

编辑 `src/css/custom.css` 来自定义网站外观。

### 配置

编辑 `docusaurus.config.ts` 来自定义网站配置。

## 中文支持

本网站已完全汉化：
- 导航栏和页脚已翻译
- 文档内容已翻译
- 博客文章已翻译
- 界面元素已本地化

### 切换语言

如需添加多语言支持，可以在 `docusaurus.config.ts` 中配置：

```typescript
i18n: {
  defaultLocale: 'zh-CN',
  locales: ['zh-CN', 'en'],
},
```

## 注意事项

- Mermaid 图表在浏览器中渲染为 SVG（矢量图形）
- 网站支持亮色和暗色主题
- Mermaid 图表会自动适应当前主题