/rust-book-vi

The Rust Programming Language

Primary LanguageRustOtherNOASSERTION

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

Build Status

Repository chứa mã nguồn cho cuốn sách "Ngôn ngữ lập trình Rust".

The book is available in dead-tree form from No Starch Press.

Xin lưu ý sách có thể được phát hành theo các kênh phát hành Rust khác nhau, bao gồm stable, beta, or nightly. Cũng xin lưu ý các vấn đề trong những phiên bản trên cũng có thể đã được sửa trên repository, vì các bản phát hành thường được cập nhập ít thường xuyên hơn.

Đọc phần releases để tải về mã nguồn của tất cả các đoạn mã xuất hiện trong sách.

Yêu cầu

Để dịch sang định dạng sách online bạn sẽ cần mdBook, tốt nhất là cùng phiên bản mà rust-lang/rust dùng trong this file. Để tải về:

$ cargo install mdbook --version <version_num>

Building

Để dịch thành sách online, gõ:

$ mdbook build

Kết quả sẽ được lưu lại trong thư mục con book. Bạn có thể mở ra đọc bằng trình duyệt web 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)

Để chạy phần kiểm tra:

$ mdbook test

Đóng góp

Chúng tôi trân trọng sự trợ giúp của các bạn! Xin đọc thêm CONTRIBUTING.md để tìm hiểu về những cách đóng góp cho dự án.

Vì bộ sách này đã được in, và cũng vì chúng tôi muốn giữ cho phiên bản trực tuyến gần với phiên bản in nhất có thể, do vậy có thể mất nhiều thời gian để chúng giải quyết các vấn đề hoặc pull request của bạn.

Cho đến nay, chúng tôi đang thực hiện một bản sửa đổi lớn hơn để khớp với [Phiên bản Rust] (https://doc.rust-lang.org/edition-guide/). Giữa những bản chỉnh sửa lớn, chúng tôi sẽ chỉ đưa ra các bản sửa lỗi. Nếu vấn đề hoặc pull request của bạn không nghiêm trọng, có thể bạn sẽ phải chờ đến lần chúng tôi làm việc trên một bản sửa đổi lớn tiếp theo: dự kiến là theo tháng hoặc năm. Rất cảm ơn vì sự kiên nhẫn của bạn!

Dịch thuật

Chúng tôi rất trân trọng việc trợ giúp dịch bộ sách này sang các ngôn ngữ khác! Xin xem nhãn Translations để tham gia vào những nỗ lực đang được thực hiện. Mở một issue mới để bắt đầu một bản dịch mới cho một ngôn ngữ. Chúng tôi đang chờ mdbook support để hỗ trợ đa ngôn ngữ trước khi merge, nhưng hiện tại các bạn hãy cứ thoải mái bắt đầu!

Kiểm tra chính tả

Để quét các file mã nguồn để dò lỗi chính tả, bạn có thể dùng spellcheck.sh có trong thư mục ci. Nó cần một từ điển các từ hợp lệ, được chứa trong ci/dictionary.txt. Nếu script trên sinh ra một lỗi (ví dụ như khi bạn dùng từ BTreeMap vối đối với script là không hợp lệ), bạn cần thêm từ này vào ci/dictionary.txt (đưa vào đúng vị trí để giữ đúng thứ tự sắp xếp sẵn có).