1.介绍.html
我们使用了mut来使x可变：再（在） Rust 中绑定是默认是不可变的。在下面的例子中这个 vector 是可变的。

https://kaisery.gitbooks.io/rust-book-chinese/content/content/Benchmark%20tests%20基准测试.html

Search: 对于大的只 Replace to: 对于大的值

可以添加一个术语中英文对照表，以统一翻译。也方便贡献者对已有的不当翻译做修订。

rustcc/RustPrimer#1

难道不是应该翻译成外部函数接口么？

你这里翻译的5.8章和现在官网上stable的5.8章似乎有比较大的出入?

内容

电子书
[GitBook.com](https://www.gitbook.com/book/kaisery/rust-book-chinese)上的电子书中文字体已有所改善，请优先去这里下载:)
请使用 [GitBook](https://github.com/GitbookIO/gitbook) 来生成电子书。

问题

似乎也没有找到下载以及生成电子书pdf的方式，url好像也失效了。

发现有些地方跟英文版本的原文不对应，比如 5.3 原生类型这一节里面第87行是这么写的:

你可以用a.len()来获取a中元素的数量，用a.iter()在循环中迭代所有元素。下面的代码会按顺序打印每一个元素：

而我在现在官方的book的对应章节看到的是这样的:

You can get the number of elements in an array a with a.len():

有些句子官方的文档里面已经删掉了，我们这边的翻译要不要对应更新 ?

“target-triple" 是 编译器的 专用术语，用 “ cpu- vendor- os" 来标识 交叉编译时的 系统类型， clang, gcc 都有用。 如下几个链接可以参考:
http://clang.llvm.org/docs/CrossCompilation.html#target-triple
https://www.gnu.org/software/autoconf/manual/autoconf-2.65/html_node/Specifying-Target-Triplets.html
http://wiki.osdev.org/Target_Triplet

翻译成“目标三围”感觉体现不出这个意思呢。

然而我也没有想到和找到比较好的翻译方式，^_^

文档中许多链接已经失效，或者引向英文Rust Book。建议全部更新为GitBook中的固定连接。如章节5.7，5.8，5.16等

英文版：Your code after this point needs to rely on not being in this bad state.
中文版：之后的代码的运行依赖于处于这种有害状态

中文版本应该是少了一个否定词。

...prints the file and line number of where that dbg! macro call occurs in your code...

被翻译为

...打印出你代码中 dbg! 宏调用的文件和行号...

这个说法看起来像是“dbg!宏调用了一个文件”，翻译为“...打印出你代码中调用 dbg! 宏时所在的文件和行号...”会不会更好一点？

另外

so we use a reference to dbg! in the next call.

这个原文似乎本身就有问题……代码中是给 dbg! 传递了一个引用，而不是使用了一个指向 dbg! 的引用，翻译为

所以我们在下一次调用中使用对 dbg! 的引用

是不符合代码的。是不是可以翻译时修正这个原文的错误，改为“ 所以我们在下一次调用 dbg! 时传递一个引用”

unit-like struct被翻译为“类单元结构体”，但在介绍这个概念的最后一句话中，它被翻译成了“类似unit的结构体”

4.8小节中的copy部分，primitive type被翻译为了基本类型，而在之前翻译为原生类型，如4.3小节标题。

我也想加入 :)

提示如下：

Template render error: (E:\libs\rust-book-chinese\content\Macros 宏.md) [Line 12
7, Column 9]
  unexpected token: . (In file 'content/Macros 宏.md')

源码如下：

macro_rules! foo {
    () => {{
        ...
    }}
}

建议在第一次增加dependencies的位置，以“”译者注“之类的形式增加cargo mirror的说明。

对于不会翻墙的人，直接就放弃rust了。对于能翻墙的人，也可能某些时候没法翻墙，比如我现在在公司。

https://www.v2ex.com/t/970748

而且还声称出处是自己网站上的，虽然这个网站上的内容也是开源社区的，和他没关系

5# 另外，www.rustwiki.org.cn 这个网站一直是我个人在出钱维护，页面左下角有备案号，大家也可以直接在备案系统查询到。

preface.md 的 rustbook.cn 这个链接已经失效了的样子（现在指向的链接惨不忍睹 😂），是不是拿掉比较好...

有些变形，应该把在线阅读的html标签内部的lang="zh-tw"改为lang="zh-Hans"。

这样会好看一点。

我们写的算法(Rust语言版)
http://arust.mydoc.io/

问一下有计划更新到1.10-stable么？

也许我可以掺乎掺乎，经验上看，翻译一下“* programming language”是个很好的学习方法：）

我们写的算法(Rust语言版)
http://arust.mydoc.io/

http://kaisery.gitbooks.io/rust-book-chinese/content/content/4.2.Testing%20%E6%B5%8B%E8%AF%95.html

文档测试

就像这样：
https://github.com/t123yh/rust-book-chinese/blob/patch-1/content/2.3.Hello%2C%20Cargo!.m
这样便于追踪官方文档的更新并作出对应的修改。

个人总结：中文教程与英语教程最显著的区别是，英语教程几乎每句都会用到 "let's" "we should" "we can" "your project"，但阅遍名书名译（技术书籍），鲜见“让我们”“我们应该”“我们可以”“你的项目”等词语。中文这样的用法应该很少见吧。翻译此类文档我觉得应该去掉此类词语。

“The XX Programming Language” 这样的表达在国内的标准译法是： XX 程序设计语言。这在出版物中都已是公认的译法，比如：
K&R的 The C Programming Language 为《C 程序设计语言》，
Bjarne Stroustrup 的 The C++ Programming Language 为《C++ 程序设计语言》，
Go团队推出的著作 The Go Programming Language 为《Go 程序设计语言》，
松本行弘 的 The Ruby Programming Language 在国内也译成 《Ruby 程序设计语言》。

还有苹果官方的 The Swift Programming Language、C#之父 Anders Hejlsberg 的书籍 The C# Programming Language，Java之父 James Gosling 的书籍 The Java Programming Language等书。

The XX Programming Language 一般都是该语言的发明人或团队所出图书，通常被人称为 XX 语言的Bible，在美国一般人出书也不敢冒用此书名，在国内的《XX程序设计语言》书名也一般是留给 XX 语言的译作的。The Rust Programming Language 也一样在官方就叫此名，我们翻译书名时也应遵循官方的书名命名。

在此版中文版概述栏可填上：Rust 程序设计语言——Rust 官方教程（中文版）。
在书籍里面的内容将《Rust 编程语言》此说法全部换成《Rust 程序设计语言》。

http://kaisery.gitbooks.io/rust-book-chinese/content/content/5.34.%60Deref%60%20coercions%20%60Deref%60%E5%BC%BA%E5%88%B6%E5%A4%9A%E6%80%81.html

这对编写自定义指针类型很有用。然而，这里有一个与Deref相关的语言功能：“解引用强制多态（deref coercions）”。规则如下：如果你有一个U类型，和它的实现Deref<Target=T>，（那么）&U的值将会自动转换为&T。这是一个栗子

“栗子” 错了

比如Vector，Tuple等表示数据结构的名词，翻译成向量、元组的话不如直接使用英文直观。比如“向量”容易和数学上向量的概念混淆。
翻了一下《C++ Primer》和《Thinking in Java》这两本比较经典的入门书籍，里面关于Vector、Map、Set等数据结构，大都不进行翻译。

Slice 是否翻译为“切片”更好？
我之前接触的编程语言里只有Python有类似的功能，而这功能在Python的翻译一般翻译为“切片”。不知道其他语言怎样翻译。

Trait 这个好像是Rust特有的关键字？翻译成“特性”的话，如果我之前没了解过Rust的Trait，光看“特性”的话有点难对上这个关键字。

参考：
[1] C++ Primer 4th edition
[2] Thinking in Java 3rd edition
[3] Python教程 - 廖雪峰的翻译

rust-book-chinese/content/2.3.Hello, Cargo!.md

Cargo.tgml 的文件内容如下 => Cargo.toml

看起来高大上一些←_←

在
newtype 模式用以在外部类型上实现外部 trait
中：
Newtype 是一个源自 （U.C.0079，逃） Haskell 编程语言的概念。使用这个模式没有运行时性能惩罚，这个封装类型在编译时就被省略了。
有
（U.C.0079，逃）
与原文有出入[doge]

Rust语言中文社区 144605258
这里面也在组织book的翻译哦。