Skip to content

D
d2l-zh

OpenDocCN / d2l-zh

通知 2
Star 0
Fork 0
D
d2l-zh

前往新版Gitcode，体验更适合开发者的 AI 搜索 >>

提交 86c9a8e0 编写于 作者: A Aston Zhang
浏览文件
操作

revise readme

上级 6bbc941b
隐藏空白更改
内联 并排
Showing with 91 addition and 87 deletion
INFO.md 0 → 100644
浏览文件 @ 86c9a8e0
## 编译HTML版本
所有markdown文件需要在提交前清除output，它们会在服务器上重新执行生成结果。所以需要保证每个notebook执行不要太久，目前限制是20min。
在本地可以如下build html（需要GPU支持）
```
conda env update -f build/env.yml
source activate d2l-zh-build
make html
```
生成的html会在`_build/html`。
如果没有改动notebook里面源代码，所以不想执行notebook，可以使用
```
make html EVAL=0
```
但这样生成的html将不含有输出结果。
## 编译PDF版本
编译pdf版本需要xelatex、librsvg2-bin（svg图片转pdf）和思源字体。在Ubuntu可以这样安装。
```
sudo apt-get install texlive-full
sudo apt-get install librsvg2-bin
```
```
wget https://github.com/adobe-fonts/source-han-sans/raw/release/OTF/SourceHanSansSC.zip
wget https://github.com/adobe-fonts/source-han-serif/raw/release/OTF/SourceHanSerifSC_SB-H.zip
wget https://github.com/adobe-fonts/source-han-serif/raw/release/OTF/SourceHanSerifSC_EL-M.zip
unzip SourceHanSansSC.zip
unzip SourceHanSerifSC_EL-M.zip
unzip SourceHanSerifSC_SB-H.zip
sudo mv SourceHanSansSC SourceHanSerifSC_EL-M SourceHanSerifSC_SB-H /usr/share/fonts/opentype/
sudo fc-cache -f -v
```
这时候可以通过 `fc-list :lang=zh` 来查看安装的中文字体。
同样的去下载和安装英文字体
```
wget -O source-serif-pro.zip https://www.fontsquirrel.com/fonts/download/source-serif-pro
unzip source-serif-pro -d source-serif-pro
sudo mv source-serif-pro /usr/share/fonts/opentype/
wget -O source-sans-pro.zip https://www.fontsquirrel.com/fonts/download/source-sans-pro
unzip source-sans-pro -d source-sans-pro
sudo mv source-sans-pro /usr/share/fonts/opentype/
wget -O source-code-pro.zip https://www.fontsquirrel.com/fonts/download/source-code-pro
unzip source-code-pro -d source-code-pro
sudo mv source-code-pro /usr/share/fonts/opentype/
sudo fc-cache -f -v
```
然后就可以编译了。
```
make pdf
```
## 其他安装
```
python -m spacy download en # 需已 pip install spacy
```
## 样式规范
贡献请遵照本教程的[样式规范](STYLE_GUIDE.md)。
## 中英文术语对照
翻译请参照[中英文术语对照](TERMINOLOGY.md)。
README.md
浏览文件 @ 86c9a8e0
...@@ -4,103 +4,23 @@ ...@@ -4,103 +4,23 @@
## 英文版 *Dive into Deep Learning* ## 英文版 *Dive into Deep Learning*
加州大学伯克利分校2019年春学期“深度学习”课程教材。 加州大学伯克利分校 2019 年春学期“深度学习”课程教材。（更多教学资源将陆续发布）
[https://github.com/diveintodeeplearning/d2l-en](https://github.com/diveintodeeplearning/d2l-en) [https://github.com/diveintodeeplearning/d2l-en](https://github.com/diveintodeeplearning/d2l-en)
## 讨论和报告问题 ## 讨论和报告问题
请使用 [https://discuss.gluon.ai](https://discuss.gluon.ai) 讨论或报告问题。 本书的网站是 [https://zh.diveintodeeplearning.org/](https://zh.diveintodeeplearning.org/)。
## [如何贡献](https://zh.diveintodeeplearning.org/chapter_appendix/how-to-contribute.html)
所有notebook是用markdown格式存储，这样方便merge改动。jupyter可以通过notedown来直接使用markdown，[参考这里安装](https://zh.diveintodeeplearning.org/chapter_appendix/jupyter.html#%E7%94%A8-Jupyter-%E8%AE%B0%E4%BA%8B%E6%9C%AC%E8%AF%BB%E5%86%99-GitHub-%E6%BA%90%E6%96%87%E4%BB%B6)
可以使用 https://zh.diveintodeeplearning.org.s3-website-us-west-2.amazonaws.com/ 来访问没有加载过 CDN 的版本，对代码的改动刷新更快。
## 编译HTML版本
所有markdown文件需要在提交前清除output，它们会在服务器上重新执行生成结果。所以需要保证每个notebook执行不要太久，目前限制是20min。
在本地可以如下build html（需要GPU支持）
```
conda env update -f build/env.yml
source activate d2l-zh-build
make html
```
生成的html会在`_build/html`。
如果没有改动notebook里面源代码，所以不想执行notebook，可以使用
```
make html EVAL=0
```
但这样生成的html将不含有输出结果。
## 编译PDF版本
编译pdf版本需要xelatex、librsvg2-bin（svg图片转pdf）和思源字体。在Ubuntu可以这样安装。 请使用 [https://discuss.gluon.ai](https://discuss.gluon.ai) 讨论或报告问题。
```
sudo apt-get install texlive-full
sudo apt-get install librsvg2-bin
```
```
wget https://github.com/adobe-fonts/source-han-sans/raw/release/OTF/SourceHanSansSC.zip
wget https://github.com/adobe-fonts/source-han-serif/raw/release/OTF/SourceHanSerifSC_SB-H.zip
wget https://github.com/adobe-fonts/source-han-serif/raw/release/OTF/SourceHanSerifSC_EL-M.zip
unzip SourceHanSansSC.zip
unzip SourceHanSerifSC_EL-M.zip
unzip SourceHanSerifSC_SB-H.zip
sudo mv SourceHanSansSC SourceHanSerifSC_EL-M SourceHanSerifSC_SB-H /usr/share/fonts/opentype/
sudo fc-cache -f -v
```
这时候可以通过 `fc-list :lang=zh` 来查看安装的中文字体。
同样的去下载和安装英文字体
```
wget -O source-serif-pro.zip https://www.fontsquirrel.com/fonts/download/source-serif-pro
unzip source-serif-pro -d source-serif-pro
sudo mv source-serif-pro /usr/share/fonts/opentype/
wget -O source-sans-pro.zip https://www.fontsquirrel.com/fonts/download/source-sans-pro
unzip source-sans-pro -d source-sans-pro
sudo mv source-sans-pro /usr/share/fonts/opentype/
wget -O source-code-pro.zip https://www.fontsquirrel.com/fonts/download/source-code-pro
unzip source-code-pro -d source-code-pro
sudo mv source-code-pro /usr/share/fonts/opentype/
sudo fc-cache -f -v
```
然后就可以编译了。
```
make pdf
```
## 其他安装
```
python -m spacy download en # 需已 pip install spacy
```
## 样式规范 ## 贡献
贡献请遵照本教程的[样式规范](STYLE_GUIDE.md)。 感谢[社区贡献者们](https://github.com/diveintodeeplearning/d2l-zh/graphs/contributors)使这本开源书为每一位读者变得更好。
## 中英文术语对照 [如何贡献](https://zh.diveintodeeplearning.org/chapter_appendix/how-to-contribute.html)]
翻译请参照[中英文术语对照](TERMINOLOGY.md)。
## [其他](INFO.md)
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或