From 98d170f0e7b177dfed1928887da154248c471a42 Mon Sep 17 00:00:00 2001
From: cuikaisong <906300642@qq.com>
Date: Tue, 1 Nov 2022 09:44:54 +0800
Subject: [PATCH 1/3] tijiao
---
.idea/.gitignore | 5 +++++
.idea/docs.iml | 12 ++++++++++++
.idea/inspectionProfiles/Project_Default.xml | 6 ++++++
.idea/modules.xml | 8 ++++++++
.idea/vcs.xml | 6 ++++++
pages/repo/docs/reference/configuration.mdx | 2 +-
6 files changed, 38 insertions(+), 1 deletion(-)
create mode 100644 .idea/.gitignore
create mode 100644 .idea/docs.iml
create mode 100644 .idea/inspectionProfiles/Project_Default.xml
create mode 100644 .idea/modules.xml
create mode 100644 .idea/vcs.xml
diff --git a/.idea/.gitignore b/.idea/.gitignore
new file mode 100644
index 0000000..b58b603
--- /dev/null
+++ b/.idea/.gitignore
@@ -0,0 +1,5 @@
+# Default ignored files
+/shelf/
+/workspace.xml
+# Editor-based HTTP Client requests
+/httpRequests/
diff --git a/.idea/docs.iml b/.idea/docs.iml
new file mode 100644
index 0000000..0c8867d
--- /dev/null
+++ b/.idea/docs.iml
@@ -0,0 +1,12 @@
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/.idea/inspectionProfiles/Project_Default.xml b/.idea/inspectionProfiles/Project_Default.xml
new file mode 100644
index 0000000..03d9549
--- /dev/null
+++ b/.idea/inspectionProfiles/Project_Default.xml
@@ -0,0 +1,6 @@
+
+
+
+
+
+
\ No newline at end of file
diff --git a/.idea/modules.xml b/.idea/modules.xml
new file mode 100644
index 0000000..6049cfe
--- /dev/null
+++ b/.idea/modules.xml
@@ -0,0 +1,8 @@
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/.idea/vcs.xml b/.idea/vcs.xml
new file mode 100644
index 0000000..94a25f7
--- /dev/null
+++ b/.idea/vcs.xml
@@ -0,0 +1,6 @@
+
+
+
+
+
+
\ No newline at end of file
diff --git a/pages/repo/docs/reference/configuration.mdx b/pages/repo/docs/reference/configuration.mdx
index 946e871..5bb01cf 100644
--- a/pages/repo/docs/reference/configuration.mdx
+++ b/pages/repo/docs/reference/configuration.mdx
@@ -1,5 +1,5 @@
---
-title: Configuration Options - turbo.json
+title: Configuration Options - turbo.json
description: Learn how to configure Turborepo through `turbo.json`.
---
From bb8a11af1d9e8c88195499b3b142d4491fe122a3 Mon Sep 17 00:00:00 2001
From: cuikaisong <906300642@qq.com>
Date: Tue, 1 Nov 2022 09:55:19 +0800
Subject: [PATCH 2/3] =?UTF-8?q?=E7=BF=BB=E8=AF=91?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
pages/repo/docs/reference/configuration.mdx | 127 ++++++++++----------
1 file changed, 61 insertions(+), 66 deletions(-)
diff --git a/pages/repo/docs/reference/configuration.mdx b/pages/repo/docs/reference/configuration.mdx
index 5bb01cf..28a09cb 100644
--- a/pages/repo/docs/reference/configuration.mdx
+++ b/pages/repo/docs/reference/configuration.mdx
@@ -1,34 +1,33 @@
---
-title: Configuration Options - turbo.json
-description: Learn how to configure Turborepo through `turbo.json`.
+title: 配置选项 - turbo.json
+description: 了解如何配置Turborepo通过 `turbo.json`.
---
import Callout from "../../../../components/Callout";
import OutputModeTable from "../../../../components/output-mode-table.mdx";
-# Configuration Options (`turbo.json`)
+# 配置选项 (`turbo.json`)
-You can configure the behavior of `turbo` by adding a `turbo.json` file in your monorepo's root (i.e. the same one you specify your `workspaces` key is set for Yarn and npm users).
+您可以通过添加一个' turbo '来配置' turbo '的行为。 json '文件在你的monorepo的根目录中(也就是你为Yarn和npm用户指定的' workspace '键)。
## `globalDependencies`
`type: string[]`
-A list of file globs for implicit global hash dependencies. The contents of these files will be included in the global hashing algorithm and affect the hashes of all tasks.
-This is useful for busting the cache based on `.env` files (not in Git) or any root level file that impacts workspace tasks (but are not represented in the traditional dependency graph (e.g. a root `tsconfig.json`, `jest.config.js`, `.eslintrc`, etc.)).
-
+用于隐式全局哈希依赖项的文件glob列表。 这些文件的内容将包含在全局哈希算法中,并影响所有任务的哈希。
+这对于基于'销毁缓存非常有用。 env '文件(不在Git中)或任何影响工作空间任务的根级文件(但没有在传统的依赖关系图中表示(例如根' tsconfig. env ')。 Json ', ' jest.config.js ', ' .eslintrc '等))。
**Example**
```jsonc
{
"$schema": "https://turborepo.org/schema.json",
"pipeline": {
- // ... omitted for brevity
+ // ... 为了简便起见,我们省略了
},
"globalDependencies": [
- ".env", // contents will impact hashes of all tasks
- "tsconfig.json" // contents will impact hashes of all tasks
+ ".env", // 内容将影响所有任务的散列
+ "tsconfig.json" // 内容将影响所有任务的散列
]
}
```
@@ -37,8 +36,7 @@ This is useful for busting the cache based on `.env` files (not in Git) or any r
`type: string[]`
-A list of environment variables for implicit global hash dependencies. The contents of these environment variables will be included in the global hashing algorithm and affect the hashes of all tasks.
-
+用于隐式全局哈希依赖项的环境变量列表。 这些环境变量的内容将包含在全局哈希算法中,并影响所有任务的哈希。
**Example**
```jsonc
@@ -53,10 +51,9 @@ A list of environment variables for implicit global hash dependencies. The conte
```
## `pipeline`
+表示项目的任务依赖关系图的对象。 ' turbo '解释这些约定,以正确地调度、执行和缓存项目中任务的输出。
-An object representing the task dependency graph of your project. `turbo` interprets these conventions to properly schedule, execute, and cache the outputs of tasks in your project.
-
-Each key in the `pipeline` object is the name of a task that can be executed by `turbo run`. If `turbo` finds a workspace with a `package.json` `scripts` object with a matching key, it will apply the pipeline task configuration to that npm script during execution. This allows you to use `pipeline` to set conventions across your entire Turborepo.
+“pipeline”对象中的每个键都是可以通过“turbo run”执行的任务的名称。 如果' turbo '找到一个带有' package. net '的工作区。 Json ' ' scripts '对象具有匹配的键,它将在执行过程中将管道任务配置应用到该NPM脚本。 这允许你使用“管道”在整个Turborepo中设置约定。
```jsonc
{
@@ -82,17 +79,16 @@ Each key in the `pipeline` object is the name of a task that can be executed by
`type: string[]`
-The list of tasks this task depends on.
-
-Prefixing an item in `dependsOn` with a `^` tells `turbo` that this pipeline task depends on the workspace's topological dependencies completing the task with the `^` prefix first (e.g. "a workspace's `build` tasks should only run once all of its `dependencies` and `devDependencies` have completed their own `build` commands").
+此任务所依赖的任务列表。
-Items in `dependsOn` without `^` prefix, express the relationships between tasks at the workspace level (e.g. "a workspace's `test` and `lint` commands depend on `build` being completed first").
+在' dependsOn '中给一个项目加上' ^ '前缀,告诉' turbo '这个管道任务依赖于工作区的拓扑依赖关系,首先用' ^ '前缀完成任务(例如。 “一个工作区的‘构建’任务应该只在它的所有‘依赖’和‘devDependencies’完成它们自己的‘构建’命令后才运行”)。
-Prefixing an item in `dependsOn` with a `$` tells `turbo` that this pipeline task depends on the value of that environment variable.
+在' dependsOn '中没有' ^ '前缀的项目,表示工作空间级别的任务之间的关系(例如: “一个工作区的‘test’和‘lint’命令依赖于‘build’首先完成”)。
+在' dependsOn '中的项目前面加上' $ ',告诉' turbo '该管道任务依赖于该环境变量的值。
- Using `$` to declare environment variables in the `dependsOn` config is
- deprecated. Use the `env` key instead.
+ 使用' $ '在' dependsOn '配置中声明环境变量是
+ 弃用。 使用' env '键代替。
**Example**
@@ -102,21 +98,22 @@ Prefixing an item in `dependsOn` with a `$` tells `turbo` that this pipeline tas
"$schema": "https://turborepo.org/schema.json",
"pipeline": {
"build": {
- // "A workspace's `build` command depends on its dependencies'
- // or devDependencies' `build` command being completed first"
+ // "一个工作区的“构建”命令取决于它的依赖关系 '
+ // 或者先完成devDependencies的' build '命令"
"dependsOn": ["^build"]
},
"test": {
- // "A workspace's `test` command depends on its own `lint` and
- // `build` commands first being completed"
+ // “一个工作区的‘test’命令依赖于它自己的‘lint’和
+ // `build` 命令首先被完成”
"dependsOn": ["lint", "build"]
},
"deploy": {
- // "A workspace's `deploy` command, depends on its own `build`
- // and `test` commands first being completed"
+ // 一个工作区的“部署”deploy,取决于它自己的“build”
+ // ' test '命令首先被完成"
+
"dependsOn": ["build", "test"]
},
- // A workspace's `lint` command has no dependencies
+ // 工作区的' lint '命令没有依赖性
"lint": {}
}
}
@@ -126,7 +123,7 @@ Prefixing an item in `dependsOn` with a `$` tells `turbo` that this pipeline tas
`type: string[]`
-The list of environment variables a task depends on.
+任务所依赖的环境变量列表。
**Example**
@@ -136,43 +133,42 @@ The list of environment variables a task depends on.
"pipeline": {
"build": {
"dependsOn": ["^build"],
- "env": ["SOMETHING_ELSE"], // value will impact the hashes of all build tasks
+ "env": ["SOMETHING_ELSE"], // 值将影响所有构建任务的散列
"outputs": ["dist/**", ".next/**"]
},
"web#build": {
"dependsOn": ["^build"],
- "env": ["STRIPE_SECRET_KEY"], // value will impact hash of only web's build task
+ "env": ["STRIPE_SECRET_KEY"], // 值只会影响web的构建任务的散列
"outputs": [".next/**"]
}
},
"globalEnv": [
- "GITHUB_TOKEN" // value will impact the hashes of all tasks
+ "GITHUB_TOKEN" // 值将影响所有任务的散列
]
}
```
- When Turborepo detects a common frontend framework in a workspace, it will
- automatically depend on environment variables that are going to be inlined in
- your build. For example, if the `web` workspace contains a Next.js project,
- you do not need to specify any environment variables that [start with
- `NEXT_PUBLIC_`](https://nextjs.org/docs/basic-features/environment-variables#exposing-environment-variables-to-the-browser)
- in the `dependsOn` config. Turborepo already knows that the build output will
- change when the value of these environment variables change, so it will depend
- on them automatically. See more in the [docs on
- caching](/docs/core-concepts/caching#automatic-environment-variable-inclusion).
+ 当Turborepo在工作空间中检测到公共前端框架时,它就会这样做
+ 自动依赖于将内联的环境变量
+ 您的构建。 例如,如果“web”工作区包含Next.js项目,
+ 您不需要指定任何环境变量[以
+ ' NEXT_PUBLIC_ '] (https://nextjs.org/docs/basic-features/environment-variables # exposing-environment-variables-to-the-browser)
+ 在' dependsOn '配置中。 Turborepo已经知道构建输出将会
+ 当这些环境变量的值发生变化时,也会发生变化,因此它将取决于
+ 自动。 更多信息请参见[文档上
+ 缓存](/ docs /核心概念/缓存# automatic-environment-variable-inclusion)。
### `outputs`
`type: string[]`
-Defaults to `["dist/**", "build/**"]`. The set of glob patterns of a task's cacheable filesystem outputs.
-
-Note: `turbo` automatically logs `stderr`/`stdout` to `.turbo/run-.log`. This file is _always_ treated as a cacheable artifact and never needs to be specified.
+默认为' ["dist/**", "build/**"] '。 任务的可缓存文件系统输出的glob模式集。
-Passing an empty array can be used to tell `turbo` that a task is a side-effect and thus doesn't emit any filesystem artifacts (e.g. like a linter), but you still want to cache its logs (and treat them like an artifact).
+注意:`turbo` 自动记录`stderr`/`stdout` to`.turbo/run-.log`. 这个文件总是被视为可缓存的工件,从来不需要指定。
+传递一个空数组可以用来告诉' turbo '一个任务是一个副作用,因此不会产生任何文件系统工件(例如,linter),但您仍然希望缓存它的日志(并将它们视为工件)。
**Example**
```jsonc
@@ -180,25 +176,25 @@ Passing an empty array can be used to tell `turbo` that a task is a side-effect
"$schema": "https://turborepo.org/schema.json",
"pipeline": {
"build": {
- // "Cache all files emitted to workspace's dist/** or .next
- // directories by a `build` task"
+ // "缓存发送到工作区的dist/**或。next的所有文件
+ // 目录由'build'任务"
"outputs": ["dist/**", ".next/**"],
"dependsOn": ["^build"]
},
"test": {
- // "Don't cache any artifacts of `test` tasks (aside from
- // logs)"
+ // "不缓存'test'任务的任何工件(除了
+ / /日志)”
"outputs": [],
"dependsOn": ["build"]
},
"test:ci": {
- // "Cache the coverage report of a `test:ci` command"
+ // "缓存' test:ci '命令的覆盖率报告"
"outputs": ["coverage/**"],
"dependsOn": ["build"]
},
"dev": {
- // Never cache anything (including logs) emitted by a
- // `dev` task
+ // 从不缓存对象发出的任何内容(包括日志)
+ // dev的任务
"cache": false
}
}
@@ -209,8 +205,7 @@ Passing an empty array can be used to tell `turbo` that a task is a side-effect
`type: boolean`
-Defaults to `true`. Whether or not to cache the task [`outputs`](#outputs). Setting `cache` to false is useful for daemon or long-running "watch" or development mode tasks you don't want to cache.
-
+默认为“真正的”。 是否缓存任务[' outputs '](#outputs)。 将' cache '设置为false对于您不想缓存的守护进程或长时间运行的“监视”或开发模式任务非常有用。
**Example**
```jsonc
@@ -235,12 +230,11 @@ Defaults to `true`. Whether or not to cache the task [`outputs`](#outputs). Sett
`type: string[]`
-Defaults to `[]`. Tells `turbo` the set of files to consider when determining if a workspace has changed for a particular task.
-Setting this to a list of globs will cause the task to only be rerun when files matching those globs have
-changed. This can be helpful if you want to, for example, skip running tests unless a source file changed.
-
-Specifying `[]` will cause the task to be rerun when any file in the workspace changes.
+默认为“[]”。 告诉' turbo '在确定工作空间是否为特定任务更改时要考虑的文件集。
+将此设置为一个glob列表将导致只有当匹配这些glob的文件存在时才重新运行任务
+改变了。 例如,如果您想要跳过运行测试,除非源文件更改,那么这将很有帮助。
+指定'[]'将导致当工作区中的任何文件更改时重新运行任务。
**Example**
```jsonc
@@ -250,12 +244,12 @@ Specifying `[]` will cause the task to be rerun when any file in the workspace c
// ... omitted for brevity
"test": {
- // A workspace's `test` task depends on that workspace's
- // own `build` task being completed first.
+ //工作空间的“测试”任务依赖于该工作空间的
+ //自己的' build '任务首先完成。
"dependsOn": ["build"],
"outputs": [""],
- // A workspace's `test` task should only be rerun when
- // either a `.tsx` or `.ts` file has changed.
+ // 工作区的“test”任务应该只在以下情况下重新运行
+ // either a '。 tsx’或‘。 Ts的文件已更改。
"inputs": ["src/**/*.tsx", "src/**/*.ts", "test/**/*.ts"]
}
}
@@ -263,8 +257,9 @@ Specifying `[]` will cause the task to be rerun when any file in the workspace c
```
- Note: `turbo.json` is *always* considered an input. If you modify
- `turbo.json`, all caches are invalidated.
+
+ 注意:`turbo.json`总是被认为是输入。 如果你修改
+ `turbo.json`,所有缓存都无效。
### `outputMode`
From 31954e49a9fb778adf5db7990e55c49b316fd008 Mon Sep 17 00:00:00 2001
From: cuikaisong <906300642@qq.com>
Date: Tue, 1 Nov 2022 10:33:03 +0800
Subject: [PATCH 3/3] =?UTF-8?q?=E7=BF=BB=E8=AF=91codemods?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.gitignore | 2 ++
.idea/.gitignore | 5 ---
.idea/docs.iml | 12 -------
.idea/inspectionProfiles/Project_Default.xml | 6 ----
.idea/modules.xml | 8 -----
.idea/vcs.xml | 6 ----
pages/repo/docs/reference/codemods.mdx | 33 +++++++++++---------
7 files changed, 20 insertions(+), 52 deletions(-)
delete mode 100644 .idea/.gitignore
delete mode 100644 .idea/docs.iml
delete mode 100644 .idea/inspectionProfiles/Project_Default.xml
delete mode 100644 .idea/modules.xml
delete mode 100644 .idea/vcs.xml
diff --git a/.gitignore b/.gitignore
index 3907999..29076fa 100644
--- a/.gitignore
+++ b/.gitignore
@@ -5,6 +5,8 @@
# Sentry
.sentryclirc
+.idea/*
+
node_modules
.next
out
diff --git a/.idea/.gitignore b/.idea/.gitignore
deleted file mode 100644
index b58b603..0000000
--- a/.idea/.gitignore
+++ /dev/null
@@ -1,5 +0,0 @@
-# Default ignored files
-/shelf/
-/workspace.xml
-# Editor-based HTTP Client requests
-/httpRequests/
diff --git a/.idea/docs.iml b/.idea/docs.iml
deleted file mode 100644
index 0c8867d..0000000
--- a/.idea/docs.iml
+++ /dev/null
@@ -1,12 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
\ No newline at end of file
diff --git a/.idea/inspectionProfiles/Project_Default.xml b/.idea/inspectionProfiles/Project_Default.xml
deleted file mode 100644
index 03d9549..0000000
--- a/.idea/inspectionProfiles/Project_Default.xml
+++ /dev/null
@@ -1,6 +0,0 @@
-
-
-
-
-
-
\ No newline at end of file
diff --git a/.idea/modules.xml b/.idea/modules.xml
deleted file mode 100644
index 6049cfe..0000000
--- a/.idea/modules.xml
+++ /dev/null
@@ -1,8 +0,0 @@
-
-
-
-
-
-
-
-
\ No newline at end of file
diff --git a/.idea/vcs.xml b/.idea/vcs.xml
deleted file mode 100644
index 94a25f7..0000000
--- a/.idea/vcs.xml
+++ /dev/null
@@ -1,6 +0,0 @@
-
-
-
-
-
-
\ No newline at end of file
diff --git a/pages/repo/docs/reference/codemods.mdx b/pages/repo/docs/reference/codemods.mdx
index 382e164..ba33ba3 100644
--- a/pages/repo/docs/reference/codemods.mdx
+++ b/pages/repo/docs/reference/codemods.mdx
@@ -1,32 +1,33 @@
---
title: Turborepo Codemods
-description: To make upgrading easier, Turborepo includes codemods and migration scripts.
+description: 为了使升级更容易,Turborepo包括代码代码和迁移脚本。
---
# Turborepo Codemods
-Turborepo provides Codemod transformations and automatic migration scripts to help upgrade your Turborepo codebase when a feature is deprecated.
-
-Codemods are transformations that run on your codebase programmatically. This allows for a large amount of changes to be applied without having to manually go through every file.
+Turborepo提供Codemod转换和自动迁移脚本,以帮助在某个特性被弃用时升级您的Turborepo代码库。
+Codemods是以编程方式在代码库上运行的转换。 这允许应用大量的更改,而不必手动遍历每个文件。
## Usage
```sh
npx @turbo/codemod
```
-- `transform` - name of transform, see available transforms below.
-- `path` - files or directory to transform
-- `--dry` - Do a dry-run, no code will be edited
-- `--print` - Prints the changed output for comparison
+- ' transform ' -变换的名称,参见下面可用的变换。
+- ' path ' -要转换的文件或目录
+- '——dry ' -做一个演练,没有代码将被编辑
+- '——print ' -打印更改后的输出进行比较
## Turborepo 1.x
### `add-package-manager`
-Transforms the root `package.json` so that `packageManager` key as the detected package manager (`yarn`, `npm`, `pnpm`) and version (e.g. `yarn@1.22.17`). This key is now [supported by Node.js](https://nodejs.org/dist/latest-v17.x/docs/api/packages.html#packagemanager) and is used by Turborepo for faster package manager detection (vs. inferring from just the filesystem alone).
-For example, for Yarn v1:
+将根 `package.json` 以便 ' packageManager '键作为检测到的包管理器(' yarn ', ' npm ', ' pnpm ')和版本(例如: “yarn@1.22.17”)。 这个键现在[由Node.js支持](https://nodejs.org/dist/latest-v17.x/docs/api/packages.html#packagemanager),并且被Turborepo用于更快的包管理器检测(相对于仅从文件系统推断)。
+
+例如,对于Yarn v1:
+
```json
// Before
@@ -54,7 +55,7 @@ For example, for Yarn v1:
#### Usage
-Go to your project:
+进入你的项目:
```sh
cd path-to-your-turborepo/
@@ -71,7 +72,10 @@ npx @turbo/codemod add-package-manager
Creates the `turbo.json` file at the root of your project based on the `"turbo"` key in `package.json`.
The `"turbo"` key is subsequently deleted from `package.json`.
-For example:
+创建 `turbo.json`的项目根目录下的`"turbo"`键入' package.json '中的。
+' "turbo"键随后从' package.json '中删除。
+
+例如:
```json
// Before, package.json
@@ -111,7 +115,7 @@ For example:
#### Usage
-Go to your project:
+回到你的项目:
```sh
cd path-to-your-turborepo/
@@ -125,8 +129,7 @@ npx @turbo/codemod create-turbo-config
### `migrate-env-var-dependencies`
-Migrates all environment variable dependencies in `turbo.json` from `dependsOn` and `globalDependencies` to `env` and `globalEnv` respectively.
-
+在‘turbo’中迁移所有环境变量依赖项。 从' dependsOn '和' globalDependencies '改为' env '和' globalEnv '。
For example:
```json