zh-cn: fix typos in the "Book list page" guide #23082

ikenk · 2024-08-15T16:25:23Z

Description

fixed some flaws and added missing paragraphs for Express Tutorial Part 5: Displaying library data => Book list page

Motivation

fixed some flaws and added missing paragraphs

Additional details

To provide a more comprehensive understanding of the article.

Related issues and pull requests

Changes to be committed: modified: files/zh-cn/learn/server-side/express_nodejs/displaying_data/book_list_page/index.md -- fix some flaws and add missing paragraphs for Express Tutorial Part 5: Displaying library data => Book list page

github-actions · 2024-08-15T16:27:15Z

Preview URLs

/zh-CN/docs/Learn/Server-side/Express_Nodejs/Displaying_data/Book_list_page

Flaws (1)

URL: /zh-CN/docs/Learn/Server-side/Express_Nodejs/Displaying_data/Book_list_page
Title: 书本列表页面
Flaw count: 1

translation_differences:
- Differences in the important macros (0 in common of 1 possible)

(comment last updated: 2024-08-20 13:41:33)

yin1999

Hey @ikenk. I could found other issues in this document. You may want to fix them before getting it merged :)

jasonren0403

some suggestions

jasonren0403 · 2024-08-16T01:51:49Z

files/zh-cn/learn/server-side/express_nodejs/displaying_data/book_list_page/index.md

@@ -7,28 +7,27 @@ slug: Learn/Server-side/Express_Nodejs/Displaying_data/Book_list_page

 ## 控制器

-书本列表控制器函数，需要获取数据库中所有`Book`对象的列表，然后将这些对象传给模板进行呈现。
+书本列表控制器函数，需要获取数据库中所有 `Book` 对象的列表，然后将这些对象传给模板进行呈现。


Suggested change

书本列表控制器函数，需要获取数据库中所有 `Book` 对象的列表，然后将这些对象传给模板进行呈现。

书本列表控制器函数需要获取数据库中所有 `Book` 对象的列表，对它们进行排序，然后将它们传给模板进行渲染。

这里还未修改

files/zh-cn/learn/server-side/express_nodejs/displaying_data/book_list_page/index.md

jasonren0403 · 2024-08-16T01:52:59Z

files/zh-cn/learn/server-side/express_nodejs/displaying_data/book_list_page/index.md


-打开 **/controllers/bookController.js**. 找到导出的 `book_list()` 控制器方法，并替换為下面的代码。
+打开 **/controllers/bookController.js**. 找到导出的 `book_list()` 控制器方法，并替换为下面的代码。


Suggested change

打开 **/controllers/bookController.js**. 找到导出的 `book_list()` 控制器方法，并替换为下面的代码。

打开 **/controllers/bookController.js**，找到导出的 `book_list()` 控制器方法，并替换为下面的代码。

jasonren0403 · 2024-08-16T01:57:26Z

