如何在本地生成Rust by Example中文版

本项目依赖gitbook，而gitbook又依赖nodejs。所以我们要先安装nodejs再安装gitbook。

作者：Liigo Zhuang （庄晓立）

安装nodejs

Linux环境下可以下载二进制压缩包，解压后直接拷贝到 /usr/local 目录内。也就是说，压缩包内 lib 目录直接覆盖到 /usr/local/lib，bin 目录直接覆盖到 /usr/local/bin。由于nodejs压缩包内只有它自己的文件，实际上不用担心自己系统的文件被覆盖。安装完nodejs之后，我们就有了两个命令：node和npm（均位于目录/usr/local/bin内），后面将通过npm安装gitbook。

Liigo注：以上安装nodejs的方法是我私人研究出来的，也不知道是否正宗。

安装gitbook

执行以下命令即可安装gitbook：

npm install gitbook -g

安装后将在 /usr/local/bin 目录下生成一个 gitbook 命令的软连接。在任意目录执行gitbook查看输出正常就说明已经安装成功。

加入 ACE 脚本

由于 Rust-by-Example 显示示例代码时用到了ACE代码框，需要修改 gitbook 的模板引入相应的JS脚本。@bywayboy 研究后提供的方法如下：

修改文件 /usr/local/lib/node_modules/gitbook/theme/templates/book/page.html ，在下面两行代码之间：

{% block javascript %}
<script src="{{ staticBase }}/app.js"></script>

插入新的一行：

<script src="http://cdnjs.cloudflare.com/ajax/libs/ace/1.1.3/ace.js"></script>

生成 Rust-by-Example

执行 make && make book 即可生成中文版Rust-by-Example。生成的站点根目录是stage/_book，首页是stage/_book/index.html。如果打开后发现Rust示例代码显示不正常，请确认按照前面提供的方法配置ACE代码框。

要生成英文版请执行 make en && make book。