编译HTML版本

所有markdown文件需要在提交前清除output，它们会在服务器上重新执行生成结果。所以需要保证每个notebook执行不要太久，目前限制是20min。

在本地可以如下build html（需要GPU支持）

  1. conda env update -f build/env.yml
  2. source activate d2l-zh-build
  3. make html

生成的html会在_build/html。

如果没有改动notebook里面源代码，所以不想执行notebook，可以使用

  1. make html EVAL=0

但这样生成的html将不含有输出结果。

编译PDF版本

编译pdf版本需要xelatex、librsvg2-bin（svg图片转pdf）和思源字体。在Ubuntu可以这样安装。

  1. sudo apt-get install texlive-full
  2. sudo apt-get install librsvg2-bin
  1. wget https://github.com/adobe-fonts/source-han-sans/raw/release/OTF/SourceHanSansSC.zip
  2. wget https://github.com/adobe-fonts/source-han-serif/raw/release/OTF/SourceHanSerifSC_SB-H.zip
  3. wget https://github.com/adobe-fonts/source-han-serif/raw/release/OTF/SourceHanSerifSC_EL-M.zip
  5. unzip SourceHanSansSC.zip
  6. unzip SourceHanSerifSC_EL-M.zip
  7. unzip SourceHanSerifSC_SB-H.zip
  9. sudo mv SourceHanSansSC SourceHanSerifSC_EL-M SourceHanSerifSC_SB-H /usr/share/fonts/opentype/
  10. sudo fc-cache -f -v

这时候可以通过 fc-list :lang=zh 来查看安装的中文字体。

同样的去下载和安装英文字体

  1. wget -O source-serif-pro.zip https://www.fontsquirrel.com/fonts/download/source-serif-pro
  2. unzip source-serif-pro -d source-serif-pro
  3. sudo mv source-serif-pro /usr/share/fonts/opentype/
  5. wget -O source-sans-pro.zip https://www.fontsquirrel.com/fonts/download/source-sans-pro
  6. unzip source-sans-pro -d source-sans-pro
  7. sudo mv source-sans-pro /usr/share/fonts/opentype/
  9. wget -O source-code-pro.zip https://www.fontsquirrel.com/fonts/download/source-code-pro
  10. unzip source-code-pro -d source-code-pro
  11. sudo mv source-code-pro /usr/share/fonts/opentype/
  13. sudo fc-cache -f -v

然后就可以编译了。

  1. make pdf

其他安装

  1. python -m spacy download en # 需已 pip install spacy

样式规范

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

中英文术语对照

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