files/zh-cn/learn/server-side/express_nodejs/displaying_data/book_list_page/index.md

 ```

-该方法使用模型的`find()`函数返回所有`Book`对象，选择仅返回标题`title`和作者`author`，因为我们不需要其他字段（它也会返回`_id`和虚拟字段）。这里我们还调用`Book`上的`populate()` ，指定作者`author`字段 — 这将用完整的作者信息，替换存储的书本作者 id。
+该路由处理器调用 `Book` 模型的 `find()` 方法，仅选择返回标题 `title` 和作者 `author`，因为我们不需要其他字段（它也会返回 `_id` 和虚拟字段），然后使用 `sort()` 方法对 `title` 进行字母排序。我们还调用了 `Book` 上的 `populate()`，指定作者 `author` 字段 —— 即用完整的作者信息替换所存储书本的作者的 id。最后调用 `exec()` 来执行查询操作并返回一个 **Promise**。


Suggested change

该路由处理器调用 `Book` 模型的 `find()` 方法，仅选择返回标题 `title` 和作者 `author`，因为我们不需要其他字段（它也会返回 `_id` 和虚拟字段），然后使用 `sort()` 方法对 `title` 进行字母排序。我们还调用了 `Book` 上的 `populate()`，指定作者 `author` 字段 —— 即用完整的作者信息替换所存储书本的作者的 id。最后调用 `exec()` 来执行查询操作并返回一个 **Promise**。

该路由处理器调用 `Book` 模型的 `find()` 方法，仅选择返回标题 `title` 和作者 `author`，因为我们不需要其他字段（它也会返回 `_id` 和虚拟字段），然后使用 `sort()` 方法对 `title` 进行字母排序。我们还调用了 `Book` 上的 `populate()`，指定作者 `author` 字段——即用完整的作者信息替换所存储书本的作者的 id。最后链式调用 `exec()` 来执行查询操作并返回一个 **Promise**。

jasonren0403 · 2024-08-16T01:58:16Z

files/zh-cn/learn/server-side/express_nodejs/displaying_data/book_list_page/index.md

-该方法使用模型的`find()`函数返回所有`Book`对象，选择仅返回标题`title`和作者`author`，因为我们不需要其他字段（它也会返回`_id`和虚拟字段）。这里我们还调用`Book`上的`populate()` ，指定作者`author`字段 — 这将用完整的作者信息，替换存储的书本作者 id。
+该路由处理器调用 `Book` 模型的 `find()` 方法，仅选择返回标题 `title` 和作者 `author`，因为我们不需要其他字段（它也会返回 `_id` 和虚拟字段），然后使用 `sort()` 方法对 `title` 进行字母排序。我们还调用了 `Book` 上的 `populate()`，指定作者 `author` 字段 —— 即用完整的作者信息替换所存储书本的作者的 id。最后调用 `exec()` 来执行查询操作并返回一个 **Promise**。
+
+路由处理器使用 `await` 来等待 **Promise**，代码会暂停执行直到它被解决。如果 **Promise** 被兑现，查询结果就会被存储到 `allBooks` 变量中去，并继续执行后续代码。


Suggested change

路由处理器使用 `await` 来等待 **Promise**，代码会暂停执行直到它被解决。如果 **Promise** 被兑现，查询结果就会被存储到 `allBooks` 变量中去，并继续执行后续代码。

路由处理器使用 `await` 来等待 **Promise**，代码会暂停执行直到它被兑现。如果 **Promise** 被兑现，查询结果就会被存储到 `allBooks` 变量中，并继续执行后续代码。

jasonren0403 · 2024-08-16T02:03:02Z

files/zh-cn/learn/server-side/express_nodejs/displaying_data/book_list_page/index.md

 ```

-這个视图扩展了 **layout.pug** 基本模板，并覆盖了名为 '**content**' 的區块 `block` 。它显示我们从控制器传入的标题`title`（通过`render()`方法），然后使用`each`-`in`-`else`语法，遍历`book_list`变量。为每本图书创建一个列表项，以显示书名，并作为书的详细信息页面的链接，后面跟着作者姓名。如果`book_list`中没有书，则执行`else`子句，并显示文字“没有书” 'There are no books.'。
+这个视图扩展了 **layout.pug** 基本模板，并覆盖了名为 '**content**' 的区块 `block` 。它显示了我们从控制器传入的标题 `title`（通过 `render()` 方法），然后使用 `each`-`in` 语法，遍历 `book_list` 变量。为每本图书创建一个列表项，以显示书名，并作为书的详细信息页面的链接，后面跟着作者姓名。如果 `book_list` 中没有书，则执行 `else` 子句，并显示文字 'There are no books.'。


Suggested change

这个视图扩展了 **layout.pug** 基本模板，并覆盖了名为 '**content**' 的区块 `block` 。它显示了我们从控制器传入的标题 `title`（通过 `render()` 方法），然后使用 `each`-`in` 语法，遍历 `book_list` 变量。为每本图书创建一个列表项，以显示书名，并作为书的详细信息页面的链接，后面跟着作者姓名。如果 `book_list` 中没有书，则执行 `else` 子句，并显示文字 'There are no books.'。

