book

이 저장소는 Rust 언어의 표준 입문서인 「The Rust Programming Language」의 소스를 담고 있습니다. 완성된 책은 No Starch Press에서 인쇄본으로 출판되며, 안정판·베타·나이틀리 Rust 릴리스와 함께 무료로 온라인에서도 제공됩니다(단, 함께 번들되는 사본은 여기서 수정된 내용이 반영되지 않을 수 있습니다). 릴리스 페이지에서는 책에 등장하는 모든 코드 목록을 내려받을 수 있습니다. 이 책은 Markdown으로 작성되었으며, Rust 커뮤니티의 북 정적 사이트 생성기인 mdBook으로 렌더링됩니다. 빌드하려면 rust-lang/rust의 rustbook 도구에 고정된 버전과 일치하는 특정 mdBook 버전을 `cargo install mdbook --locked --version <버전_번호>`로 설치한 다음, `mdbook build`를 실행하여 `book` 하위 디렉터리에 정적 사이트를 생성해야 하며, 모든 브라우저에서 볼 수 있습니다. README에는 Linux, macOS, Windows(PowerShell 및 Cmd)에서 Firefox와 Chrome을 실행하는 브라우저 명령이 문서화되어 있습니다. 코드 예제에 대한 테스트는 `packages/trpl` 아래에 있으며 `mdbook test --library-path packages/trpl/target/debug/deps`로 실행합니다. 기여는 CONTRIBUTING.md 지침을 통해 환영합니다. 다만 책이 인쇄본으로 출판되고 유지관리자들이 온라인 버전을 인쇄본에 가깝게 유지하려고 하므로, 수정 작업은 Rust 에디션 릴리스 시점에 맞춰 일괄적으로 이루어집니다. 그 큰 수정 사이에는 엄격한 오류 수정만 병합되므로, 오류가 아닌 풀 리퀘스트는 수개월에서 수년간 대기할 수 있습니다. 번역은 Translations 라벨로 추적되며, 새로운 언어 프로젝트는 이슈로 열 수 있지만 병합은 mdBook의 다중 언어 지원을 기다려야 합니다. `ci/spellcheck.sh` 스크립트와 `ci/dictionary.txt` 사전으로 맞춤법 검사를 지원하며, `BTreeMap` 같은 식별자로 인한 오탐은 사전에 정렬된 순서로 추가합니다. 전반적으로 이는 런타임 도구가 아닌 문서화·교육 프로젝트입니다. 사용자에게는 Rust의 권위 있는 학습 자료로서 가치가 있으며, 잘 문서화된 빌드 파이프라인, 코드 샘플용 테스트 하네스, 구조화된 기여 및 번역 워크플로를 갖추고 있습니다.