Skip to content

Commit

Permalink
feat(docs): 新增 API 文档
Browse files Browse the repository at this point in the history
  • Loading branch information
lexmin0412 committed May 7, 2024
1 parent 9105323 commit 40c2fce
Show file tree
Hide file tree
Showing 3 changed files with 122 additions and 1 deletion.
5 changes: 5 additions & 0 deletions packages/docs/docs/zh/guide/usage/_meta.json
Original file line number Diff line number Diff line change
Expand Up @@ -3,5 +3,10 @@
"type": "file",
"name": "cli",
"label": "cli"
},
{
"type": "file",
"name": "api",
"label": "Node.js API"
}
]
116 changes: 116 additions & 0 deletions packages/docs/docs/zh/guide/usage/api.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,116 @@
# Node.js API

## 安装

```bash
pnpm add @readue/api
```

## API

### `isMonorepo`

判断是否为 monorepo 仓库。

#### 类型定义

```ts
function isMonorepo(path: string): boolean
```

#### 参数

| 参数名 | 类型 | 说明 |
|--------|----------|------------------|
| `path` | `string` | 要判断的目录路径 |

#### 返回值

布尔值,表示是否为 monorepo 仓库。

#### 用法

```js
import { isMonorepo } from "@readue/api"
console.log(isMonorepo(process.cwd())) // true
```

### `generate4Monorepo`

monorepo 仓库生成 README.md

#### 类型定义

```ts
function generate4Monorepo(pkgJson: Record<string, any>, path: string): Promise<void>
```

#### 参数

| 参数名 | 类型 | 说明 |
|-----------|-----------------------|------------------------------|
| `pkgJson` | `Record<string, any>` | monorepo 仓库的 package.json |
| `path` | `string` | 工作目录 |

#### 返回值

无。

#### 用法

```js
import { generate4Monorepo } from "@readue/api"
// 读取 package.json
const content = fs.readFileSync(path.resolve(process.cwd(), 'package.json')).toString()
// 解析 package.json
const pkgJson = JSON.parse(content)
// 生成 README.md
generate4Monorepo(content, process.cwd())
.then(() => {
console.log('done')
process.exit(0)
})
.catch(err => {
console.error(err)
process.exit(1)
})
```

### `generate4SinglePkg`

为单包仓库生成 README.md

#### 类型定义

```ts
function generate4SinglePkg(pkgJson: Record<string, any>): void
```

#### 参数

| 参数名 | 类型 | 说明 |
|-----------|-----------------------|------------------|
| `pkgJson` | `Record<string, any>` | 单包仓库的 package.json |

#### 返回值

无。

#### 用法

```js
import { generate4SinglePkg } from "@readue/api"
// 读取 package.json
const content = fs.readFileSync(path.resolve(process.cwd(), 'package.json')).toString()
// 解析 package.json
const pkgJson = JSON.parse(content)
// 生成 README.md
generate4SinglePkg(pkgJson)
```
2 changes: 1 addition & 1 deletion packages/docs/docs/zh/guide/usage/cli.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ npm install -g @readue/cli
在项目根目录下执行以下命令,即可生成 README 文件。

```bash
readue
readue gen
```

## 配置
Expand Down

0 comments on commit 40c2fce

Please sign in to comment.