这个视图扩展了 **layout.pug** 基本模板，并覆盖了名为“**content**”的区块（`block`）。它显示了我们从控制器传入的标题 `title`（通过 `render()` 方法），然后使用 `each`-`in` 语法遍历 `book_list` 变量，为每本图书创建一个列表项，以显示书名，并作为书的详细信息页面的链接，后面跟着作者姓名。如果 `book_list` 中没有书，则执行 `else` 子句，并显示文本“There are no books.”。

jasonren0403 · 2024-08-16T02:03:42Z

files/zh-cn/learn/server-side/express_nodejs/displaying_data/book_list_page/index.md


 > [!NOTE]
-> 我们使用 `book.url` ，为每本书提供详细记录链接（我们已经实现了此路由，但尚未实现此页面）。这是 `Book` 模型的一个虚拟属性，它使用模型实例的 `_id` 字段，生成唯一的 URL 路径。
+> 我们使用 `book.url`，为每本书提供详细记录的链接（我们已经实现了此路由，但尚未实现此页面）。这是 `Book` 模型的一个虚拟属性，它使用模型实例的 `_id` 字段，生成唯一的 URL 路径。


Suggested change

> 我们使用 `book.url`，为每本书提供详细记录的链接（我们已经实现了此路由，但尚未实现此页面）。这是 `Book` 模型的一个虚拟属性，它使用模型实例的 `_id` 字段，生成唯一的 URL 路径。

> 我们使用 `book.url` 为每本书提供详细记录的链接（我们已经实现了此路由，但尚未实现此页面）。这是 `Book` 模型的一个虚拟属性，它使用模型实例的 `_id` 字段，生成唯一的 URL 路径。

jasonren0403 · 2024-08-16T02:04:42Z

files/zh-cn/learn/server-side/express_nodejs/displaying_data/book_list_page/index.md


 > [!NOTE]
-> 我们使用 `book.url` ，为每本书提供详细记录链接（我们已经实现了此路由，但尚未实现此页面）。这是 `Book` 模型的一个虚拟属性，它使用模型实例的 `_id` 字段，生成唯一的 URL 路径。
+> 我们使用 `book.url`，为每本书提供详细记录的链接（我们已经实现了此路由，但尚未实现此页面）。这是 `Book` 模型的一个虚拟属性，它使用模型实例的 `_id` 字段，生成唯一的 URL 路径。

 在这里，我們感兴趣的是，每本书被定义为两行，第二行使用管道（上面高亮显示）。这种方法是必要的，因为如果作者姓名位于上一行，那么它将成为超链接的一部分。


Suggested change

在这里，我們感兴趣的是，每本书被定义为两行，第二行使用管道（上面高亮显示）。这种方法是必要的，因为如果作者姓名位于上一行，那么它将成为超链接的一部分。

值得注意的是，每本书被定义为两行，第二行使用管道。这种方法是必要的，因为如果作者姓名位于上一行，那么它将成为超链接的一部分。

jasonren0403 · 2024-08-16T02:06:16Z

files/zh-cn/learn/server-side/express_nodejs/displaying_data/book_list_page/index.md


 在这里，我們感兴趣的是，每本书被定义为两行，第二行使用管道（上面高亮显示）。这种方法是必要的，因为如果作者姓名位于上一行，那么它将成为超链接的一部分。

 ## 它看起來像是？

