Skip to content

Commit

Permalink
Correct translation for src/what-is-rustdoc.md
Browse files Browse the repository at this point in the history
  • Loading branch information
binlingyu committed Apr 15, 2024
1 parent 4ad4881 commit b84916e
Showing 1 changed file with 5 additions and 5 deletions.
10 changes: 5 additions & 5 deletions src/what-is-rustdoc.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,15 +39,15 @@ $ rustdoc src/lib.rs

现在有两个问题:第一,为什么我们的包名字是“lib”?第二,为什么没有任何内容?

第一个问题的原因是因为 `rustdoc` 试图更好用,像 `rustc` 就假定我们 crate 的名字就是 crate 根目录文件的名字。为了修复这个问题,可以通过命令行传递参数:
第一个问题的原因是因为 `rustdoc` 试图更好用,像 `rustc`, 就假定我们 crate 的名字就是 crate 根目录文件的名字。为了修复这个问题,可以通过命令行传递参数:

```bash
$ rustdoc src/lib.rs --crate-name docs
```

现在,`doc/docs/index.html` 文件生成,页面名称为“Crate docs”。
现在,将生成`doc/docs/index.html` 文件,页面名称为“Crate docs”。

对于第二个问题,因为我们的函数 `foo` 不是公共的`rustdoc` 默认只会为公共函数生成文档,如果我们将代码修改为
对于第二个问题,因为我们的 `foo` 函数不是公共的`rustdoc` 默认只会为公共函数生成文档,如果我们将代码修改为

```rust
/// foo is a function
Expand Down Expand Up @@ -81,12 +81,12 @@ dependency=<path>/docs/target/debug/deps

它会自动生成正确的 crate 名称 `--crate-name`,同时指向 `src/lib.rs`。但是其他的参数表示什么呢?

- `-o` 控制文档的输出。不使用顶层的 `doc` 目录,Cargo 会把生成的文档生成在 `target`。这是 Cargo 项目的惯用生成文件的位置
- `-o` 控制文档的输出。请注意,Cargo 会把生成的文档放在`target`目录,而不是顶层的 `doc` 目录,。这是 Cargo 项目中生成文件的惯用位置
- `-L` 帮助 rustdoc 找到代码的依赖,如果我们的项目有依赖,也会生成依赖的文档。

## Outer 和 inner 文档

`///` 语法用来对下面一个 item 生成文档,所以称为 outer 文档。还有语法`//!`,用来生成 item 内部的文档,也叫做 inner 文档,通常用来对整个 crate 生成文档,因为是 crate 的根,没有 item 在前面。所以为了生成整个 crate 的文档,你需要这样用 `//!`
`///` 语法用来对下面一个 item 生成文档,所以称为 outer 文档。还有另一种语法:`//!`,用来生成 item 内部的文档,叫做 inner 文档,通常用来对整个 crate 生成文档,因为是 crate 的根,没有 item 在前面。所以为了生成整个 crate 的文档,你需要使用 `//!`语法,例如

```rust
//! This is my first rust crate
Expand Down

0 comments on commit b84916e

Please sign in to comment.