fix: 修复第6章节内容错误

Author: cyyjs

src/6/6.1.md

@@ -3,7 +3,7 @@
 
 ## 初始化
 
-```tsx
+```bash
 $ git clone --depth 1 [email protected]:npmstudy/your-node-v20-monorepo-project.git my-monorepo
 Cloning into 'my-monorepo'...
 remote: Enumerating objects: 52, done.
@@ -16,7 +16,7 @@ Resolving deltas: 100% (2/2), done.
 
 只克隆最新的代码，无更多git commit记录。
 
-```tsx
+```bash
 $ rm -rf .git/
 $ git init
 Initialized empty Git repository in /Users/alfred/workspace/npmstudy/my-monorepo/.git/
@@ -117,7 +117,7 @@ pnpm是一个快速、高效且节省空间的包管理工具，适用于大型
 
 安装pnpm
 
-```tsx
+```bash
 $ npm i -g pnpm
 
 added 1 package in 4s
@@ -128,7 +128,7 @@ added 1 package in 4s
 
 安装依赖
 
-```tsx
+```bash
 $ pnpm i
 Scope: all 3 workspace projects
 Lockfile is up to date, resolution step is skipped
@@ -175,7 +175,7 @@ Done in 5.6s
 
 ## 目录结构
 
-```tsx
+```bash
 $ tree . -L 4 -I node_modules
 .
 ├── LICENSE
@@ -227,7 +227,7 @@ $ tree . -L 4 -I node_modules
 
 目录结构
 
-```tsx
+```bash
 $ tree packages/lib/ -I node_modules
 packages/lib/
 ├── package.json
@@ -263,7 +263,7 @@ Vitest是一个基于Vite的单元测试框架，它具有以下优点：
 3. 强大的功能：Vitest支持常见的单元测试功能，包括断言、测试套件、测试组织和测试覆盖率等。它还提供了丰富的扩展性，可以根据项目的需求进行自定义配置和扩展。
 4. 社区支持：Vitest是一个开源项目，拥有活跃的社区支持。你可以在GitHub上找到其代码库，并参与讨论、提问问题或贡献代码。
 
-它个快速、简单易用且功能强大的单元测试框架，适用于使用Vite构建的项目。它和Node.js test runner很像，你可以通过阅读文档和示例来了解更多关于Vitest的信息，并开始在你的项目中使用它。
+它是个快速、简单易用且功能强大的单元测试框架，适用于使用Vite构建的项目。它和Node.js test runner很像，你可以通过阅读文档和示例来了解更多关于Vitest的信息，并开始在你的项目中使用它。
 
 <aside>
 💡 学会一门，其他就会触类旁通，这是学习的好处。
@@ -274,7 +274,7 @@ Vitest是一个基于Vite的单元测试框架，它具有以下优点：
 
 目录
 
-```tsx
+```bash
 $ tree example/ -I node_modules
 example/
 ├── package.json
@@ -287,7 +287,7 @@ example/
 
 这里以koa为例
 
-```tsx
+```js
 import Koa from 'koa';
 import { lib } from 'lib2';
 const app = new Koa();
@@ -301,7 +301,7 @@ app.listen(3000);
 
 执行
 
-```tsx
+```bash
 $ pnpm example
 
 > your-node-v20-monorepo-project@ example /Users/alfred/workspace/npmstudy/my-monorepo
@@ -334,19 +334,19 @@ $ pnpm example
 
 其实，在这种Node.js Server应用里，也是可以进行测试的，比如使用supertest测试api和页面，甚至如果想极致一点，也可以使用Cypress做e2e测试。
 
-这是从简，并没有加，如果大家感兴趣，可以作为课后练习。
+这里从简，并没有加，如果大家感兴趣，可以作为课后练习。
 
 ## 新增模块
 
 如果想新增一个模块，那就通过简单的shell命令就可以了。
 
