mirror of
https://github.com/go-task/task.git
synced 2026-07-01 00:24:30 +00:00
Website: Sync translations (#1089)
This commit is contained in:
@@ -1,6 +1,8 @@
|
||||
---
|
||||
slug: /api/
|
||||
sidebar_position: 4
|
||||
toc_min_heading_level: 2
|
||||
toc_max_heading_level: 5
|
||||
---
|
||||
|
||||
# API 参考
|
||||
@@ -15,10 +17,12 @@ task [--flags] [tasks...] [-- CLI_ARGS...]
|
||||
|
||||
:::tip
|
||||
|
||||
|
||||
如果 `--` 给出,所有剩余参数将被分配给一个特殊的 `CLI_ARGS` 变量
|
||||
|
||||
:::
|
||||
|
||||
|
||||
| 缩写 | 标志 | 类型 | 默认 | 描述 |
|
||||
| ---- | --------------------------- | -------- | -------------------------------- | --------------------------------------------------------------------------------------------------- |
|
||||
| `-c` | `--color` | `bool` | `true` | 彩色输出。 默认开启。 设置为 `false` 或使用 `NO_COLOR=1` 禁用。 |
|
||||
@@ -102,9 +106,7 @@ task [--flags] [tasks...] [-- CLI_ARGS...]
|
||||
| `TASK_COLOR_RED` | `31` | 用于红色的颜色。 |
|
||||
| `FORCE_COLOR` | | 强制使用颜色输出。 |
|
||||
|
||||
## 规则
|
||||
|
||||
### Taskfile
|
||||
## Taskfile Schema
|
||||
|
||||
| 属性 | 类型 | 默认 | 描述 |
|
||||
| ---------- | ---------------------------------- | ------------- | ------------------------------------------------------------------------------------------------- |
|
||||
@@ -135,6 +137,7 @@ task [--flags] [tasks...] [-- CLI_ARGS...]
|
||||
|
||||
:::info
|
||||
|
||||
|
||||
像下面这样只赋值一个字符串,和把这个值设置到 `taskfile` 属性是一样的。
|
||||
|
||||
```yaml
|
||||
@@ -144,6 +147,29 @@ includes:
|
||||
|
||||
:::
|
||||
|
||||
|
||||
### Variable
|
||||
|
||||
| 属性 | 类型 | 默认 | 描述 |
|
||||
| -------- | -------- | -- | ---------------------------------- |
|
||||
| *itself* | `string` | | 将设置为变量的静态值。 |
|
||||
| `sh` | `string` | | 一个 shell 命令。 输出 (`STDOUT`) 将分配给变量。 |
|
||||
|
||||
:::info
|
||||
|
||||
|
||||
静态和动态变量有不同的语法,如下所示:
|
||||
|
||||
```yaml
|
||||
vars:
|
||||
STATIC: static
|
||||
DYNAMIC:
|
||||
sh: echo "dynamic"
|
||||
```
|
||||
|
||||
:::
|
||||
|
||||
|
||||
### Task
|
||||
|
||||
| 属性 | 类型 | 默认 | 描述 |
|
||||
@@ -175,6 +201,7 @@ includes:
|
||||
|
||||
:::info
|
||||
|
||||
|
||||
这些替代语法可用。 他们会将给定值设置为 `cmds`,其他所有内容都将设置为其默认值:
|
||||
|
||||
```yaml
|
||||
@@ -191,26 +218,8 @@ tasks:
|
||||
|
||||
:::
|
||||
|
||||
### Dependency
|
||||
|
||||
| 属性 | 类型 | 默认 | 描述 |
|
||||
| ------ | ---------------------------------- | -- | --------------- |
|
||||
| `task` | `string` | | 要作为依赖项执行的任务。 |
|
||||
| `vars` | [`map[string]Variable`](#variable) | | 要传递给此任务的可选附加变量。 |
|
||||
|
||||
:::tip
|
||||
|
||||
如果你不想设置额外的变量,将依赖关系声明为一个字符串列表就足够了(它们将被分配给 `task`)。
|
||||
|
||||
```yaml
|
||||
tasks:
|
||||
foo:
|
||||
deps: [foo, bar]
|
||||
```
|
||||
|
||||
:::
|
||||
|
||||
### Command
|
||||
#### Command
|
||||
|
||||
| 属性 | 类型 | 默认 | 描述 |
|
||||
| -------------- | ---------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------- |
|
||||
@@ -226,6 +235,7 @@ tasks:
|
||||
|
||||
:::info
|
||||
|
||||
|
||||
如果以字符串形式给出,该值将分配给 `cmd`:
|
||||
|
||||
```yaml
|
||||
@@ -238,27 +248,29 @@ tasks:
|
||||
|
||||
:::
|
||||
|
||||
### Variable
|
||||
|
||||
| 属性 | 类型 | 默认 | 描述 |
|
||||
| -------- | -------- | -- | ---------------------------------- |
|
||||
| *itself* | `string` | | 将设置为变量的静态值。 |
|
||||
| `sh` | `string` | | 一个 shell 命令。 输出 (`STDOUT`) 将分配给变量。 |
|
||||
#### Dependency
|
||||
|
||||
:::info
|
||||
| 属性 | 类型 | 默认 | 描述 |
|
||||
| ------ | ---------------------------------- | -- | --------------- |
|
||||
| `task` | `string` | | 要作为依赖项执行的任务。 |
|
||||
| `vars` | [`map[string]Variable`](#variable) | | 要传递给此任务的可选附加变量。 |
|
||||
|
||||
静态和动态变量有不同的语法,如下所示:
|
||||
:::tip
|
||||
|
||||
|
||||
如果你不想设置额外的变量,将依赖关系声明为一个字符串列表就足够了(它们将被分配给 `task`)。
|
||||
|
||||
```yaml
|
||||
vars:
|
||||
STATIC: static
|
||||
DYNAMIC:
|
||||
sh: echo "dynamic"
|
||||
tasks:
|
||||
foo:
|
||||
deps: [foo, bar]
|
||||
```
|
||||
|
||||
:::
|
||||
|
||||
### Precondition
|
||||
|
||||
#### Precondition
|
||||
|
||||
| 属性 | 类型 | 默认 | 描述 |
|
||||
| ----- | -------- | -- | ----------------------------------- |
|
||||
@@ -267,6 +279,7 @@ vars:
|
||||
|
||||
:::tip
|
||||
|
||||
|
||||
如果你不想设置不同的消息,你可以像这样声明一个前提条件,值将被分配给 `sh`:
|
||||
|
||||
```yaml
|
||||
|
||||
Reference in New Issue
Block a user