From 80bd37ba2379e2146f2a01ea9c2e0a3ad16800c5 Mon Sep 17 00:00:00 2001 From: sunface Date: Thu, 24 Feb 2022 14:11:32 +0800 Subject: [PATCH] update readme.md --- .DS_Store | Bin 6148 -> 6148 bytes Readme.md | 10 ++++++++- en/src/circle-refer | 1 - en/src/crate | 1 - en/src/resu | 1 - en/src/why-exercise.md | 38 ++++++++++++++++++++++++++++++++ zh-CN/Readme.md | 9 ++++++-- zh-CN/assets/CNAME | 2 +- zh-CN/deploy | 2 +- zh-CN/src/why-exercise.md | 45 ++++++++++++++++++++++++++++++++++++++ 10 files changed, 101 insertions(+), 8 deletions(-) delete mode 100644 en/src/circle-refer delete mode 100644 en/src/crate delete mode 100644 en/src/resu diff --git a/.DS_Store b/.DS_Store index e16b619aa2061ca57283a7db777c7558c4f29ac8..a35d0c07c0eb9d95e9a4113518bb117d4f3c9c47 100644 GIT binary patch literal 6148 zcmeHKOHRWu5Pg#tXkpVO8>AcnDsh8Q%7P7xasm2*B9Ri*0urpUV8>xN4ToU`Z){T$ zr>u|=LNk&59Q)1Kd5$tM0O{RL_JIz77K>uiX0^g}TuaT8(6dPt7vmO-Xsj8mAI0;Yf|@FNA7v(;K#9<4S7OaW71sepbT zQWnK5VCm6)I#{_Q0I|t#XKd^5p!%c%vw)>Xj?l!r61}U0BZhc)_NRfD1uQ*!cStyV zNSIl|2}RuOjGsC>B=cysDPRgz6=?X|j^_WP@6Z2LC%ZEROo4x;fHeE3{T?4FB`mu~2NHo}wr-0|Nsi1A_nqLoP!qgC3Af@ywZ6xSWxB@*}2XRwjlj xhK$KFO!AxeGkdUXzQC-*w3(fQp95&X=7Y@NnJ4p$SaJZ30GYwGIY49!GXNl#6_Wq} diff --git a/Readme.md b/Readme.md index 41d1b99..b671d1f 100644 --- a/Readme.md +++ b/Readme.md @@ -9,12 +9,20 @@ Greetings and welcome to `exercise.rs`， If you have the following problems: Then you have come to a right place: here you can find a bunch of easy to hard exercises to improve your Rust skills，this will help you fill the gap of easy-to-learn and hard-to-use. - ## Online Reading This book is written in English and Chinese, you can pick up the language you are familiar with: - English: [https://exercise.rs](https://exercise.rs) - 简体中文: [https://zh.exercise.rs](https://zh.exercise.rs) +## About exercises +- difficulty level: easy: 🌟 medium: 🌟🌟 hard: 🌟🌟🌟 hell: 🌟🌟🌟🌟 +- Everything is online: reading, editing, testing + +## Contributing +We welcome all kinds of contributors, especially ones who has precious exercises. + +Every exercise you have contributed will be annotated with your nickname and personal link, it's time to show yourself to the world! + ## Learning Rust If you are a first-time Rust learner, here are some high quality learning resources : - [The Book](https://doc.rust-lang.org/book/index.html) for English speakers diff --git a/en/src/circle-refer b/en/src/circle-refer deleted file mode 100644 index 04b7a8f..0000000 --- a/en/src/circle-refer +++ /dev/null @@ -1 +0,0 @@ -# Weak and Circle reference diff --git a/en/src/crate b/en/src/crate deleted file mode 100644 index e66fb06..0000000 --- a/en/src/crate +++ /dev/null @@ -1 +0,0 @@ -# Crate diff --git a/en/src/resu b/en/src/resu deleted file mode 100644 index b82dd9a..0000000 --- a/en/src/resu +++ /dev/null @@ -1 +0,0 @@ -# panic! diff --git a/en/src/why-exercise.md b/en/src/why-exercise.md index c3e5e3f..ea7c703 100644 --- a/en/src/why-exercise.md +++ b/en/src/why-exercise.md @@ -1 +1,39 @@ # Why Exercise.rs +> 中文版 [传送门](https://zh.exercise.rs) + +Greetings and welcome to `exercise.rs`， If you have the following problems: + +- After learning some rust knowledge, you want to take a step: do some exercises, but found unchallenging ones +- Found nothing about rust toolchains, std, ascyn/.await topics +- Still have no idea of what to do next, maybe you tried writing a demo /project, but... not that good or even worse: failed + +Then you have come to a right place: here you can find a bunch of easy to hard exercises to improve your Rust skills，this will help you fill the gap of easy-to-learn and hard-to-use. + +## About exercises +- difficulty level: easy: 🌟 medium: 🌟🌟 hard: 🌟🌟🌟 hell: 🌟🌟🌟🌟 +- Everything is online: reading, editing, testing + +## Contributing +We welcome all kinds of contributors, especially ones who has precious exercises. + +Every exercise you have contributed will be annotated with your nickname and personal link, it's time to show yourself to the world! + +## Learning Rust +If you are a first-time Rust learner, here are some high quality learning resources : +- [The Book](https://doc.rust-lang.org/book/index.html) for English speakers +- [Rust语言圣经(The Course)](https://course.rs) for Chinese speakers, it covers nearly all the topics in Rust + + +## difference to rustlings +[Rustlings](https://github.com/rust-lang/rustlings) only contains small and easy exercises for junior rust devs. There is a big gap between learning Rust and using it in your projects. + +Another limit for rustlings is that you have to download rustlings to local machine and compile it first before starting to learn. + +## difference to rust by example +[Rust By Example](https://doc.rust-lang.org/stable/rust-by-example/) is an excellent online book for learning Rust，`exercise.rs` has some small advantages in : + +- more topics and exercises，specially for the hard part of Rust，e.g lifetime、smart pointers、threads 、async/.await etc +- difficulty from easy to hard，it will minimize the gap between learning and using in projects +- up-to-date, e.g features which added in Rust 1.58 also have the corresponding exercises in `exercise.rs` +- Both `course.rs` and `exercise.rs` are designed according to the CS courses in college，so quliaty is the most important factor + diff --git a/zh-CN/Readme.md b/zh-CN/Readme.md index 1bc99d5..0752910 100644 --- a/zh-CN/Readme.md +++ b/zh-CN/Readme.md @@ -12,6 +12,13 @@ - English: [https://exercise.rs](https://exercise.rs) - 简体中文: [https://zh.exercise.rs](https://zh.exercise.rs) +## 关于练习题的说明 +- 难度等级: 简单: 🌟 中等: 🌟🌟 困难: 🌟🌟🌟 地狱: 🌟🌟🌟🌟 +- 一切都在线化： 阅读、编辑和测试代码，当然还包括错误提示 + +## 欢迎你，贡献者 +本项目欢迎一切贡献者，特别是怀揣题库的兄弟，你所贡献的每一道题都会注明你的昵称和个人链接，是时候让全世界看看咱的风采了。 + ## 学习 Rust 语言 我们强烈推荐在开始做练习之前，先看看 [<>]((https://course.rs)) 这本书，它覆盖了从入门到精通所需的全部知识，相信我，里面绝对有你所需要的 Rust 知识。 @@ -33,5 +40,3 @@ - 跟随 Rust 版本实时更新, - `course.rs` 和 `exercise.rs` 看域名就知道，它非常有信心才敢使用这两个针对性如此之强的域名，而信心来源于**高质量** - - diff --git a/zh-CN/assets/CNAME b/zh-CN/assets/CNAME index 2c5ea12..d893176 100644 --- a/zh-CN/assets/CNAME +++ b/zh-CN/assets/CNAME @@ -1 +1 @@ -exercise.rs \ No newline at end of file +zh.exercise.rs \ No newline at end of file diff --git a/zh-CN/deploy b/zh-CN/deploy index c1c7896..88bf719 100755 --- a/zh-CN/deploy +++ b/zh-CN/deploy @@ -15,7 +15,7 @@ git config user.email "cto@188.com" git add . git commit -m 'deploy' git branch -M gh-pages -git remote add origin https://github.com/sunface/rust-exercise +git remote add origin https://github.com/sunface/zh.exercise.rs ## push to github pages git push -u -f origin gh-pages \ No newline at end of file diff --git a/zh-CN/src/why-exercise.md b/zh-CN/src/why-exercise.md index c3e5e3f..d9707e0 100644 --- a/zh-CN/src/why-exercise.md +++ b/zh-CN/src/why-exercise.md @@ -1 +1,46 @@ # Why Exercise.rs +> 英文版 [传送门](https://exercise.rs) + +欢迎大家来到 `exercise.rs`，在来到这里之前不知道你有没有碰到过以下问题: + +- 学完知识，想要针对性的练习，但是只能找到一些不痛不痒的习题 +- 一些 Rust 工具、标准库等相关的习题更是一个都找不到 +- 做完了习题还是一片茫然，不知道下一步该做什么，上手写项目吧，发现几乎无处下手 + +如果你曾经和我有一样的问题，那来到这里就对了：**在这里你能找到大量从简单到困难的 Rust 练习题，不仅能针对性巩固你所学过的知识，解决 Rust 语言难以上手应用的问题**。 + +## 在线阅读 +本书同时提供了中文和英文版本: +- English: [https://exercise.rs](https://exercise.rs) +- 简体中文: [https://zh.exercise.rs](https://zh.exercise.rs) + +## 关于练习题的说明 +- 难度等级: 简单: 🌟 中等: 🌟🌟 困难: 🌟🌟🌟 地狱: 🌟🌟🌟🌟 +- 一切都在线化： 阅读、编辑和测试代码，当然还包括错误提示 + +## 欢迎你，贡献者 +本项目欢迎一切贡献者，特别是怀揣题库的兄弟，你所贡献的每一道题都会注明你的昵称和个人链接，是时候让全世界看看咱的风采了。 + +## 学习 Rust 语言 +我们强烈推荐在开始做练习之前，先看看 [<>]((https://course.rs)) 这本书，它覆盖了从入门到精通所需的全部知识，相信我，里面绝对有你所需要的 Rust 知识。 + +(悄咪咪的告诉咱中国用户， `exercise.rs` 章节目录和 <> 完全相同，大家猜猜为什么) + + + + +## 对比 rustlings +[Rustlings](https://github.com/rust-lang/rustlings) 只包含了一些小型的、简单的练习题，说实话并不能帮你熟悉学到的 Rust 知识，更别提帮你打通从学习到实践的道路了。 + +另一个问题就是 rustlings 需要先下载到本地，然后编译运行，无法在线使用。 + +## 对比 Rust By Example +[Rust By Example](https://doc.rust-lang.org/stable/rust-by-example/) 是相当不错的在线练习题，相比之前，`exercise.rs` 拥有以下优势 : + +- 内容覆盖面更广，且练习题更多、针对性更强，充分满足大家做题的快乐 +- 难度从简单到困难都有，且更贴合实际 +- 跟随 Rust 版本实时更新, +- `course.rs` 和 `exercise.rs` 看域名就知道，它非常有信心才敢使用这两个针对性如此之强的域名，而信心来源于**高质量** + + +