diff --git a/README.md b/README.md index 21d01e52c305..714b9e6efd98 100644 --- a/README.md +++ b/README.md @@ -1,98 +1,5 @@ # Comprehensive Rust ๐Ÿฆ€ - -์ด ์ €์žฅ์†Œ์—๋Š” ์•ˆ๋“œ๋กœ์ด๋“œ ํŒ€์— ์˜ํ•ด ๊ฐœ๋ฐœ๋œ 4์ผ๊ฐ„์˜ Comprehensive Rust์— ๋Œ€ํ•œ ์†Œ์Šค ์ฝ”๋“œ๊ฐ€ ์žˆ์Šต๋‹ˆ๋‹ค. -์ด ๊ณผ์ •์€ ๋Ÿฌ์ŠคํŠธ์˜ ๋ชจ๋“  ์ธก๋ฉด์„ ๋‹ค๋ฃน๋‹ˆ๋‹ค. -๊ธฐ๋ณธ ๊ตฌ๋ฌธ๋ถ€ํ„ฐ ์ œ๋„ค๋ฆญ ๋ฐ ์˜ค๋ฅ˜ ์ฒ˜๋ฆฌ์— ์ด๋ฅด๊ธฐ๊นŒ์ง€ ๋‹ค์–‘ํ•œ ๋Ÿฌ์ŠคํŠธ์˜ ๋ชจ๋“  ์ธก๋ฉด์„ ๋‹ค๋ฃน๋‹ˆ๋‹ค. -๋˜ํ•œ ๋งˆ์ง€๋ง‰ ๋‚ ์—๋Š” ์•ˆ๋“œ๋กœ์ด๋“œ ๊ด€๋ จ ์ฝ˜ํ…์ธ ๊นŒ์ง€ ๋‹ค๋ฃน๋‹ˆ๋‹ค. -> This repository has the source code for Comprehensive Rust ๐Ÿฆ€, a four day Rust -course developed by the Android team. The course covers all aspects of Rust, -from basic syntax to generics and error handling. It also includes -Android-specific content on the last day. - -(์›๋ณธ)์‚ฌ์ดํŠธ๋ฅผ ๋ฐฉ๋ฌธํ•ด ๋ณด์„ธ์š” **https://google.github.io/comprehensive-rust/**. -* ์›๋ฌธ๋ณ‘๊ธฐ ๋ฒˆ์—ญ๋ณธ์€ **https://keispace.github.io/comprehensive-rust-kr/** -> Read the course at **https://google.github.io/comprehensive-rust/**. - -## Course Format and Target Audience - -๋ณธ ๊ณผ์ •์€ ๊ฒฝํ—˜์ด ํ’๋ถ€ํ•œ C/C++์ด๋‚˜ ์ž๋ฐ”์™€ ๊ฐ™์€ ์†Œํ”„ํŠธ์›จ์–ด ์—”์ง€๋‹ˆ์–ด์—๊ฒŒ ๋Ÿฌ์ŠคํŠธ๋ฅผ ๊ฐ€๋ฅด์น  ๋ชฉ์ ์œผ๋กœ ๊ตฌ๊ธ€ ๋‚ด๋ถ€์—์„œ ์‚ฌ์šฉ๋ฉ๋‹ˆ๋‹ค. - -์ด ๊ณผ์ •์€ ๊ต์‹ค๊ณผ ๊ฐ™์€ ํ™˜๊ฒฝ์—์„œ ์ง„ํ–‰๋˜๋ฉฐ ์šฐ๋ฆฌ๋Š” ๋Ÿฌ์ŠคํŠธ๋ฅผ ๊ทธ๋“ค์˜ ํŒ€์—๊ฒŒ ๊ฐ€๋ฅด์น˜๋ ค๋Š” ๋‹ค๋ฅธ ์‚ฌ๋žŒ๋“ค์—๊ฒŒ ์œ ์šฉํ•˜๊ธฐ๋ฅผ ๋ฐ”๋ž๋‹ˆ๋‹ค. -์ด ๊ณผ์ •์€ ๊ฐ•์˜์‹ค์—์„œ ์ผ์–ด๋‚˜๋Š” ํ† ๋ก ์ด ๋น ์ ธ์žˆ๊ธฐ ๋•Œ๋ฌธ์— ์กฐ๊ธˆ์€ ๋œ ์œ ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. -์ด ๊ณผ์ • ๊ฐ€์šด๋ฐ ์งˆ๋ฌธ์ด๋‚˜ ๋‹ต๋ณ€, ์ฝ”๋“œ์ƒ˜ํ”Œ์˜ ์ปดํŒŒ์ผ ์—๋Ÿฌ์™€ ๊ฐ™์€ ๊ฒƒ๋“ค์„ ํ™•์ธํ•  ์ˆ˜ ์—†๊ธฐ ๋•Œ๋ฌธ์— ์•„๋ž˜ ์ฐธ๊ณ  ์ž๋ฃŒ๋ฅผ ํ™œ์šฉํ•˜์—ฌ ์ข€ ๋” (๋‹น์‹ ์˜ ๊ฐ•์˜๋ฅผ) ๊ฐœ์„ ํ•˜๊ธฐ๋ฅผ ํฌ๋งํ•ฉ๋‹ˆ๋‹ค. -* [speaker notes](https://github.com/google/comprehensive-rust/issues/53) -* [publishing videos](https://github.com/google/comprehensive-rust/issues/52) -> The course is used internally at Google when teaching Rust to experienced -> software engineers. They typically have a background in C++ or Java. -> -> The course is taught in a classroom setting and we hope it will be useful for -> others who want to teach Rust to their team. The course will be less useful for -> self-study since you miss out on the discussions happening in the classroom. You -> don't see the questions and answers and you don't see the compiler errors we -> trigger when going through the code samples. We hope to improve on this via -> [speaker notes](https://github.com/google/comprehensive-rust/issues/53) and by -> [publishing videos](https://github.com/google/comprehensive-rust/issues/52). -> -## Building - - -๊ฐ•์ขŒ๋Š” [mdBook](https://github.com/rust-lang/mdBook)๊ณผ [Svgbob plugin](https://github.com/boozook/mdbook-svgbob)๋ฅผ ์‚ฌ์šฉํ•ด์„œ ๋งŒ๋“ค์—ˆ์Šต๋‹ˆ๋‹ค. -์•„๋ž˜ ์‰˜๋กœ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋ฅผ ์„ค์น˜ ํ•ฉ๋‹ˆ๋‹ค. -> The course is built using [mdBook](https://github.com/rust-lang/mdBook) and its [Svgbob plugin](https://github.com/boozook/mdbook-svgbob). Install both tools with - -```shell -$ cargo install mdbook -$ cargo install mdbook-svgbob -``` - -์‹คํ–‰์€ ์•„๋ž˜์™€ ๊ฐ™์ด ํ•ฉ๋‹ˆ๋‹ค. -> Then run - -```shell -$ mdbook test -``` - -๋ชจ๋“  ๊ฐ•์˜ ๋‚ด์šฉ์— ๋Œ€ํ•œ ํ…Œ์ŠคํŠธ๋Š” ์•„๋ž˜์™€ ๊ฐ™์ด ์‹คํ–‰ํ•˜์„ธ์š” -> to test all included Rust snippets. Run - -```shell -$ mdbook serve -``` - -์—์„œ ์‹คํ–‰๋œ ๋ชจ๋“  ์ปจํ…์ธ ๋ฅผ ํ™•์ธํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. -`mdbook build`์„ ์‹คํ–‰ํ•˜๋ฉด `book/`ํด๋”์—์„œ static ๋ฒ„์ „์ด ์ƒ์„ฑ๋ฉ๋‹ˆ๋‹ค. - -> to start a web server with the course. You'll find the content on -> . You can use `mdbook build` to create a static version -> of the course in the `book/` directory. - - -## Contact - -์งˆ๋ฌธ์ด๋‚˜ ์˜๊ฒฌ์ด ์žˆ๋‹ค๋ฉด [Martin Geisler](mailto:mgeisler@google.com)์—๊ฒŒ ์—ฐ๋ฝ์„ ์ฃผ์‹œ๊ฑฐ๋‚˜ -[discussion on GitHub](https://github.com/google/comprehensive-rust/discussions)์— ๋‚จ๊ฒจ์ฃผ์„ธ์š”. -* ๋ฒˆ์—ญ์— ๋Œ€ํ•ด์„œ๋Š” ์ด ์ €์žฅ์†Œ์— PR์ด๋‚˜ issue ๋‹ฌ์•„์ฃผ์‹œ๋ฉด ๋ฐ˜์˜ํ•˜๊ฒ ์Šต๋‹ˆ๋‹ค. - -> For questions or comments, please contact [Martin Geisler](mailto:mgeisler@google.com) or start a [discussion on GitHub](https://github.com/google/comprehensive-rust/discussions). We would love to hear from you. - ---- -## ์—ญ์ž์ฃผ -์Šคํ„ฐ๋”” ๊ฒธ ํ•ด์„œ ์ €์žฅ์†Œ forkํ›„ ๋ฒˆ์—ญ์„ ์‹œ์ž‘ํ–ˆ์Šต๋‹ˆ๋‹ค. -mdbook search ๊ธฐ๋Šฅ์ด ํ•œ๊ตญ์–ด๋ฅผ ์ง€์›ํ•˜์ง€ ์•Š์•„์„œ ์ฐพ์•„๋ดค๋Š”๋ฐ ์•„์ง ๋Ÿฌ์ŠคํŠธ ์‹ค๋ ฅ์ด ๋ฏธ์ฒœํ•ด์„œ mdbook์—์„œ ํ•œ๊ตญ์–ด ์ง€์›ํ•˜๋„๋ก PR ๋ณด๋‚ผ ์ˆ˜๊ฐ€ ์—†๋„ค์š”(...) ๊ทธ๋ž˜์„œ ๊ฒ€์ƒ‰์šฉ ์›๋ฌธ์„ ๋ณ‘๊ธฐํ•ฉ๋‹ˆ๋‹ค. -- ๊ตฌ๊ธ€ ์›๋ณธ ์ชฝ์— ํ•œ๊ตญ์–ด ๋ฒˆ์—ญ ์„œํฌํŠธ๋กœ ์ œ๊ณตํ–ˆ์Šต๋‹ˆ๋‹ค ์ผ๋‹จ ๋ฒˆ์—ญ๊ธฐ๋Šฅ์„ mdbook์— ์ถ”๊ฐ€ํ•˜๊ธฐ ์œ„ํ•ด ์ง„ํ–‰์ค‘์ธ๋ฐ ์™„๋ฃŒ๊ฐ€ ๋˜๋ฉด ๊ฑฐ๊ธฐ ๋ณ‘ํ•ฉ๋ ์ง€๋„?.. - -## history -- 1์ฐจ ์™„๋ฃŒ ํŒŒํŠธ - - 2022-12-28: ์‹œ์ž‘ ~ 5.1 - - 2022-12-28: ~ 6.4 - - 2022-12-29: ~ 10.5 - - 2022-12-30: ~ 18.1 - - 2023-01-02: ~ 25(day3 morning) - - 2023-01-03: ~ 31.4 - - 2023-01-04: 4์ผ์ฐจ ์˜คํ›„(์•ˆ๋“œ๋กœ์ด๋“œ) ์ œ์™ธ ์ „์ฒด ์™„๋ฃŒ. - - 2023-01-05: 33.1~33.2 ์ž‘์—…, ์›๋ณธ ์‹ฑํฌ - - ์ถ”๊ฐ€๊ธฐ๋Šฅ์œผ๋กœ ๊ฐ•์˜๋…ธํŠธ ๊ธฐ๋Šฅ์ด ํฌํ•จ๋˜์—ˆ๋Š”๋ฐ ์—ญ์ฃผ์˜ ํžŒํŠธ ๊ฐ™์€ ๋ถ€๋ถ„๊ณผ ๊ฐ™์€ html tag๋ฅผ ์‚ฌ์šฉํ•˜๊ธฐ ๋•Œ๋ฌธ์— ํ•ด๋‹น ๊ธฐ๋Šฅ์€ ์ œ์™ธํ–ˆ์Šต๋‹ˆ๋‹ค.(book.toml) - - 2023-01-06: ์›๋ณธ ์‹ฑํฌ ํ›„ ์ถ”๊ฐ€ ๋‚ด์šฉ ์ž‘์—…๊ณผ ๋ชฉ์ฐจ ๋ฒˆ์—ญ ์ง„ํ–‰. - - ๊ฐ•์˜๋…ธํŠธ ์˜ˆ์ œ๊ฐ€ ์ถ”๊ฐ€๋˜์žˆ์–ด์„œ ์ด๋ถ€๋ถ„ ์ถ”๊ฐ€ ์ž‘์—… - - 2023-01-10: ์›๋ณธ ์‹ฑํฌ ํ›„ ๋‚ด์šฉ ์ถ”๊ฐ€ ๋ฒˆ์—ญ \ No newline at end of file +This repository hosted the Korean translation of Comprehensive Rust ๐Ÿฆ€. +The changes have been merged into the upstream repository. Please see +https://github.com/google/comprehensive-rust/pull/130.