Skip to content
This repository was archived by the owner on Sep 30, 2020. It is now read-only.

zh-CN translation #794

Merged
merged 2 commits into from
Apr 28, 2017
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 7 additions & 5 deletions zh-CN/contribute.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,9 +8,9 @@ title: 为 Rust 语言做贡献 · Rust 程序设计语言
您已经开始学习 Rust 语言。依恋它,想要与它相拥。
如果您不确定如何参与到贡献当中,这样页面可以帮助您。

**发现了一个大漏洞 (bug),如何报告?** [漏洞报告指南][bugs]. 在此感谢您的建言。
**发现了一个大漏洞 (bug),如何报告?** [漏洞报告指南][bugs]。在此提前致谢!

Rust有一个庞大的项目系统,其中最突出的是由 [Rust 开发者][devs]在的GitHub上维护的[rust-lang][rust-lang]。
Rust 有一个庞大的项目系统,其中最突出的是由 [Rust 开发者][devs]在的GitHub上维护的 [rust-lang 组织][rust-lang]。
如果您刚刚开始贡献之旅,您可能对项目的 [CONTRIBUTING.md] 文件感兴趣,
它解释了对 [rust-lang/rust] 的贡献的机制。

Expand All @@ -23,12 +23,14 @@ Rust有一个庞大的项目系统,其中最突出的是由 [Rust 开发者][d
不只限于官方文档——库、博客及其他非官方的消息来源。
* [社区建设](contribute-community.html)
帮助你在 Rust 中的手足同胞,以及壮大 Rust。
* [工具、集成开发环境以及infrastructure](contribute-tools.html):
* [工具、集成开发环境以及基础设施](contribute-tools.html):
语言的实用与人性化是一门好的语言的关键所在。
* [库](contribute-libs.html):
Rust 对任何特定任务的适用性主要取决于那些高质量库的可用性。
* [语言、编译器和标准库](contribute-compiler.html):
语言设计、 功能实现、 性能的改善。
* [语言、编译器和标准库](contribute-compiler.html):
语言设计、功能实现、性能的改善。
* [国际化](contribute-translations.html):
通过翻译我们的网站至别的语言来传播 Rust。

如果您需要额外的指导请参考 [#rust-internals] 或 [internals.rust-lang.org]。

Expand Down
55 changes: 31 additions & 24 deletions zh-CN/documentation.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,19 +5,19 @@ title: Rust 语言文档 · Rust 程序设计语言

# Rust 语言文档

如果您还不了解 Rust ,那么请先阅读 [Rust 程序设计语言][book]。
它将会帮您理清思路: Rust 是什么样的语言、如何安装它、以及它的语法概念(syntax and concepts)。
如果您还不了解 Rust那么请先阅读 [Rust 程序设计语言][book]。
它将会帮您理清思路:Rust 是什么样的语言、如何安装它、以及它的语法概念(syntax and concepts)。
在看完本书后,您将成为一个登堂入室(intermediate)的 Rust 开发人员,并将很好地理解 Rust 背后的基本理念。

## 学习 Rust

[Rust 程序设计语言][book]: Rust 相关的所有主题最全面的资料,重要的官方文档。
[Rust 程序设计语言][book]:Rust 相关的所有主题最全面的资料,重要的官方文档。

[在实践中学 Rust][rbe]: 关于各种主题的 Rust 示例的合集,可在线预览。
[在实践中学 Rust][rbe]:关于各种主题的 Rust 示例的合集,可在线预览。

[Rust 高级教程][nomicon]: 为高级 Rust 工程师准备的专门讲解如何编写不安全的Rust代码的书
[Rust 高级教程][nomicon]:为高级 Rust 工程师准备的专门讲解如何编写不安全的 Rust 代码的书

[学习 Rust][rust-learning]: 由社区维护、收集的学习 Rust 资料合集。
[学习 Rust][rust-learning]:由社区维护、收集的学习 Rust 资料合集。

[常见问题][faq]

Expand All @@ -29,55 +29,62 @@ title: Rust 语言文档 · Rust 程序设计语言

## 参考文献

[标准库][api]: Rust 标准库文档
[标准库][api]:Rust 标准库文档

[Rust 语言参考手册][ref]: 当Rust还没有一个语言规范的时候,这个文档对它进行了尽可能详尽的描述。
不过当有文档的时候某些内容可能已经过时了。
[docs.rs]:发布到 [crates.io] 的所有包的文档。

[语法索引][syn]: 本索引中包含 Rust 中与《Rust 程序设计语言》的部分交叉引用的所有语法示例。
[Rust 语言参考手册][ref]:当 Rust 还没有一个语言规范的时候,这个文档对它进行了尽可能详尽的描述。
不过某些内容可能已经过时了。

[Cargo 使用指导][cargo]: Cargo(Rust 的包管理器)的文档
[语法索引][syn]:本索引中包含 Rust 中与《Rust 程序设计语言》的部分交叉引用的所有语法示例

[Cargo 使用指导][cargo]:Cargo(Rust 的包管理器)的文档。

[编译器错误索引][err]: 编译器生成错误报告的扩展说明。
[编译器错误索引][err]:Rust 编译器生成错误报告的扩展说明。

[版本维护文档][release_notes]: 每次发布期间所做更改的记录文档。
[版本维护文档][release_notes]:每次发布期间所做更改的记录文档。

[平台支持][platform_support]:不同等级的平台支持列表。

[api]: https://doc.rust-lang.org/std/
[syn]: https://doc.rust-lang.org/book/syntax-index.html
[ref]: https://doc.rust-lang.org/reference.html
[cargo]: http://doc.crates.io/guide.html
[err]: https://doc.rust-lang.org/error-index.html
[release_notes]: https://github.com/rust-lang/rust/blob/stable/RELEASES.md
[docs.rs]: https://docs.rs
[crates.io]: https://crates.io
[platform_support]: https://forge.rust-lang.org/platform-support.html

## Rust 项目政策与策略

[Rust 安全策略][security]。该项目策略,修复和披露安全相关问题策略
[Rust 安全策略][security]:该项目关于报告、修复和披露安全相关问题的策略

[Rust 版权和商标政策][legal]。 Rust的版权归 Rust 项目开发者所有,其商标归 Mozilla 所有。
改政策描述了 Rust 的商标的使用范畴
[Rust 版权和商标政策][legal]:Rust 的版权归 Rust 项目开发者所有,其商标归 Mozilla 所有。
该政策描述了 Rust 商标的使用范畴

[社区行为规范][coc]适用于包括但不仅限于 GitHub 上的 Rust-lang 组织,
[社区行为规范][coc]适用于包括但不仅限于 GitHub 上的 Rust-lang 组织,
官方论坛,IRC 通道的所有 Rust 社区。

[security]: security.html
[legal]: legal.html
[coc]: https://www.rust-lang.org/conduct.html

## 开发版与测试版文档
## 开发版(nightly) 与 测试版(beta) 文档

除了上面链接的稳定文档外,大多数官方Rust文档也可用于[开发版][nightly][测试版][beta]。
除了上面链接的稳定文档外,大多数官方 Rust 文档也可用于 [开发版(nightly)][nightly][测试版(beta)][beta]。

[nightly]: https://doc.rust-lang.org/nightly/
[beta]: https://doc.rust-lang.org/beta/

## 母语文献

如果您需要非英语的本土化资料请[点击这里][locale]。
中文文献可以快速链接到:
[简体中文][locale-zh-CN]
[台灣正體][locale-zh-TW]
如果您需要非英语的本土化资料请[点击这里][locale]。

中文文献可以快速链接到:
- [简体中文][locale-zh-CN]
- [台灣正體][locale-zh-TW]

[locale]: https://github.com/ctjhoa/rust-learning#locale-links
[locale-zh-CN]: https://kaisery.gitbooks.io/rust-book-chinese/content/
[locale-zh-TW]: http://askeing.github.io/rust-book/
[locale-zh-TW]: http://askeing.github.io/rust-book/