Rust 程式設計語言
此為「The Rust Programming Language」fork 後的正體中文版,你可以在「Rust 程式設計語言 」閱讀整本書的內容。而要是有興趣貢獻的話,歡迎前往 CONTRIBUTING.md 來瞭解詳情。
This repository contains the source of "The Rust Programming Language" book.
The book is available in dead-tree form from No Starch Press.
You can also read the book for free online. Please see the book as shipped with the latest stable, beta, or nightly Rust releases. Be aware that issues in those versions may have been fixed in this repository already, as those releases are updated less frequently.
See the releases to download just the code of all the code listings that appear in the book.
Requirements
Building the book requires mdBook, ideally the same version that rust-lang/rust uses in this file. To get it:
$ cargo install mdbook --vers [version-num]
Building
To build the book, type:
$ mdbook build
The output will be in the book
subdirectory. To check it out, open it in
your web browser.
Firefox:
$ 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:
$ 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:
$ mdbook test
Contributing
We'd love your help! Please see CONTRIBUTING.md to learn about the kinds of contributions we're looking for.
Translations
We'd love help translating 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!
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).