翻译说明

本书是续写版本,续写的版本由 Veykril 撰稿,续作对原作有补充和删改。

原作及其翻译渲染版本没有使用 mdbook 构建,而是使用 py 来生成 HTML。 在发布文档和运行样板代码方面诸多不便。

而且由于原作在 2016 年没再更新,其内容基于 Rust 2015 版本, 续写的版本也只是把过时的细节更新至 2018 之后的版本。

我认为这本书在阐述 声明宏 方面搭建了一个很小巧精美的骨架,过程宏的资料比较丰富,而且过程宏生态主要围绕第三方库开展。

续作及本翻译渲染版本使用 mdbook 构建:

另外,此翻译版本提供的阅读功能:

  1. 行间代码块大部分可以点击右上角按钮运行,有些可以 编辑 和运行 (目的是快速而方便地验证读者思考的代码能否编译通过)。 只用于展示说明、或者不适合运行的代码只有复制按钮。

区分能编辑代码块的方法:光标能够在代码块中停留和闪动;有同级竖线;右上角有 undo 图标;选中代码时背景色较浅;看代码块的主题颜色。

  1. 每个页面右侧都有本章节的 大纲目录 ,可以点击跳转。 如果大纲目录显示不完整,可以缩小浏览器页面;或者收起左侧的章节目录。 大纲目录仅在电脑网页版生效,移动端网页不会显示。

  2. 所有 code 蓝色样式、光标移上去有下划线的内容(普通正文或者行内代码)都是链接,可以跳转。 无链接的行内代码样式是这样的:code

  3. 翻译专有名词时,给出原英文,因为我认为那些词语是初次阅读英文时的障碍, 所以当读者查阅其他英文资料时,就不会感到陌生了。

更新日志

2022.04

主要补充的部分在于:

2021.06

主要补充的部分在于: