Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/rinthel/rust-lang-book-ko

The Rust Programming Language
https://github.com/rinthel/rust-lang-book-ko

Last synced: 3 months ago
JSON representation

The Rust Programming Language

Host: GitHub
URL: https://github.com/rinthel/rust-lang-book-ko
Owner: rinthel
License: other
Fork: true (rust-lang/book)
Created: 2017-07-08T21:19:20.000Z (over 7 years ago)
Default Branch: master
Last Pushed: 2024-03-07T12:55:40.000Z (8 months ago)
Last Synced: 2024-05-20T08:34:22.656Z (6 months ago)
Language: Rust
Homepage: https://doc.rust-lang.org/book/
Size: 72.1 MB
Stars: 301
Watchers: 14
Forks: 92
Open Issues: 0
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE-APACHE

Awesome Lists containing this project

awesome-list - rust-lang-book-ko

README

# 러스트 프로그래밍 언어

> ### 알립니다
>
> 이 번역본은 2017년 7월경부터 번역된 2nd edition을 기반으로 하고 있으며,
> 완료된 상태입니다. 문서의 최신 버전은 [https://github.com/rust-kr/doc.rust-kr.org](https://github.com/rust-kr/doc.rust-kr.org)에서
> 진행하고 있습니다. **최신 문서에 대한 정보는 rust-kr에 있는 저장소에서 확인해주세요.**
>
> 이 저장소는 최신 버전의 문서 번역이 완료될때까지 계속 유지될 것이며
> 그동안의 **2판 관련 오타 수정 등의 issue 및 pull-request만 처리**될
> 예정입니다.
>
> 최신 번역판의 출판본 역자 머리말에 기여자의 github id를 기록하고자 합니다.
> 자세한 사항은 위에 있는 최신 버전의 저장소 readme를 확인해주세요.

### 빌드된 문서 바로가기

- [2nd edition: 완역](https://rinthel.github.io/rust-lang-book-ko)
- [2021 edition: 완역](https://doc.rust-kr.org)

### 환영합니다!

[![빌드 상태](https://github.com/rinthel/rust-lang-book-ko/actions/workflows/build.yml/badge.svg)](https://github.com/rinthel/rust-lang-book-ko/actions/workflows/build.yml)

안녕하세요? 한국어를 쓰시는 러스트 유저 여러분들을 환영합니다.
이 저장소는 러스트 프로그래밍 언어 문서(소위 the book이라고 일컫는)의
2번째 판 번역을 위해 fork 되었습니다.
2번째 판의 빌드된 문서는 상단의 링크를 통해 읽으실 수 있습니다.

---

# The Rust Programming Language

This repo contains two editions of “The Rust Programming Language”.

The second edition is a rewrite that will be printed by NoStarch Press,
available around October 2017.

[You can read it online][html]; the last few chapters aren't completed yet, but
the first half of the book is much improved from the first edition. We recommend
starting with the second edition.

[html]: http://rust-lang.github.io/book/

[The first edition is still available to read online][first].

[first]: https://doc.rust-lang.org/book/

## Requirements

Building the book requires [mdBook] >= v0.0.13. To get it:

[mdBook]: https://github.com/azerupi/mdBook

```bash
$ cargo install mdbook
```

## Building

To build the book, first `cd` into either the `first-edition` or
`second-edition` directory depending on which edition of the book you would
like to build. Then type:

```bash
$ mdbook build
```

The output will be in the `book` subdirectory. To check it out, open it in
your web browser.

_Firefox:_
```bash
$ firefox book/index.html # Linux
$ open -a "Firefox" book/index.html # OS X
$ Start-Process "firefox.exe" .\book\index.html # Windows (PowerShell)
$ start firefox.exe .\book\index.html # Windows (Cmd)
```

_Chrome:_
```bash
$ google-chrome book/index.html # Linux
$ open -a "Google Chrome" book/index.html # OS X
$ Start-Process "chrome.exe" .\book\index.html # Windows (PowerShell)
$ start chrome.exe .\book\index.html # Windows (Cmd)
```

To run the tests:

```bash
$ mdbook test
```

## Contributing

We'd love your help! Please see [CONTRIBUTING.md][contrib] to learn about the
kinds of contributions we're looking for.

[contrib]: https://github.com/rust-lang/book/blob/master/CONTRIBUTING.md

### Translations

We'd especially love help translating the second edition of the book! See the
[Translations] label to join in efforts that are currently in progress. Open
a new issue to start working on a new language! We're waiting on [mdbook
support] for multiple languages before we merge any in, but feel free to
start! The chapters in [the frozen column] of the project won't see major
changes, so if you start with those, you won't have to redo work :)

[Translations]: https://github.com/rust-lang/book/issues?q=is%3Aopen+is%3Aissue+label%3ATranslations
[mdbook support]: https://github.com/azerupi/mdBook/issues/5
[the frozen column]: https://github.com/rust-lang/book/projects/1

## No Starch

As the second edition of the book will be published by No Starch, we first
iterate here, then ship the text off to No Starch. Then they do editing, and we
fold it back in.

As such, there’s a directory, *nostarch*, which corresponds to the text in No
Starch’s system.

When we've started working with No Starch in a word doc, we will also check
those into the repo in the *nostarch/odt* directory. To extract the text from
the word doc as markdown in order to backport changes to the online book:

1. Open the doc file in LibreOffice
1. Accept all tracked changes
1. Save as Microsoft Word 2007-2013 XML (.docx) in the *tmp* directory
1. Run `./doc-to-md.sh`
1. Inspect changes made to the markdown file in the *nostarch* directory and
copy the changes to the *src* directory as appropriate.

## Graphviz dot

This is mostly for Carol's reference because she keeps having to look it up.

We're using [Graphviz](http://graphviz.org/) for some of the diagrams in the
book. The source for those files live in the `dot` directory. To turn a `dot`
file, for example, `dot/trpl04-01.dot` into an `svg`, run:

```bash
$ dot dot/trpl04-01.dot -Tsvg > src/img/trpl04-01.svg
```

In the generated SVG, remove the width and the height attributes from the `svg`
element and set the `viewBox` attribute to `0.00 0.00 1000.00 1000.00` or other
values that don't cut off the image.

## Spellchecking

To scan source files for spelling errors, you can use the `spellcheck.sh`
script. It needs a dictionary of valid words, which is provided in
`dictionary.txt`. If the script produces a false positive (say, you used word
`BTreeMap` which the script considers invalid), you need to add this word to
`dictionary.txt` (keep the sorted order for consistency).