mirror of https://github.com/rust-lang/nomicon
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
65 lines
2.8 KiB
65 lines
2.8 KiB
# 러스토노미콘
|
|
|
|
심오하고 *불안전한* 러스트 프로그래밍의 흑마법들
|
|
|
|
짧게 "노미콘"이라고 부릅니다.
|
|
|
|
## 주의: 이것은 미완성 문서이고, 심각한 오류들을 포함할 수 있습니다.
|
|
|
|
> 내가 바랐던 프로그램들 대신, 살떨리는 어둠과 표현할 수 없는 외로움만이 있었다. 그리고 난 마침내 보고야 말았다.
|
|
아무도 그 앞에서 감히 숨도 쉬지 못한 두려운 진실, 속삭일 수조차 없는 비밀들 중의 비밀을 보고야 만 것이다.
|
|
이 돌과 끼긱거리는 소리로 이루어진 언어가 러스트의 의식적인 후계가 아니라는 것이었다. 런던은 옛날 정겨운
|
|
런던이었고 파리도 그랬지만, 이 언어는 아니었다. 이것은 꽤나 불안전했고,
|
|
그 뻗어있는 몸은 거의 미라가 되어 있었고 컴파일할 때는 없었던, 움직이는 요상한 것들로 들끓고 있었다.
|
|
|
|
이 책은 올바른 *"불안전한"* 러스트 프로그램을 작성하기 위해 이해해야 하는 온갖 자질구레한 하나하나를 다 다룹니다.
|
|
이러한 문제의 특성 때문에, 이는 이루 다 말할 수 없는 공포스러운 것들을 해방시켜 당신의 정신을 무수한 절망의 조각들로 박살낼 수도 있습니다.
|
|
|
|
## 요구사항
|
|
|
|
노미콘을 빌드하기 위해서는 [mdBook]이 필요합니다. 설치하려면 다음과 같이 입력하세요:
|
|
|
|
[mdBook]: https://github.com/rust-lang/mdBook
|
|
|
|
```bash
|
|
cargo install mdbook
|
|
```
|
|
|
|
### `mdbook` 사용법
|
|
|
|
노미콘을 빌드하려면 `build` 서브커맨드를 사용하세요:
|
|
|
|
```bash
|
|
mdbook build
|
|
```
|
|
|
|
결과물은 `book` 디렉토리에 위치할 것입니다. 이 결과물을 보려면, `index.html` 파일을 웹 브라우저에서 여세요.
|
|
`--open` 플래그를 `mdbook build`에 사용하면 (성공한다면) 기본 브라우저에서 인덱스 페이지를 엽니다. 마치 `cargo doc --open`처럼요:
|
|
|
|
```bash
|
|
mdbook build --open
|
|
```
|
|
|
|
책에 담겨있는 모든 코드 예제를 테스트하는 `test` 서브커맨드도 있습니다:
|
|
|
|
```bash
|
|
mdbook test
|
|
```
|
|
|
|
### `linkcheck`
|
|
|
|
`linkcheck` 툴을 사용하여 유효하지 않은 링크를 검증합니다.
|
|
로컬에서 실행하려면 다음과 같이 입력하세요:
|
|
|
|
```sh
|
|
curl -sSLo linkcheck.sh https://raw.githubusercontent.com/rust-lang/rust/master/src/tools/linkchecker/linkcheck.sh
|
|
sh linkcheck.sh --all nomicon
|
|
```
|
|
|
|
## 기여
|
|
|
|
노미콘은 아직 미완성 상태이기 때문에, 당신의 도움이 필요합니다!
|
|
아무 주제라도 좋으니 자유롭게 이슈를 열어 주시고, 고치거나 바꾸고 싶은 것들이 있다면 PR도 환영합니다.
|
|
만약 변경사항이 많다면 PR로 고생하시기 전에, 수락할 변경사항인지 확실하게 하기 위해 먼저 이슈를 열어 주세요.
|
|
|