# 龙芯爱好者社区门户

本仓库托管为龙芯爱好者社区门户 ([loongfans.cn](https://loongfans.cn/)) 源代码。

## 开发与测试

在安装 Node.js 及配置好 PNPM 后，运行如下命令安装开发依赖：

```sh
pnpm i
```

而后使用如下命令即可实时预览页面：

```sh
pnpm run dev
```

本项目的 HMR 适配较为完善：当任何源码文件（包括 `data/` 下的数据文件）变更之后，都会自动触发前端页面刷新。但有以下注意事项：

* 目前受限于 VitePress 动态路由功能的具体实现，芯片页面的标题、副标题不会随着源数据文件的变更而变更；新增、删除芯片数据文件也不会反映到页面的增加或删除。此问题可能可以修复，但也可能涉及对 VitePress 作出改动。退出并重新启动开发服务器可解。

## 构建与部署

在完成上述依赖部署后，运行如下命令即可构建页面：

```sh
pnpm run build
```

构建后的站点数据将被存放在 `./.vitepress/dist`。

每次向 `main` 分支或任一 PR 进行推送，都会触发本站的 CI 任务，所构建的静态数据会被自动部署到相应的环境。目前的部署环境情况如下：

* 生产环境 `production`：自建后端
* 预览环境 `preview`：Cloudflare Pages
