docs: update README for Mintlify migration

This commit is contained in:
RockChinQ
2026-02-21 11:14:17 -05:00
parent 3be65995aa
commit 997cb6b41a
+48 -44
View File
@@ -1,44 +1,48 @@
# [LangBot](https://github.com/langbot-app/LangBot) 官方文档
> 此仓库是 LangBot 的文档仓库,代码仓库:
> [LangBot 代码仓库](https://github.com/langbot-app/LangBot)
> 这是 LangBot 4.0 的文档,3.0 文档请见 `v3` 分支
## 参与编写
文档基于 VitePress 生成,本地编写需要安装 Node 和 VitePress
Clone 本仓库,在目录下执行以下命令安装依赖:
```bash
npm install
```
完成后即可修改文档,修改完后使用以下命令本地启动:
```bash
npm run docs:dev
```
### 使用图片
把图片放到 `docs/assets/image` 目录下,然后在文档中使用Web访问时的绝对路径引用,如:
```markdown
![image](/assets/image/xxx.png)
```
### 部署细节
现在使用 Cloudflare Pages 托管,提交后 [@RockChinQ](https://github.com/RockChinQ) 更新分支进行自动部署。
### 一些规范化标准
- 文件夹和文件的命名:**一律使用全小写,单词直接`-`隔开,如**`plugin-intro.md`
- 子文件(夹)的命名,**不加前缀**(即文件夹的名称),如:`deploy`文件夹下的,文件夹`langbot`,`langbot`文件夹下的`manual`文件称之为`manual.md`
- 由于这是有关于文档的规范化命名,所以任何文件的名称都可以以教程的角度来理解,如`deploy`是有关部署的教程
- 除了配置文件板块的文档,其他的页面都不要在顶部加目录
---
**[English README](README_EN.md)**
# [LangBot](https://github.com/langbot-app/LangBot) 官方文档
> 此仓库是 LangBot 的文档仓库,代码仓库:
> [LangBot 代码仓库](https://github.com/langbot-app/LangBot)
> 这是 LangBot 4.0 的文档,3.0 文档请见 `v3` 分支
## 参与编写
文档基于 [Mintlify](https://mintlify.com/) 生成,本地编写需要安装 Node.js。
Clone 本仓库,在目录下执行以下命令安装依赖:
```bash
npm install
```
完成后即可修改文档,修改完后使用以下命令本地启动预览:
```bash
npm run dev
```
或者直接使用 `mintlify` CLI (推荐):
```bash
npx mintlify dev
```
### 使用图片
把图片放到 `images` 目录下,然后在文档中使用绝对路径引用(相对于项目根目录),如:
```markdown
![image](/images/xxx.png)
```
### 部署细节
现已迁移至 Mintlify 托管,提交至 `main` 分支后自动触发部署。
### 一些规范化标准
- 文件夹和文件的命名:**一律使用全小写,单词直接`-`隔开,如**`plugin-intro.mdx`
- 子文件(夹)的命名,**不加前缀**(即文件夹的名称),如:`deploy`文件夹下的,文件夹`langbot`,`langbot`文件夹下的`manual`文件称之为`manual.mdx`
- 文档文件格式统一使用 `.mdx` 以支持 Mintlify 组件。
- 在 `docs.json` 中配置侧边栏导航结构。
---
**[English README](README_EN.md)**