构建前需先安装 Rust 工具链;生成 EPUB 需系统已安装 Pandoc;GitBook 版本缺失部分功能如代码语法高亮
cargo install mdbook
mdbook build 硬件要求按 README 说明
README 未说明,仅需能运行 Rust 工具链的环境,无 GPU 或显存要求
Rust 官方教程《Rust 程序设计语言》2024 edition 的简体中文翻译,用 mdBook 构建成可离线阅读的网页和电子书
《Rust 程序设计语言》中文版 2024 edition 的完整翻译,用 Typst 排版生成 PDF,方便中文读者离线阅读和学习 Rust。
核心能力
- 对照官方 src 目录翻译,每章标注官方链接与 commit hash
- 用 mdBook 构建静态 HTML 页面并本地起服务阅读
- 提供 Rust 构建工具把全书编译成 EPUB 电子书
- 附社区维护的简体中文版 PDF 下载链接
容易踩的坑
内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README
暂无 release 数据(可能没有发版,或尚未同步)。
用户点评
登录用户的真实使用记录,可按版本和硬件筛选共 0 条
还没有人点评。第一个说出真实体验的人最有价值。
Rust 程序设计语言(2024 edition)简体中文版
状态
- 2024 edtion 施工完毕。
PS:
- 对照源码位置:https://github.com/rust-lang/book/tree/main/src
- 注意源码
src目录一般会比 https://doc.rust-lang.org/book/ 要新,如果遇到冲突建议对照src目录。 - 每章翻译开头都带有官方链接和 commit hash 的注释,若发现与官方不一致,欢迎 Issue 或 PR
校对
部分章节采用 Codex 辅助校对。提示词可参考 proofreading_prompt.md
静态页面构建与文档撰写
构建
你可以将本 mdbook 构建成一系列静态 html 页面。这里我们采用 mdbook 打包出静态网页。在这之前,你需要安装 Rust。
全局安装 mdbook
cargo install mdbook
cd 到项目目录,然后开始构建。构建好的静态文档会出现在 "./book/html" 中
mdbook build
在本地部署 HTTP 服务器以阅读文档:
mdbook serve
社区资源
- Rust 语言中文社区:https://rustcc.cn/
- Rust 编程语言社区 1 群,群号:303838735(已满,只能内部邀请)
- Rust 编程语言社区 2 群,群号:813448660
- 由 mdbook-typst-pdf 生成,有任何问题欢迎 issue 或 PR
EPUB
你可以使用项目中提供的 Rust 构建工具将本书编译为 EPUB 电子书。
在此之前,请确保您的系统已安装了 Pandoc。
在项目根目录下,运行以下命令开始编译:
cargo run --release --manifest-path epub-builder/Cargo.toml
编译成功后,会在根目录下生成 rust_programming_language.epub。
GitBook
本翻译主要采用 mdBook 格式。同时支持 GitBook,但会缺失部分功能,如一些代码没有语法高亮。
本翻译加速查看站点有: