Update Ch14

This commit is contained in:
Unisko PENG 2023-04-23 17:43:17 +08:00
parent 77ec6d6333
commit 13ffbea2df
2 changed files with 3 additions and 3 deletions

View File

@ -293,7 +293,7 @@ art = { path = "../art" }
清单 14-4 中用到 `art` 代码箱代码的作者,不得不搞清楚 `PrimaryColor` 是在 `kinds` 模组中,及 `mix` 函数是在 `utils` 模组中。`art` 代码箱的模组结构(即模组树),相比于用到该代码箱的开发者,与在 `art` 代码箱上编写代码的开发者要更为密切。对于试图搞清楚怎样使用 `art` 代码箱的人来说,其内部组织结构并未包含任何有用信息,而因为要用到他的开发者,不得不搞明白要在那里去查看,且必须在 `use` 语句中指明那些模组名字,这反而会造成混乱。
要从公开 API 中移除内部组织结构,咱们可把清单 14-3 中 `art` 代码箱的代码,修改为添加一些 `pub use` 语句来在顶层处重导出程序项目to re-export the iems at the top level如下清单 14-5 中所示:
要从公开 API 中移除内部组织结构,咱们可把清单 14-3 中 `art` 代码箱的代码,修改为添加一些 `pub use` 语句来在顶层处重导出程序项目to re-export the items at the top level如下清单 14-5 中所示:
文件名:`src/lib.rs`
@ -312,11 +312,11 @@ pub mod utils;
*清单 14-5添加 `pub use` 语句来重导出程序项目*
如下图 14-04 中所示,`cargo doc` 为此代码箱所产生出的 API 文档,现在就会在首页上,列出并链接到那些重导出的程序项目,令到 `PrimaryColor``SecondaryColor` 两个类型,以那个 `mix` 函数更易于找到。
如下图 14-04 中所示,`cargo doc` 为此代码箱所产生出的 API 文档,现在将在首页上列出并链接到重导出项,从而令到 `PrimaryColor``SecondaryColor` 两个类型及 `mix` 函数更易于找到。
![列出了重导出项目的 `art` 代码箱文档首页](images/14-04.png)
*图 14-4列出重导出项`art` 代码箱文档首页*
*图 14-4列出重导出项的 `art` 代码箱文档首页*
这个 `art` 代码箱的用户,仍然能象下面清单 14-4 中所演示的那样,看到并使用清单 14-3 中的内部结构,抑或他们可以使用清单 14-5 中那种更为便利的结构,如下清单 14-6 中所示:

Binary file not shown.

Before

Width:  |  Height:  |  Size: 142 KiB

After

Width:  |  Height:  |  Size: 219 KiB