Chinese translation of The Rust Programming Language

鉴于目前网上的中文版已经滞后英文内容，所以重新开启本书翻译，跟进原书。

本仓库翻译内容包括 Rust 中文翻译项目组本身原有的翻译以及采用网上已有的开源的翻译版本（如：KaiserY/trpl-zh-cn 译本），我们尽可能避免不必要的重复劳动，我们对原译者感激不尽！

可以从 No Starch 出版社购买本书英文纸质版。

中文译版注：

1. 中文出版书名为《Rust 权威指南》，可以在线上或线下购书平台购买。
2. 出版的版本翻译独立于本仓库翻译。

在线上可以本组织官网阅读中文版（支持同一页面中英双语切换）或在 Rust 官网上阅读英文版。另外在 Rust 官网的英文版在线阅读可以选择 stable、beta 和 nightly 三个不同的分支版本，这几个分支版本可能滞后于英文仓库的最新内容。

构建这本书需要 mdBook 。执行以下命令安装：

$ cargo install mdbook

或指定安装版本：

$ cargo install mdbook --vers [version-num]

构建此书，请输入：

$ mdbook build

输出内容存放在 book 子目录中。可使用浏览器打开来查看内容。

Firefox:

$ firefox book/index.html                       # Linux
$ open -a "Firefox" book/index.html             # OS X
$ Start-Process "firefox.exe" .\book\index.html # Windows (PowerShell)
$ start firefox.exe .\book\index.html           # Windows (Cmd)

Chrome:

$ google-chrome book/index.html                 # Linux
$ open -a "Google Chrome" book/index.html       # OS X
$ Start-Process "chrome.exe" .\book\index.html  # Windows (PowerShell)
$ start chrome.exe .\book\index.html            # Windows (Cmd)

运行测试:

$ mdbook test

您的帮助，我们将感激不尽(We'd love your help)！请参见 CONTRIBUTING.md（英文原项目参与贡献指引 CONTRIBUTING-EN.md）。

我们很乐意翻译这本书！请参阅“翻译”标签（在英文原仓库）以加入当前正在进行的工作。新建一个 Issue，开始使用新语言！在我们合并任何内容之前，我们正在等待 mdbook 对多种语言的支持，只要支持后将随时可以开始！

要扫描源文件是否存在拼写错误，可以使用 ci 目录中的脚本 spellcheck.sh。这需要一个带有有效单词的字典文件，由 ci/dictionary.txt 提供。如果脚本产生误报（例如，使用了词语 BTreeMap 被脚本认为无效），则需要在 ci/dictionary.txt 中添加该单词（保持排序顺序以确保一致性）。

《Rust 程序设计语言》（中文版与英文版 The Rust Programming Language 均） 使用以下两种协议的任一种进行授权：

• Apache 2.0 授权协议，（LICENSE-APACHE 或 https://www.apache.org/licenses/LICENSE-2.0）
• MIT 授权协议 (LICENSE-MIT 或 https://opensource.org/licenses/MIT)

可以根据自己选择来定。

除非您有另外说明，否则您在本仓库提交的任何贡献均按上述方式进行双重许可授权，就如 Apache 2.0 协议所规定那样，而无需附加任何其他条款或条件。