机器学习系统书籍部署在Github是依赖于d2lbook工具实现的。因此我们首先要安装d2lbook。
git clone https://github.com/openmlsys/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.
在编译前先下载openmlsys-zh 所有的编译命令都在改文件目录内执行。
git clone https://github.com/openmlsys/openmlsys-zh.git
cd openmlsys-zh
使用d2lbook工具编译HTML。
d2lbook build html
生成的html会在_build/html
。
此时我们将编译好的html整个文件夹下的内容拷贝至openmlsys.github.io的docs发布。
需要注意的是docs目录下的.nojekyll不要删除了,不然网页会没有渲染。
贡献请遵照本教程的样式规范。
翻译请参照中英文术语对照。