Skip to content

zzy/rust-cookbook-zh-cn

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
src
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Rust Cookbook 中文版   Build Status travis

《Rust Cookbook 中文版》是 Rust 程序设计语言(Rust 2018 简体中文版文档)的简要实例示例集合:展示了在 Rust 生态系统中,使用各类 crate 来完成常见编程任务的良好实践。

书中的实例都是完整的,并且经过测试,保证能正常工作,可以直接复制到你新建的 Cargo(中文文档)项目中进行使用。

注1:《Rust Cookbook 中文版》翻译自 rust-lang-nursery 团队撰写的 "A Rust Cookbook",感谢 rust-lang-nursery 团队的无私奉献!

注2:《Rust Cookbook 中文版》计划为两个阶段:
第一阶段:经仔细斟酌,形成专业、通俗、容易理解的 Rust 生态实践指南中文版本;
第二阶段:对书中代码进行详细讲解,在实际应用场景中对 Rust 生态 crate 进行分析、比较,以及拓展。
目前,第一阶段已经完成,并且和 rust-lang-nursery 团队项目同步更新。
第二阶段正在进行中,但可能需要另开一个开源项目,欢迎参与。

欢迎您提出宝贵意见:linshi@budshome.com,budshome(个人微信),晨曦中(微信公众号)。

在线阅读

在线阅读地址:《Rust Cookbook 中文版》 - http://rust-cookbook.budshome.com

离线阅读

如果你喜欢本地阅读方式,可以使用 mdBook(中文文档) 进行书籍构建:

$ git clone https://github.com/zzy/rust-cookbook-zh-cn
$ cd rust-cookbook-zh-cn
$ cargo install mdbook # 指定版本使用参数:--vers "0.3.5"
$ mdbook serve --open # 或者 mdbook build

也可以直接用你喜欢的浏览器从 book 子目录打开 index.html 文件。

$ xdg-open ./book/index.html # linux
$ start .\book\index.html    # windows
$ open ./book/index.html     # mac

测试

如果欲运行构建本书的测试组件,请执行:

测试组件需要安装一些 crate,中国大陆推荐更换默认的 Cargo 源为国内镜像源

$ cargo test

贡献

《Rust Cookbook 中文版》的目的是让 Rust 程序员新手能够更容易地参与到 Rust 社区中,因此它需要——并欢迎——你做出自己力所能及的贡献。

构建和测试

首先,从 git 克隆《Rust Cookbook 中文版》并进入目录:

git clone https://github.com/zzy/rust-cookbook-zh-cn.git
cd rust-cookbook-zh-cn

《Rust Cookbook 中文版》使用 mdBook中文文档)构建,所以需要通过 Cargo中文文档)安装它:

cargo install --version 0.3.5 mdbook

若要在本地生成和阅读《Rust Cookbook 中文版》,请运行:

mdbook serve

然后在浏览器中打开 http://localhost:3000,即可阅读本书。对源代码所做的任何更改都将自动重新生成页面,并会主动刷新浏览器,因此在编辑源码时打开浏览器窗口是很有帮助的。

书中的所有实例都是使用 skeptic 测试的,它是测试任意 markdown 文档的工具,风格类似于 rustdoc。

提交前,请对整个仓库进行测试:

cargo test

祝你学习愉快,欢迎提交问题,欢迎发送 PR。

About

《Rust Cookbook 中文版》是 rust-lang-nursery 团队撰写的 "A Rust Cookbook" 的中文版本,同步官方仓库

Topics

Resources

License

Apache-2.0, MIT licenses found

Licenses found

Apache-2.0
LICENSE-APACHE
MIT
LICENSE-MIT

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages