Ngôn ngữ lập trình Rust

Kho lưu trữ này chứa mã nguồn của cuốn sách "Ngôn ngữ lập trình Rust".

Cuốn sách có sẵn ở dạng dead-tree từ nhà xuất bản No Starch Press.

Bạn cũng có thể đọc trực tuyến miễn phí. Xin hãy đọc các ấn bản được phát hành cùng với các bản phát hành Rust stable , beta hoặc nightly mới nhất. Xin lưu ý rằng những vấn đề trong các phiên bản đó có thể đã được khắc phục trong kho lưu trữ này vì các bản phát hành ít thường xuyên cập nhật hơn nội dung cuốn sách này.

Xem Release để tải xuống chỉ phần mã lệnh của tất cả các danh sách mã xuất hiện trong sách.

Các yêu cầu để nhận được cuốn sách hoàn chỉnh

Dể hoàn thành việc dàn trang cho cuốn sách, bạn cần mdBook, tốt nhất là phiên bản giống với phiên bản mà rust-lang/rust sử dụng trong tệp này. Để tải về, dùng đường dẫn dưới đây:

$ cargo install mdbook --version <version_num>

Dàn trang

Để dàn trang hoàn chỉnh, gõ lệnh sau:

$ mdbook build

Kết quả sẽ được lưu trong thư mục con có tên book. Để kiểm tra, hãy mở nó trong trình duyệt của bạn.

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)

Để kiểm tra lỗi:

$ mdbook test

Hỗ trợ

Chúng tôi cần sự giúp đỡ của các bạn! Vui lòng xem CONTRIBUTING.md để tìm hiểu về các công tác hỗ trợ mà chúng tôi cần.

Vì cuốn sách được in ra giấy và vì chúng tôi muốn giữ phiên bản trực tuyến của cuốn sách gần với ấn bản giấy nhất có thể nên chúng tôi có thể cần nhiều thời gian hơn bình thường để giải quyết các vấn đề hoặc yêu cầu của bạn.

Cho đến nay, chúng tôi đã thực hiện một bản sửa đổi lớn để đồng bộ với Phiên bản Rust. Giữa các lần sửa đổi nội dung lớn, chúng tôi sẽ chỉ sửa lỗi. Nếu vấn đề hoặc yêu cầu của bạn không được khắc phục một cách triệt để, vấn đề đó có thể tồn tại cho đến lần tiếp theo khi chúng tôi thực hiện một bản sửa đổi lớn: việc này dự kiến sẽ diễn ra theo thứ tự hàng tháng hoặc hàng năm. Cảm ơn vì sự kiên nhẫn của bạn!

Các bản dịch

Chúng tôi rất vui khi được giúp đỡ để dịch cuốn sách! Xem nhãn Translations để tham gia vào các nỗ lực dịch thuật hiện đang được tiến hành. Để bắt đầu dịch sang một ngôn ngữ mới, hãy tạo một vấn đề mới! Chúng tôi đang chờ hỗ trợ của mdbook cho cơ chế đa ngôn ngữ trước khi chúng tôi hợp nhất bất kỳ ngôn ngữ nào vào, nhưng bạn cứ thoải mái mà bắt đầu!

Kiểm tra chính tả

Để quét các tập tin nguồn để tìm lỗi chính tả, bạn có thể sử dụng tập lệnh spellcheck.sh có sẵn trong thư mục ci. Nó cần một từ điển chứa các từ hợp lệ, được cung cấp trong ci/dictionary.txt. Nếu tập lệnh tạo ra kết quả dương tính giả (giả sử bạn đã sử dụng từ BTreeMap mà tập lệnh coi là không hợp lệ), thì bạn cần thêm từ này vào ci/dictionary.txt (giữ nguyên thứ tự được sắp xếp để thống nhất).