hello_exercism = "0.5.4"

Author: cnruby

docs/zh-first-volumn/src/SUMMARY.md

@@ -21,9 +21,12 @@
   - [开发软件篋borrowing_exerci](./hello-borrowing/develop.md)
   - [使用软件篋borrowing_exerci](./hello-borrowing/apply.md)
 - [软件篋trait_exerci](./hello-trait/README.md)
+  - [类型关键词struct](./hello-trait/examples-struct.md)
+  - [实现关键词impl与方法代码实现](./hello-trait/examples-impl.md)
+  - [函数代码实现](./hello-trait/examples-functions.md) 
+  - [衔接关键词trait与修饰关键词mut](./hello-trait/examples-trait.md)
   - [关于软件篋项目](./hello-trait/about.md)
   - [共享篋：开发命令](./hello-trait/commands-lib.md)
-  - [共享篋：实例代码解释](./hello-trait/examples-codes.md)
   - [共享篋：程序结构解释](./hello-trait/lib-structure.md)
   - [共享篋：程序代码解释](./hello-trait/lib-codes.md)
   - [共享篋：目录tests的测试代码解释](./hello-trait/lib-tests.md)

docs/zh-first-volumn/src/foreword/README.md

@@ -23,7 +23,13 @@
 - [Rust官方网站](https://www.rust-lang.org/)
 - [rustup官方网站](https://rustup.rs/)
 - [Cargo项目源代码](https://github.com/rust-lang/cargo)
-- [Crate.io官方网站](https://crates.io/)
+- [Crates s.io官方网站](https://crates.io/)
 
 ## 重要工具链接链接
 - [Tables Generator](https://www.tablesgenerator.com/)
+- [Liste der Unicode-Zeichen der Kategorie „Sonstiges Symbol“](https://www.compart.com/de/unicode/category/So)
+- [Sketchpad - Draw, Create, Share!](https://sketch.io/sketchpad/)
+- [Quality metadata badges](https://shields.io/)
+- [Continuous Integration and Deployment service for Windows and Linux | AppVeyor](https://www.appveyor.com/)
+- [Nu Shell](https://github.com/nushell/nushell)
+- [Markdown: Syntax](https://markdown.de/)

docs/zh-first-volumn/src/foreword/about.md

@@ -102,8 +102,4 @@
 | Ⓓ | default | 叙述Rust语言默认情况 | 必须记住 | Ⓓ 所有模块和函数默认情况下都是私有的。 |
 | ⓡ | regulation | 阐述Rust语言规则 | 必须记住 | ⓡ 所有字符串文字类型都是引用，且具有静态生命周期。 |
 | Ⓒ | consensus	| 解释约定而非强制方法 | 最好记住 | Ⓒ 大多数单元测试都带有注解'#[cfg(test)]'的测试模块。 |
-| Ⓘ | idea | 必须记住 | 计算机技术和Rust语言基本概念 | 
-
-## 参考资料
-- [Liste der Unicode-Zeichen der Kategorie „Sonstiges Symbol“](https://www.compart.com/de/unicode/category/So)
-- [Sketchpad - Draw, Create, Share!](https://sketch.io/sketchpad/)
+| Ⓘ | idea | 必须记住 | 计算机技术和Rust语言基本概念 | 

docs/zh-first-volumn/src/hello-borrowing/README.md

@@ -1,6 +1,14 @@
 # 第四章 软件篋borrowing_exerci
 
 
+## 参考资料
 - [split-a-module-across-several-files](https://stackoverflow.com/questions/22596920/split-a-module-across-several-files)
 - [ch07-05-separating-modules-into-different-files](https://doc.rust-lang.org/book/ch07-05-separating-modules-into-different-files.html)
-- [splitting-up-modules-in-rust](https://chronicbuildfailure.co/splitting-up-modules-in-rust-5ad7713201d5)
+- [splitting-up-modules-in-rust](https://chronicbuildfailure.co/splitting-up-modules-in-rust-5ad7713201d5)
+- [references-and-borrowing](https://doc.rust-lang.org/1.8.0/book/references-and-borrowing.html)
+- [rust-by-example/scope/borrow](https://doc.rust-lang.org/stable/rust-by-example/scope/borrow.html)
+- [rust-borrowing-and-ownership](http://squidarth.com/rc/rust/2018/05/31/rust-borrowing-and-ownership.html)
+- [understanding-rust-ownership-borrowing-lifetimes](https://medium.com/@bugaevc/understanding-rust-ownership-borrowing-lifetimes-ff9ee9f79a9c)
+- [you-can-t-turn-off-the-borrow-checker-in-rust](https://words.steveklabnik.com/you-can-t-turn-off-the-borrow-checker-in-rust)
+
+

docs/zh-first-volumn/src/hello-trait/README.md

@@ -1,37 +1,65 @@
-# 第二章
+# 第二章 软件篋trait_exerci
 
-## 学习内容
+### 学习内容
 - 什么是Rust语言衔接关键词trait
 - 为什么需要衔接关键词trait
 - 怎么样实现Rust语言衔接关键词trait
 - 实现关键词impl与衔接关键词trait是什么关系
-- 
 
+### 篇目
 
-## 篇目
+1. [关键词trait概念表述之一](#关键词trait概念表述之一)
+1. [关键词trait概念表述之二](#关键词trait概念表述之二)
+1. [关键词trait概念表述之三](#关键词trait概念表述之三)
+1. [解释关键词trait](#解释关键词trait)
+1. [题外话](#题外话)
+   1. [怎么样使用Rust语言nightly版本](#怎么样使用rust语言nightly版本)
+   1. [参考资料](#参考资料)
+1. [本章参考资料](#本章参考资料)
 
-1. [方法与函数](#方法与函数)
-1. [关键词trait](#关键词trait)
-1. [修饰关键词mut](#修饰关键词mut)
-1. [关键词impl](#关键词impl)
-1. [关键词impl和for](#关键词impl和for)
-1. [](#)
-1. [](#)
-1. [](#)
+## 关键词trait概念表述之一
 
+　　[关键词trait][id_01]是Rust语言的一项功能，可以告诉Rust编译器一种类型必须提供的功能。
 
-## 方法与函数
+## 关键词trait概念表述之二
 
-## 衔接关键词trait
-- 默认是私有的，且可增加修饰关键词pub
-- 
+　　[关键词trait][id_02]是为任何未知类型定义方法的集合。
 
-## 修饰关键词mut
+## 关键词trait概念表述之三
 
-## 实现关键词impl
-- 默认是公开的，且可增加修饰关键词pub
-- 函数默认是私有的，且可增加修饰关键词pub
+　　[关键词trait][id_03]告诉Rust编译器一种特定的类型具有且可与其他类型共享的功效性质。
 
-## 关键词impl和for
-- 默认是公开的
-- 函数不可增加修饰关键词pub
+## 解释关键词trait
+
+　　关键词trait提供了一种类型或者几种类型之间的衔接方式。它应该包含下面内容：
+
+- 存在一种类型或者几种类型
+- 使用关键词trait定义衔接名称
+- 使用关键词trait代码块定义方法和函数
+- 使用关键词"impl"和"for"组合，实现针对这一种类型或者这几种类型的方法和函数
+
+## 题外话
+
+### 怎么样使用Rust语言nightly版本
+```bash
+rustc --version
+rustup default nightly
+rustc --version
+rustup default stable
+rustup update
+rustup show
+```
+
+### 参考资料
+- [Setting "rustup default nightly" and back to stable ends up](https://github.com/rust-lang/rustup.rs/issues/451)
+- [Toolchain 'nightly-x86_64-apple-darwin' missing](https://github.com/rust-lang/rust/issues/55571)
+
+## 本章参考资料
+- [Impls & Traits](https://learning-rust.github.io/docs/b5.impls_and_traits.html)
+- [Traits from 'rust-by-example'](https://doc.rust-lang.org/stable/rust-by-example/trait.html)
+- [Traits from 'The Rust Programming Language'](https://doc.rust-lang.org/1.8.0/book/traits.html)
+- [Traits: Defining Shared Behavior](https://doc.rust-lang.org/beta/book/ch10-02-traits.html)
+
+[id_01]:https://doc.rust-lang.org/1.8.0/book/traits.html
+[id_02]:https://doc.rust-lang.org/stable/rust-by-example/trait.html
+[id_03]:https://doc.rust-lang.org/beta/book/ch10-02-traits.html

docs/zh-first-volumn/src/hello-trait/commands-lib.md

@@ -1,43 +1,18 @@
-# 共享篋：开发命令
+## 共享篋：开发命令
 
+## 篇目
 
-# How to Understand the Rust Feature trait
+- [I. create the crate for library](#i-create-the-crate-for-library)
+- [II. create the crate for application](#ii-create-the-crate-for-application)
 
-## I. develop the crate
-### Step 1: create the default crate
+# I. create the crate for library
 ```bash
 mkdir lib-hello && cd lib-hello
 cargo init --name trait_exerci --lib
-touch README.md
-vi README.md
 ```
 
-### Step 2: develop the crate source and test codes
-- Go to Crate Root Path
+# II. create the crate for application
 ```bash
-vi Cargo.toml
-vi src/lib.rs
-cargo fmt
-cargo clippy
-mkdir tests
-touch tests/hello.rs
-vi tests/hello.rs
-touch tests/mod_hello.rs
-vi tests/mod_hello.rs
-cargo fmt
-cargo clippy
-cargo test
-```
-
-### Step 3: develop the example codes
-- Go to Crate Root Path
-```bash
-mkdir examples
-touch examples/hello.rs
-vi examples/hello.rs
-cargo run --example hello
-```
-
-
 mkdir bin-hello && cd bin-hello
-cargo init --name hello-trait --lib
+cargo init --name hello-trait --bin
+```

docs/zh-first-volumn/src/hello-trait/examples-codes.md

@@ -0,0 +1,18 @@
+# 函数代码实现
+
+## 学习内容
+- 阐述
+- 理解
+
+
+## 篇目
+
+1. [函数代码实现](#函数代码实现)
+1. [参考资料](#参考资料)
+
+## 函数代码实现
+
+{{#playpen ../../../../hello-trait/lib-hello/examples/method_function.rs editable}}
+
+## 参考资料
+- 

docs/zh-first-volumn/src/hello-trait/examples-functions.md

@@ -0,0 +1,25 @@
+# 实现关键词impl与方法代码实现
+
+## 学习内容
+- 阐述
+- 理解
+
+
+## 篇目
+
+1. [实现关键词impl与方法代码实现](#实现关键词impl与方法代码实现)
+1. [参考资料](#参考资料)
+
+
+## 实现关键词impl与方法代码实现
+
+## 实现关键词impl
+- 默认是公开的，且可增加修饰关键词pub
+- 函数默认是私有的，且可增加修饰关键词pub
+
+
+{{#playpen ../../../../hello-trait/lib-hello/examples/method_instance.rs editable}}
+
+
+## 参考资料
+- 

docs/zh-first-volumn/src/hello-trait/examples-impl.md

@@ -0,0 +1,40 @@
+# 类型关键词struct
+
+
+
+## 篇目
+
+1. [类型关键词struct是什么](#类型关键词struct是什么)
+1. [C语言形式的类型关键词struct代码](#C语言形式的类型关键词struct代码)
+1. [元组形式的类型关键词struct](#元组形式的类型关键词struct)
+1. [参考资料](#参考资料)
+
+## 类型关键词struct是什么
+
+类型关键词struct就是定义一种结构类型。
+
+![image](../../images/hello-trait-11-struct.png)
+
+
+## 类型关键词struct的私有性
+
+
+## C语言形式的类型关键词struct代码
+
+- 结构的定义方式
+- 结构的实例化方式
+
+{{#playpen ../../../../hello-trait/lib-hello/examples/pub_field.rs editable}}
+
+
+## 元组形式的类型关键词struct
+
+- 结构的定义方式
+- 结构的实例化方式
+
+{{#playpen ../../../../hello-trait/lib-hello/examples/tuple_struct.rs editable}}
+
+
+## 参考资料
+- [structs from 'rust-by-example '](https://doc.rust-lang.org/stable/rust-by-example/custom_types/structs.html)
+- 

docs/zh-first-volumn/src/hello-trait/examples-struct.md

@@ -0,0 +1,26 @@
+# 衔接关键词trait与修饰关键词mut
+
+## 学习内容
+- 阐述
+- 理解
+
+
+## 篇目
+
+1. [衔接关键词trait](#衔接关键词trait)
+1. [参考资料](#参考资料)
+
+## 衔接关键词trait
+- 默认是私有的，且可增加修饰关键词pub
+- 
+
+## 修饰关键词mut
+
+## 关键词impl和for
+- 默认是公开的
+- 函数不可增加修饰关键词pub
+
+{{#playpen ../../../../hello-trait/lib-hello/examples/trait.rs editable}}
+
+## 参考资料
+-