openmlsys-zh/info/info.md

环境安装

机器学习系统书籍部署在Github是依赖于d2lbook工具实现的。因此我们首先要安装d2lbook。

git clone git@github.com:d2l-ai/d2l-book.git
cd d2l-book
python setup.py install

使用d2lbook构建HTML需要安装pandoc, 可以使用apt-get install pandoc（如果是MacOS可以用Homebrew）和。 构建PDF时如果有SVG图片需要安装LibRsvg来转换SVG图片，安装librsvg可以通过apt-get install librsvg（如果是MacOS可以用Homebrew）。 当然构建PDF必须要有LaTeX，如安装Tex Live.

编译HTML版本

在编译前先下载openmlsys-zh 所有的编译命令都在改文件目录内执行。

 git clone git@github.com:openmlsys/openmlsys-zh.git
 cd openmlsys-zh

使用d2lbook工具编译HTML。

d2lbook build html

生成的html会在_build/html。

此时我们将编译好的html整个文件夹下的内容拷贝至openmlsys.github.io的docs发布。

需要注意的是docs目录下的.nojekyll不要删除了，不然网页会没有渲染。

样式规范

贡献请遵照本教程的样式规范。

中英文术语对照

翻译请参照中英文术语对照。