-```tsx
+```bash
 $ cp -rf packages/lib packages/lib3
 ```
 
 查看packages下内容，会发现多了lib3
 
-```tsx
+```bash
 $ tree packages/ -L 2
 packages/
 ├── lib
@@ -384,7 +384,7 @@ packages/
 1. cli解析，推荐使用commander或cac
 2. 输入项，推荐使用 [https://www.npmjs.com/package/inquirer](https://www.npmjs.com/package/inquirer)
 3. 模版引擎推荐使用handlebars
-4. 可以[**download-git-repo](https://www.npmjs.com/package/download-git-repo) 或** [https://www.npmjs.com/package/dclone](dclone).
+4. 可以 **[download-git-repo](https://www.npmjs.com/package/download-git-repo)** 或 [https://www.npmjs.com/package/dclone](dclone).
 
 <aside>
 💡 在前端开发中，脚手架是一个用于快速搭建项目结构和提供初始配置的工具。它可以帮助开发者快速创建项目，并集成了一些常用的工具、库和最佳实践。

src/6/6.2.md

@@ -3,22 +3,20 @@
 
 在 <https://github.com/npmstudy/your-node-v20-monorepo-project> 里，我们用到的技术栈如下。
 
-```markdown
-- [Tsup](https://tsup.egoist.dev/) as a TypeScript universal package.
-- [Tsx](https://github.com/esbuild-kit/tsx) as a Node.js enhanced with esbuild to run TypeScript & ESM
-- [Tsd](https://github.com/SamVerschueren/tsd) as type test runner
-- [Tsdoc](https://tsdoc.org/) as document
-- [PNPM](https://pnpm.io/workspaces) as workspace manager and package manager.
-- [Vitest](https://vitest.dev/) as a test runner.
-- [Size Limit](https://github.com/ai/size-limit) as a size limit plugin.
-- [Prettier](https://prettier.io/) as a code formatter.
-- [ESLint](https://eslint.org/) as a code linter.
-- [NX](https://nx.dev) as cacheable operations.
-- [Changesets](https://github.com/changesets/changesets/) as a way to manage changes and releases.
-- [c8](https://www.npmjs.com/package/c8) as coverage
-- [supertest](https://www.npmjs.com/package/supertest) as server test
-- [cypress](https://www.cypress.io/) as e2e test
-```
+> - [Tsup](https://tsup.egoist.dev/) as a TypeScript universal package.
+> - [Tsx](https://github.com/esbuild-kit/tsx) as a Node.js enhanced with esbuild to run TypeScript & ESM
+> - [Tsd](https://github.com/SamVerschueren/tsd) as type test runner
+> - [Tsdoc](https://tsdoc.org/) as document
+> - [PNPM](https://pnpm.io/workspaces) as workspace manager and package manager.
+> - [Vitest](https://vitest.dev/) as a test runner.
+> - [Size Limit](https://github.com/ai/size-limit) as a size limit plugin.
+> - [Prettier](https://prettier.io/) as a code formatter.
+> - [ESLint](https://eslint.org/) as a code linter.
+> - [NX](https://nx.dev) as cacheable operations.
+> - [Changesets](https://github.com/changesets/changesets/) as a way to manage changes and releases.
+> - [c8](https://www.npmjs.com/package/c8) as coverage
+> - [supertest](https://www.npmjs.com/package/supertest) as server test
+> - [cypress](https://www.cypress.io/) as e2e test
 
 运行TS的4个（已讲过）
 
@@ -46,7 +44,7 @@
 4. Prettier
 5. Changesets
 
-其中ESLint和Prettier前端同学都熟悉，这里就细讲了。
+其中ESLint和Prettier前端同学都熟悉，这里就不细讲了。
 
 - ESLint是一个用于JavaScript和JSX代码的静态代码分析工具。它可以帮助开发者在编写代码的过程中发现并修复潜在的问题，以确保代码的质量和一致性。
 - Prettier是一个代码格式化工具，用于自动格式化代码以保持一致的代码风格。它支持多种编程语言，包括JavaScript、CSS、HTML、JSON等。Prettier可以帮助开发者快速、准确地格式化代码，提高代码的可读性和可维护性。它可以与其他代码检查工具（如ESLint）配合使用，以确保代码的质量和一致性。
@@ -81,15 +79,15 @@ pnpm在2018年发布，作为npm的更快速和更高效的替代品。
 
 pnpm使用的是npm version 2.x类似的树形结构，同时使用.pnpm 以平铺的形式储存着所有的包。这里的.pnpm为虚拟存储目录，该目录通过`<package-name>@<version>`来实现相同模块不同版本之间隔离和复用，由于它只会根据项目中的依赖生成，并不存在提升，所以它不会存在之前提到的**Phantom dependencies**问题！
 
-然后使用Store + Links和文件资源进行关联。简单说pnpm把会包下载到一个公共目录，如果某个依赖在 store 目录中存在了话，那么就会直接从 store 目录里面去 hard-link，避免了二次安装带来的时间消耗，如果依赖在 store 目录里面不存在的话，就会去下载一次。
+然后使用Store + Links和文件资源进行关联。简单说pnpm会把包下载到一个公共目录，如果某个依赖在 store 目录中存在了话，那么就会直接从 store 目录里面去 hard-link，避免了二次安装带来的时间消耗，如果依赖在 store 目录里面不存在的话，就会去下载一次。
 
 通过Store + hard link的方式，不仅解决了项目中的NPM doppelgangers问题，项目之间也不存在该问题，从而完美解决了npm3+和yarn中的包重复问题！
 
 ![Untitled](img/Untitled%204.png)
 
 pnpm除了安装速度快，节省磁盘空间，避免幽灵依赖等优化，也内置了对monorepo的支持。使用起来比较简单，在项目根目录中新建pnpm-workspace.yaml文件，并声明对应的工作区就好。
 
-```tsx
+```bash
 $ cat pnpm-workspace.yaml
 packages:
   - 'example'
@@ -99,11 +97,11 @@ packages:
 
 剩下的就是运行时处理。之前nx run-many解决了monorepo子模块运行的问题。很多时候我们需要在根目录执行某个项目 的构建脚本，需要通过—filter或-F过滤之后，再执行，示例如下。
 
-```tsx
+```bash
 $ pnpm -F example dev
 ```
 
-以上都是pnpm的有点，其实pnpm的演进还是比较快的，比如pnpm v7和pnpm v8版本差异还是比较大的，且不完全兼容。但整个社区是比较活跃的，
+以上都是pnpm的优点，其实pnpm的演进还是比较快的，比如pnpm v7和pnpm v8版本差异还是比较大的，且不完全兼容。但整个社区是比较活跃的，
 
 <aside>
 💡 都说Node.js和前端复杂，其实是背后工程复杂度导致的，如果没有这么多依赖，这么多版本，也不会出现幻影依赖这样的问题。其实，对用的人来说无感的，我就用pnpm v8，像其他社区一样，也没问题的。真正的问题是Node.js和前端变化太快，你在较短时间内，总可能会遇到pnpm v7的代码，甚至互相切换。
@@ -129,7 +127,7 @@ $ pnpm -F example dev
 
 先写一个简单的Koa的Hello world。见app.js
 
-```tsx
+```js
 import Koa from "koa";
 const app = new Koa();
 
@@ -143,15 +141,15 @@ export default app;
 
 再写一个测试脚本，run.js
 
-```tsx
+```js
 import app from "./index.js";
 
 app.listen(3000);
 ```
 
 此时，执行node run.js就可以启动服务了。然后我们看一下测试如何编写。
 
-```tsx
+```js
 import { expect, test } from "vitest";
 import supertest from "supertest";
 import app from "./index.js";
@@ -167,7 +165,7 @@ test("koa app", async () => {
 
 这个代码和我们在Node.js v20的test runner里几乎是一模一样的。通过下面命令即可运行测试。
 
-```tsx
+```bash
 $ npx vitest run
 
  RUN  v0.34.6 /Users/alfred/workspace/npmstudy/vitest-with-supertest
@@ -190,13 +188,13 @@ $ npx vitest run
 
 安装
 
-```tsx
+```bash
 $ npm install cypress --save-dev --registry=https://registry.npmmirror.com
 ```
 
 通过npx cypress open打开。
 
-```tsx
+```bash
 $ npx cypress open
 It looks like this is your first time using Cypress: 13.3.0
 
@@ -217,7 +215,7 @@ DevTools listening on ws://127.0.0.1:54097/devtools/browser/dc560ea2-0aad-47a4-9
 
 修改代码，手动执行node run.js启动服务。
 
-```tsx
+```js
 describe("template spec", () => {
   it("passes", () => {
     cy.visit("http://127.0.0.1:3000");
@@ -230,7 +228,7 @@ describe("template spec", () => {
 
 为了简化操作，我们把启动服务放到cypress.config.js里。
 
-```tsx
+```js
 import { defineConfig } from "cypress";
 import app from "./index.js";
 export default defineConfig({
@@ -248,7 +246,7 @@ export default defineConfig({
 
 此时，执行结果如下。
 
-```tsx
+```bash
 $ npx cypress run
 
 DevTools listening on ws://127.0.0.1:61755/devtools/browser/0a2f2716-10cb-49b9-a2c9-5163469574e9
@@ -364,7 +362,7 @@ nx 会计算当前执行的 target 的 Hash 作为 cache key，在 target 执行
 
 比如依赖如下。
 
-```tsx
+```bash
 $ pnpm project-graph
 
 > your-node-v20-monorepo-project@ project-graph /Users/alfred/workspace/npmstudy/your-node-v20-monorepo-project
@@ -379,13 +377,17 @@ nx除了本地换成，其实还支持云服务（remote cache）。即nx.app，
 
 ![Untitled](img/Untitled%2015.png)
 
-在<https://github.com/npmstudy/your-node-v20-monorepo-project> 项目里，我们其实只用了非常简单的npm nx run-many
+在<https://github.com/npmstudy/your-node-v20-monoreopo-project> 项目里，我们其实只用了非常简单的npm nx run-many
 
-```tsx
-   "build": "nx run-many -t build",
+```json
+{
+  "scripts": {
+    "build": "nx run-many -t build",
     "build:fast": "nx run-many -t build:fast",
     "dev": "nx run-many -t dev",
     "test": "nx run-many -t test",
+  }
+}
 ```
 
 虽然多了一个nx模块，但执行的时候能够利用本地缓存，加快打包、测试速度，已经是非常好的事儿。

src/6/6.3.md

@@ -13,7 +13,7 @@
 
 我之所以了解tsd，是因为阅读fastify源码，翻它的package.json：[https://github.com/fastify/fastify/blob/main/package.json#L184](https://github.com/fastify/fastify/blob/main/package.json#L184)。
 
-其实还有更加轻量级的<https://github.com/mrazauskas/tsd-lite，我是在翻jest中expect模块的时候找见的，地址[https://github.com/jestjs/jest/blob/main/packages/expect/package.json>](<https://github.com/jestjs/jest/blob/main/packages/expect/package.json)。>
+其实还有更加轻量级的<https://github.com/mrazauskas/tsd-lite>，我是在翻jest中expect模块的时候找见的，地址<https://github.com/jestjs/jest/blob/main/packages/expect/package.json>。
 
 另外，《开放式协作:开源软件的生产与维护》也是不错的，值得一读。