# 文档贡献指南

## 1. 文档贡献流程

### 1.1. fork 仓库

首先，你需要 fork 本仓库到你的 GitHub 账号下。
项目地址为: [www.github.com/deepin-community](https://github.com/deepin-community/.guide.deepin.org)

看到右上角的fork按钮了吗？点击它，就可以将本仓库复制到你的账号下了。

### 1.2. 克隆仓库

你需要将你的仓库克隆到本地，然后在本地进行修改。

```bash
git clone https://github.com/deepin-community/.guide.deepin.org.git
```

然后使用文本编辑器打开仓库，你会看到如下目录结构：

```text
 .
├──  docs
├──  LICENSE
├──  node_modules
├──  package.json
├──  pnpm-lock.yaml
├──  README.md
└──  yarn.lock
```

你需要写的文档就在docs目录下，你可以在这个目录下新建一个文件夹，然后在这个文件夹下写你的文档。
和现在这篇文档一样。

如果你需要修改侧边栏，你需要修改`docs/.vitepress/config.js`文件。

### 1.3. 本地渲染

#### 安装依赖

本文档使用vitepress作为文档渲染工具，你需要安装vitepress的依赖。

你需要安装nodejs和pnpm，然后使用pnpm来安装依赖。

```bash
pnpm install
```

使用`pnpm dev`来本地渲染文档。

```bash
pnpm dev
```

**注意：如果你使用的是yarn，你需要将`pnpm`替换为`yarn`**

#### 本地渲染效果

你可以在浏览器中打开`http://localhost:3000`来查看本地渲染效果。
注意这个端口并不固定，会在你运行后在终端中显示。

### 1.4. 提交修改

提交修改到你的仓库。

```bash
git add .
git commit -m "docs: add new doc"
git push
```

注意 commit 信息需要符合[约定式提交规范](https://www.conventionalcommits.org/zh-hans/v1.0.0-beta.4/)。

### 1.5. 发起 Pull Request

在你的仓库中，点击`Pull requests`，然后点击`New pull request`，然后点击`Create pull request`。

## 2. 文档格式

### 2.1. Markdown

本文档使用Markdown作为文档格式，你可以在[这里](https://www.markdownguide.org/basic-syntax/)查看Markdown的基本语法。

### 2.2. Vitepress

本文档使用Vitepress作为文档渲染工具，你可以在[这里](https://vitepress.vuejs.org/)查看Vitepress的文档。

## 3. CLA协议

本仓库使用CLA协议，你无需签署CLA协议，如果你提交pr,则视为你已经同意CLA协议。
[CLA协议](https://github.com/linuxdeepin/cla)

## 4. License

本仓库使用LGPL-3.0-or-later License ，你可以在此License下自由使用本仓库的内容。