-运行本应用 (参见 [测试路由](/zh-CN/docs/Learn/Server-side/Express_Nodejs/routes#Testing_the_routes) 有相关的命令) ，并打开你的浏览器，访问 <http://localhost:3000/>。然后选择 所有书本 连结。如果每样东西都设定正确了，你的网站看起来应该像底下的截图。
+运行本应用 (参见 [测试路由](/zh-CN/docs/Learn/Server-side/Express_Nodejs/routes#Testing_the_routes) 有相关的命令) ，并打开你的浏览器，访问 <http://localhost:3000/>。然后选择 _All books_ 链接。如果每样东西都设定正确了，你的网站看起来应该像底下的截图。


Suggested change

运行本应用 (参见 [测试路由](/zh-CN/docs/Learn/Server-side/Express_Nodejs/routes#Testing_the_routes) 有相关的命令) ，并打开你的浏览器，访问 <http://localhost:3000/>。然后选择 _All books_ 链接。如果每样东西都设定正确了，你的网站看起来应该像底下的截图。

运行本应用（参见[测试路由](/zh-CN/docs/Learn/Server-side/Express_Nodejs/routes#测试路由)以了解相关命令），并打开你的浏览器，访问 `http://localhost:3000/`。然后选择 _All books_ 链接。如果每样东西都设定正确了，你的网站看起来应该像底下的截图。

jasonren0403 · 2024-08-16T02:06:33Z

files/zh-cn/learn/server-side/express_nodejs/displaying_data/book_list_page/index.md


 在这里，我們感兴趣的是，每本书被定义为两行，第二行使用管道（上面高亮显示）。这种方法是必要的，因为如果作者姓名位于上一行，那么它将成为超链接的一部分。

 ## 它看起來像是？

-运行本应用 (参见 [测试路由](/zh-CN/docs/Learn/Server-side/Express_Nodejs/routes#Testing_the_routes) 有相关的命令) ，并打开你的浏览器，访问 <http://localhost:3000/>。然后选择 所有书本 连结。如果每样东西都设定正确了，你的网站看起来应该像底下的截图。
+运行本应用 (参见 [测试路由](/zh-CN/docs/Learn/Server-side/Express_Nodejs/routes#Testing_the_routes) 有相关的命令) ，并打开你的浏览器，访问 <http://localhost:3000/>。然后选择 _All books_ 链接。如果每样东西都设定正确了，你的网站看起来应该像底下的截图。

 ![Book List Page - Express Local Library site](new_book_list.png)


alt 文本要翻译

具体是指“ ”吗？
我看了这个主题下的其他的文档，它们的alt也是英文，也就是说以后全部统一改成中文是吗？

最好都翻译，现在所有文档都在逐步更新过来

jasonren0403

还有一些问题

files/zh-cn/learn/server-side/express_nodejs/displaying_data/book_list_page/index.md

jasonren0403 · 2024-08-20T01:23:11Z

files/zh-cn/learn/server-side/express_nodejs/displaying_data/book_list_page/index.md

@@ -7,28 +7,27 @@ slug: Learn/Server-side/Express_Nodejs/Displaying_data/Book_list_page

 ## 控制器

-书本列表控制器函数，需要获取数据库中所有`Book`对象的列表，然后将这些对象传给模板进行呈现。
+书本列表控制器函数，需要获取数据库中所有 `Book` 对象的列表，然后将这些对象传给模板进行呈现。


这里还未修改

jasonren0403

👍

On branch fix-typo

29d07ee

Changes to be committed: modified: files/zh-cn/learn/server-side/express_nodejs/displaying_data/book_list_page/index.md -- fix some flaws and add missing paragraphs for Express Tutorial Part 5: Displaying library data => Book list page

ikenk requested a review from a team as a code owner August 15, 2024 16:25

ikenk requested review from t7yang and removed request for a team August 15, 2024 16:25

github-actions bot added the l10n-zh Issues related to Chinese content. label Aug 15, 2024

yin1999 reviewed Aug 16, 2024

View reviewed changes

jasonren0403 requested changes Aug 16, 2024

View reviewed changes

ikenk added 2 commits August 16, 2024 12:02

根据建议进行了修改

c90e4b2

根据建议进行了修改

6154f0a

ikenk requested review from jasonren0403 and yin1999 August 16, 2024 07:29

根据建议进行了修改

00094f8

yin1999 changed the title ~~On branch fix-typo~~ zh-cn: fix typos in the "Book list page" guide Aug 19, 2024

jasonren0403 reviewed Aug 20, 2024

View reviewed changes

根据建议进行了修改

91a9cb0

ikenk force-pushed the fix-typo branch from 8d72717 to 91a9cb0 Compare August 20, 2024 13:40

jasonren0403 approved these changes Aug 21, 2024

View reviewed changes

jasonren0403 merged commit f4717b9 into mdn:main Aug 21, 2024
14 checks passed

ikenk deleted the fix-typo branch August 21, 2024 15:25

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

zh-cn: fix typos in the "Book list page" guide #23082

zh-cn: fix typos in the "Book list page" guide #23082

ikenk commented Aug 15, 2024

github-actions bot commented Aug 15, 2024 •

edited

Loading

yin1999 left a comment

jasonren0403 left a comment

jasonren0403 Aug 16, 2024

jasonren0403 Aug 20, 2024

jasonren0403 Aug 16, 2024

jasonren0403 Aug 16, 2024

jasonren0403 Aug 16, 2024

jasonren0403 Aug 16, 2024

jasonren0403 Aug 16, 2024

jasonren0403 Aug 16, 2024

jasonren0403 Aug 16, 2024

jasonren0403 Aug 16, 2024

ikenk Aug 16, 2024

jasonren0403 Aug 16, 2024 •

edited

Loading

jasonren0403 left a comment

jasonren0403 Aug 20, 2024

jasonren0403 left a comment

	书本列表控制器函数，需要获取数据库中所有 `Book` 对象的列表，然后将这些对象传给模板进行呈现。
	书本列表控制器函数需要获取数据库中所有 `Book` 对象的列表，对它们进行排序，然后将它们传给模板进行渲染。


		打开 /controllers/bookController.js. 找到导出的 `book_list()` 控制器方法，并替换為下面的代码。
		打开 /controllers/bookController.js. 找到导出的 `book_list()` 控制器方法，并替换为下面的代码。

	打开 /controllers/bookController.js. 找到导出的 `book_list()` 控制器方法，并替换为下面的代码。
	打开 /controllers/bookController.js，找到导出的 `book_list()` 控制器方法，并替换为下面的代码。

	路由处理器使用 `await` 来等待 Promise，代码会暂停执行直到它被解决。如果 Promise 被兑现，查询结果就会被存储到 `allBooks` 变量中去，并继续执行后续代码。
	路由处理器使用 `await` 来等待 Promise，代码会暂停执行直到它被兑现。如果 Promise 被兑现，查询结果就会被存储到 `allBooks` 变量中，并继续执行后续代码。

	> 我们使用 `book.url`，为每本书提供详细记录的链接（我们已经实现了此路由，但尚未实现此页面）。这是 `Book` 模型的一个虚拟属性，它使用模型实例的 `_id` 字段，生成唯一的 URL 路径。
	> 我们使用 `book.url` 为每本书提供详细记录的链接（我们已经实现了此路由，但尚未实现此页面）。这是 `Book` 模型的一个虚拟属性，它使用模型实例的 `_id` 字段，生成唯一的 URL 路径。

	在这里，我們感兴趣的是，每本书被定义为两行，第二行使用管道（上面高亮显示）。这种方法是必要的，因为如果作者姓名位于上一行，那么它将成为超链接的一部分。
	值得注意的是，每本书被定义为两行，第二行使用管道。这种方法是必要的，因为如果作者姓名位于上一行，那么它将成为超链接的一部分。

	运行本应用 (参见 [测试路由](/zh-CN/docs/Learn/Server-side/Express_Nodejs/routes#Testing_the_routes) 有相关的命令) ，并打开你的浏览器，访问 <http://localhost:3000/>。然后选择 _All books_ 链接。如果每样东西都设定正确了，你的网站看起来应该像底下的截图。
	运行本应用（参见[测试路由](/zh-CN/docs/Learn/Server-side/Express_Nodejs/routes#测试路由)以了解相关命令），并打开你的浏览器，访问 `http://localhost:3000/`。然后选择 _All books_ 链接。如果每样东西都设定正确了，你的网站看起来应该像底下的截图。

zh-cn: fix typos in the "Book list page" guide #23082

zh-cn: fix typos in the "Book list page" guide #23082

Conversation

ikenk commented Aug 15, 2024

Description

Motivation

Additional details

Related issues and pull requests

github-actions bot commented Aug 15, 2024 • edited Loading

yin1999 left a comment

Choose a reason for hiding this comment

jasonren0403 left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

jasonren0403 Aug 16, 2024 • edited Loading

Choose a reason for hiding this comment

jasonren0403 left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

jasonren0403 left a comment

Choose a reason for hiding this comment

github-actions bot commented Aug 15, 2024 •

edited

Loading

jasonren0403 Aug 16, 2024 •

edited

Loading