# 深度学习入门
[![Build Status](https://travis-ci.org/PaddlePaddle/book.svg?branch=develop)](https://travis-ci.org/PaddlePaddle/book)
[![Documentation Status](https://img.shields.io/badge/docs-latest-brightgreen.svg?style=flat)](https://github.com/PaddlePaddle/book/blob/develop/README.md)
[![Documentation Status](https://img.shields.io/badge/中文文档-最新-brightgreen.svg)](https://github.com/PaddlePaddle/book/blob/develop/README.cn.md)
1. [线性回归](https://www.paddlepaddle.org.cn/documentation/docs/zh/1.5/beginners_guide/basics/fit_a_line/README.cn.html)
1. [识别数字](https://www.paddlepaddle.org.cn/documentation/docs/zh/1.5/beginners_guide/basics/recognize_digits/README.cn.html)
1. [图像分类](https://www.paddlepaddle.org.cn/documentation/docs/zh/1.5/beginners_guide/basics/image_classification/index.html)
1. [词向量](https://www.paddlepaddle.org.cn/documentation/docs/zh/1.5/beginners_guide/basics/word2vec/index.html)
1. [个性化推荐](https://www.paddlepaddle.org.cn/documentation/docs/zh/1.5/beginners_guide/basics/recommender_system/index.html)
1. [情感分析](https://www.paddlepaddle.org.cn/documentation/docs/zh/1.5/beginners_guide/basics/understand_sentiment/index.html)
1. [语义角色标注](https://www.paddlepaddle.org.cn/documentation/docs/zh/1.5/beginners_guide/basics/label_semantic_roles/index.html)
1. [机器翻译](https://www.paddlepaddle.org.cn/documentation/docs/zh/1.5/beginners_guide/basics/machine_translation/index.html)
1. [生成对抗网络](https://www.paddlepaddle.org.cn/documentation/docs/zh/1.5/beginners_guide/basics/gan/index.html)
更多学习内容请访问PaddlePaddle[视频课堂](http://bit.baidu.com/Course/datalist/column/117.html)。
## 运行这本书
您现在在看的这本书是一本“交互式”电子书 —— 每一章都可以运行在一个Jupyter Notebook里。
我们把Jupyter、PaddlePaddle、以及各种被依赖的软件都打包进一个Docker image了。所以您不需要自己来安装各种软件,只需要安装Docker即可。对于各种Linux发行版,请参考 https://www.docker.com 。如果您使用[Windows](https://www.docker.com/docker-windows)或者[Mac](https://www.docker.com/docker-mac),可以考虑[给Docker更多内存和CPU资源](http://stackoverflow.com/a/39720010/724872)。
只需要在命令行窗口里运行:
```bash
docker run -d -p 8888:8888 paddlepaddle/book
```
会从DockerHub.com下载和运行本书的Docker image。阅读和在线编辑本书请在浏览器里访问 http://localhost:8888 。
如果您访问DockerHub.com很慢,可以试试我们的另一个镜像hub.baidubce.com:
```bash
docker run -d -p 8888:8888 hub.baidubce.com/paddlepaddle/book
```
### 使用GPU训练
本书默认使用CPU训练,若是要使用GPU训练,使用步骤会稍有变化。为了保证GPU驱动能够在镜像里面正常运行,我们推荐使用[nvidia-docker](https://github.com/NVIDIA/nvidia-docker)来运行镜像。请先安装nvidia-docker,之后请运行:
```bash
nvidia-docker run -d -p 8888:8888 paddlepaddle/book:latest-gpu
```
如果您安装的是nvidia-docker2.0之后的版本,请使用如下命令运行:
```bash
docker run --gpus all -d -p 8888:8888 paddlepaddle/book:latest-gpu
```
或者使用国内的镜像请运行:
```bash
nvidia-docker run -d -p 8888:8888 hub.baidubce.com/paddlepaddle/book:latest-gpu
```
还需要将以下代码
```python
use_cuda = False
```
改成:
```python
use_cuda = True
```
## 贡献内容
您要是能贡献新的章节那就太好了!请发Pull Requests把您写的章节加入到`/pending`下面的一个子目录里。当这一章稳定下来,我们一起把您的目录挪到根目录。
为了写作、运行、调试,您需要安装Python 2.x和Go >1.5, 并可以用[脚本程序](https://github.com/PaddlePaddle/book/blob/develop/.tools/convert-markdown-into-ipynb-and-test.sh)来生成新的Docker image。
**Note:** We also provide [English Readme](https://github.com/PaddlePaddle/book/blob/develop/README.md) for PaddlePaddle book.
本教程 由 PaddlePaddle 创作,采用 知识共享 署名-相同方式共享 4.0 国际 许可协议进行许可。