some problems in doc, compile from source code in install/index_en.html linked to chinese document. (PaddlePaddle#3344)

* the link without _en in url is zh_CN document

* some problems in FAQ

using img tag

using quote not codeblock for this

using quote not codeblock for this

* format the inline codes

* update the .gitignore

* plural Issues

Author: wadefelix

.gitignore

@@ -4,3 +4,4 @@
 /doc/fluid/menu.en.json
 .idea
 build
+*_en.rst

doc/paddle/faq/2.0.md

@@ -44,7 +44,7 @@
 
 ##### 问题：从1.x版本升级为2.0版本，哪些API有变动 ？
 
-+ 答复：飞桨框架2.0.0版本推荐用户使用位于paddle根目录下的API，同时在paddle.fluid目录下保留了所有的1.x版本的API，保留对之前版本API体系的支持。
++ 答复：飞桨框架2.0.0版本推荐用户使用位于paddle根目录下的API，同时在`paddle.fluid`目录下保留了所有的1.x版本的API，保留对之前版本API体系的支持。
 
 查看API变动的两种方法：
 
@@ -76,17 +76,17 @@
 
 + 问题分析：
 
-2.0版本默认开启了动态图模式。即当用户调用import paddle后，此时Paddle已经运行在动态图模式下。基于1.8开发的静态图代码，在2.0版本下直接执行会出错。为此，我们在静态图的一些入口API 中加入了报错检查，例如直接调用fluid.data会遇到如下错误：
+2.0版本默认开启了动态图模式。即当用户调用`import paddle`后，此时Paddle已经运行在动态图模式下。基于1.8开发的静态图代码，在2.0版本下直接执行会出错。为此，我们在静态图的一些入口API 中加入了报错检查，例如直接调用`fluid.data`会遇到如下错误：
 
 ![图片](https://paddlepaddleimage.cdn.bcebos.com/faqimage%2Fbj-fcd837654fa8c5bb15b071ecaad6b92ef632d872.png)
 
 + 解决方案：
 
-1. 旧版本（1.8及之前版本）静态图下的代码，需要在import paddle后的头部位置加入paddle.enable_static()来开启静态图模式，这样才能正常运行。
+1. 旧版本（1.8及之前版本）静态图下的代码，需要在`import paddle`后的头部位置加入`paddle.enable_static()`来开启静态图模式，这样才能正常运行。
 
 2. 原来通过dygraph guard写的动态图代码仍然可以正常执行。但在2.0下可以不需要像以前写dygraph guard，直接按照动态图模式编写代码。
 
-3. 同时，请注意对于GPU版本的paddle，在import paddle时默认开启动态图会选择CUDAPlace作为默认place。如果要修改place，可以通过paddle.set_device()来完成。
+3. 同时，请注意对于GPU版本的paddle，在`import paddle`时默认开启动态图会选择`CUDAPlace`作为默认place。如果要修改place，可以通过`paddle.set_device()`来完成。
 
 
 ----------
@@ -96,8 +96,8 @@
 
 + 答复：
 
-2.0版本新增动态图梯度累加功能，起到变相“扩大BatchSize”的作用，backward()接口默认不清空上个step梯度。
+2.0版本新增动态图梯度累加功能，起到变相“扩大BatchSize”的作用，`backward()`接口默认不清空上个step梯度。
 
 + 解决方案：
 
-调用optimizer.minimize()后，显式调用optimizer.clear_grad()来清空梯度。
+调用`optimizer.minimize()`后，显式调用`optimizer.clear_grad()`来清空梯度。

doc/paddle/faq/data_cn.md

@@ -5,9 +5,9 @@
 
 + 答复：当训练时使用的数据集数据量较大或者预处理逻辑复杂时，如果串行地进行数据读取，数据读取往往会成为训练效率的瓶颈。这种情况下通常需要利用多线程或者多进程的方法异步地进行数据载入，从而提高数据读取和整体训练效率。
 
-paddle中推荐使用 DataLoader，这是一种灵活的异步加载方式。
+paddle中推荐使用 `DataLoader`，这是一种灵活的异步加载方式。
 
-该API提供了多进程的异步加载支持，可以配置num_workers指定异步加载数据的进程数目从而满足不同规模数据集的读取需求。
+该API提供了多进程的异步加载支持，可以配置`num_workers`指定异步加载数据的进程数目从而满足不同规模数据集的读取需求。
 
 具体使用方法及示例请参考API文档：[paddle.io.DataLoader](https://www.paddlepaddle.org.cn/documentation/docs/zh/api/paddle/io/DataLoader_cn.html#dataloader)
 
@@ -42,7 +42,7 @@ paddle中推荐使用 DataLoader，这是一种灵活的异步加载方式。
 
 + 答复：在动态图模式下，可以参考如下示例：
 
-```
+```python
 import paddle
 import numpy as np
 

doc/paddle/faq/index_cn.rst

@@ -4,9 +4,9 @@
 
 本栏目以问答对的形式收录了用户开发过程中遇到的高频咨询类问题，包含了2.0版本的变化、安装、数据与数据处理、模型组网、训练、预测、模型保存与加载、参数调整等几类常见问题。
 
-除次之外，你也可以查看 `官网API文档 <https://www.paddlepaddle.org.cn/documentation/docs/zh/guides/index_cn.html>`_ 、 `历史Issue <https://github.com/PaddlePaddle/Paddle/issues>`_ 、 `AI社区 <https://ai.baidu.com/forum/topic/list/168>`_ 来寻求解答。
+除次之外，你也可以查看 `官网API文档 <https://www.paddlepaddle.org.cn/documentation/docs/zh/guides/index_cn.html>`_ 、 `历史Issues <https://github.com/PaddlePaddle/Paddle/issues>`_ 、 `AI社区 <https://ai.baidu.com/forum/topic/list/168>`_ 来寻求解答。
 
-同时，你也可以在 `Github Issue <https://github.com/PaddlePaddle/Paddle/issues>`_ 中进行提问，我们会有专门的技术人员为您解答。
+同时，你也可以在 `Github Issues <https://github.com/PaddlePaddle/Paddle/issues>`_ 中进行提问，我们会有专门的技术人员为您解答。
 
 本栏目收录的问题集：
 

doc/paddle/faq/install_cn.md

@@ -5,18 +5,12 @@
 
 + 问题描述:
 
-TensorRT dynamic library (libnvinfer.so) that Paddle depends on is not configured correctly. (error code is libnvinfer.so: cannot open shared object file: No such file or directory)
-
-Suggestions:
-
-Check if TensorRT is installed correctly and its version is matched with paddlepaddle you installed.
-
-Configure TensorRT dynamic library environment variables as follows:
-
-Linux: set LD_LIBRARY_PATH by export LD_LIBRARY_PATH=...
-
-Windows: set PATH by `set PATH=XXX;
-
+> TensorRT dynamic library (libnvinfer.so) that Paddle depends on is not configured correctly. (error code is libnvinfer.so: cannot open shared object file: No such file or directory)  
+> Suggestions:  
+> Check if TensorRT is installed correctly and its version is matched with paddlepaddle you installed.  
+> Configure TensorRT dynamic library environment variables as follows:  
+> Linux: set LD_LIBRARY_PATH by export LD_LIBRARY_PATH=...  
+> Windows: set PATH by `set PATH=XXX;  
 + 问题分析：
 
 遇到该问题是因为使用的paddle默认开始了TensorRT，但是本地环境中没有找到TensorRT的库，该问题只影响使用[Paddle Inference](https://paddleinference.paddlepaddle.org.cn/master/product_introduction/inference_intro.html)开启TensorRT预测的场景，对其它方面均不造成影响。
@@ -37,17 +31,21 @@ Windows: set PATH by `set PATH=XXX;
 
 1. Python2情况下，使用如下命令安装PaddlePaddle。
 
-   `pip install paddlepaddle -i https://mirror.baidu.com/pypi/simple/`
+   ```bash
+   pip install paddlepaddle -i https://mirror.baidu.com/pypi/simple/`
+   ```
 
 2. Python3情况下，使用如下命令安装PaddlePaddle。
 
-   `pip3 install paddlepaddle -i https://mirror.baidu.com/pypi/simple/`
+   ```bash
+   pip3 install paddlepaddle -i https://mirror.baidu.com/pypi/simple/`
+   ```
 
 你还可以通过如下三个地址获取pip安装包，只需修改 `-i` 后网址即可：
 
-https://pypi.tuna.tsinghua.edu.cn/simple
-https://mirrors.aliyun.com/pypi/simple/
-https://pypi.douban.com/simple/
+1. https://pypi.tuna.tsinghua.edu.cn/simple
+2. https://mirrors.aliyun.com/pypi/simple/
+3. https://pypi.douban.com/simple/
 
 ------
 
@@ -57,15 +55,15 @@ https://pypi.douban.com/simple/
 
 使用pip install时报错，`PermissionError: [WinError 5]` ，
 
-`C:\\program fiels\\python35\\Lib\\site-packages\\graphviz`。
+`C:\\Program Files\\python35\\Lib\\site-packages\\graphviz`。
 
 + 报错分析：
 
-用户权限问题导致，由于用户的Python安装到系统文件内（如”Program Files/“），任何的操作都需要管理员权限。
+用户权限问题导致，由于用户的Python安装到系统文件内（如`Program Files/`），任何的操作都需要管理员权限。
 
 + 解决方法：
 
-选择“以管理员身份运行”运行CMD，重新执行安装过程, 使用命令sudo pip install paddlepaddle
+选择“以管理员身份运行”运行CMD，重新执行安装过程, 使用命令`pip install paddlepaddle`。
 
 ------
 
@@ -75,8 +73,9 @@ https://pypi.douban.com/simple/
 
 使用pip install时报错，`ERROR: Could not find a version that satisfies the requirement paddlepaddle (from versions: none)`
 
-``ERROR: No matching distribution found for paddlepaddle`
-![图片](https://agroup-bos-bj.cdn.bcebos.com/bj-febb18fb78004dc17f18d60a009dc6a8bd907251)
+`ERROR: No matching distribution found for paddlepaddle`
+
+<img src="https://agroup-bos-bj.cdn.bcebos.com/bj-febb18fb78004dc17f18d60a009dc6a8bd907251" alt="图片" />
 
 + 报错分析：
 
@@ -92,11 +91,11 @@ Python版本不匹配导致。用户使用的是32位Python，但是对应的32
 
 + 报错分析：
 
-原因在于用户的计算机上可能安装了多个版本的Python，而安装PaddlePaddle时的Python和import paddle时的Python版本不一致导致报错。如果用户熟悉PyCharm等常见的IDE配置包安装的方法，配置运行的方法，则可以避免此类问题。
+原因在于用户的计算机上可能安装了多个版本的Python，而安装PaddlePaddle时的Python和`import paddle`时的Python版本不一致导致报错。如果用户熟悉PyCharm等常见的IDE配置包安装的方法，配置运行的方法，则可以避免此类问题。
 
 + 解决方法：
 
-用户明确安装Paddle的python位置，并切换到该python进行安装。可能需要使用python -m pip install paddlepaddle命令确保paddle是安装到该python中。
+用户明确安装Paddle的python位置，并切换到该python进行安装。可能需要使用`python -m pip install paddlepaddle`命令确保paddle是安装到该python中。
 
 ------
 
@@ -124,11 +123,13 @@ CUDA安装错误导致。
 
 + 解决方法：
 
-查找“libcudart.so”所在目录，并将其添加到“LD_LIBRARY_PATH”中。
+查找“libcudart.so”所在目录，并将其添加到`LD_LIBRARY_PATH`中。
 
-例如：执行`find / -name libcudart.so`, 发现libcudart.so在“/usr/local/cuda-10.0/targets/x86_64-linux/lib/libcudart.so”路径下， 使用如下命令添加即可。
+例如：执行`find / -name libcudart.so`, 发现libcudart.so在`/usr/local/cuda-10.0/targets/x86_64-linux/lib/libcudart.so`路径下， 使用如下命令添加即可。
 
-`export LD_LIBRARY_PATH=/usr/local/cuda-10.0/targets/x86_64-linux/lib/libcudart.so$LD_LIBRARY_PATH`
+```bash
+export LD_LIBRARY_PATH=/usr/local/cuda-10.0/targets/x86_64-linux/lib/libcudart.so:${LD_LIBRARY_PATH}
+```
 
 ------
 
@@ -138,19 +139,26 @@ CUDA安装错误导致。
 
 1. GPU环境：
 
- `pip install -U paddlepaddle-gpu`
+  ```bash
+  pip install -U paddlepaddle-gpu`
+  ```
 
 或者
 
-`pip install paddlepaddle-gpu == 需要安装的版本号（如2.0）`
+  ```bash
+  pip install paddlepaddle-gpu == 需要安装的版本号（如2.0）`
+  ```
 
 2. CPU环境：
 
-`pip install -U paddlepaddle`
-
+  ```bash
+  pip install -U paddlepaddle`
+  ```
 或者
 
-`pip install paddlepaddle == 需要安装的版本号（如2.0）`
+  ```bash
+  pip install paddlepaddle == 需要安装的版本号（如2.0）`
+  ```
 
 ------
 

doc/paddle/faq/params_cn.md

@@ -23,7 +23,7 @@
 
 + 答复：
 
-1. 在动态图中，使用`paddle.save` API， 并将最后一层的layer.state_dict() 传入至save方法的obj 参数即可， 然后>    使用`paddle.load` 方法加载对应层的参数值。详细可参考API文档[save](https://www.paddlepaddle.org.cn/documentat    ion/docs/zh/api/paddle/framework/io/save_cn.html#save) 和[load](https://www.paddlepaddle.org.cn/documentatio    n/docs/zh/api/paddle/framework/io/load_cn.html#load)。
+1. 在动态图中，使用`paddle.save` API， 并将最后一层的`layer.state_dict()` 传入至save方法的obj 参数即可， 然后使用`paddle.load` 方法加载对应层的参数值。详细可参考API文档[save](https://www.paddlepaddle.org.cn/documentation/docs/zh/api/paddle/framework/io/save_cn.html#save) 和[load](https://www.paddlepaddle.org.cn/documentation/docs/zh/api/paddle/framework/io/load_cn.html#load)。
 2. 在静态图中，使用`paddle.static.save_vars`保存指定的vars，然后使用`paddle.static.load_vars`加载对应层的参数值。具体示例请见API文档：[load_vars](https://www.paddlepaddle.org.cn/documentation/docs/zh/api/paddle/fluid/io/load_vars_cn.html) 和 [save_vars](https://www.paddlepaddle.org.cn/documentation/docs/zh/api/paddle/fluid/io/save_vars_cn.html) 。
 
 ----------
@@ -46,7 +46,7 @@
 
   `step`表示的是经历了多少组mini_batch，其统计方法为`exe.run`(对应Program)运行的当前次数，即每运行一次`exe.run`，step加1。举例代码如下：
 
-```text
+```python
 # 执行下方代码后相当于step增加了N x Epoch总数
 for epoch in range(epochs):
     # 执行下方代码后step相当于自增了N

doc/paddle/faq/train_cn.md

@@ -14,13 +14,13 @@
 
 ##### 问题：在模型组网时，inplace参数的设置会影响梯度回传吗？经过不带参数的op之后，梯度是否会保留下来？
 
-+ 答复：inplace 参数不会影响梯度回传。只要用户没有手动设置stop_gradient=True，梯度都会保留下来。
++ 答复：inplace 参数不会影响梯度回传。只要用户没有手动设置`stop_gradient=True`，梯度都会保留下来。
 
 ----------
 
 ##### 问题：如何不训练某层的权重？
 
-+ 答复：在`ParamAttr`里设置learning_rate=0或trainable设置为False。具体请参考文档：https://www.paddlepaddle.org.cn/documentation/docs/zh/api/paddle/fluid/param_attr/ParamAttr_cn.html
++ 答复：在`ParamAttr`里设置`learning_rate=0`或`trainable`设置为`False`。具体请[参考文档](https://www.paddlepaddle.org.cn/documentation/docs/zh/api/paddle/fluid/param_attr/ParamAttr_cn.html)
 
 ----------
 
@@ -30,7 +30,7 @@
 
 1. 使用多进程DataLoader加速数据读取：训练数据较多时，数据处理往往会成为训练速度的瓶颈，paddle提供了异步数据读取接口DataLoader，可以使用多进程进行数据加载，充分利用多处理的优势，具体使用方法及示例请参考API文档：[paddle.io.DataLoader](https://www.paddlepaddle.org.cn/documentation/docs/zh/api/paddle/io/DataLoader_cn.html#dataloader)。
 
-2. 推荐使用支持MKL（英特尔数学核心函数库）的paddle安装包，MKL相比Openblas等通用计算库在计算速度上有显著的优势，能够提升您的训练效率。
+2. 推荐使用支持[MKL（英特尔数学核心函数库）](https://software.intel.com/content/www/us/en/develop/tools/oneapi/components/onemkl.html)的paddle安装包，MKL相比Openblas等通用计算库在计算速度上有显著的优势，能够提升您的训练效率。
 
 ----------
 
@@ -60,7 +60,7 @@
 
 2. 开启以下三个选项：
 
-```
+```bash
 #一旦不再使用即释放内存垃圾，=1.0 垃圾占用内存大小达到10G时，释放内存垃圾`
 export FLAGS_eager_delete_tensor_gb=0.0`
 #启用快速垃圾回收策略，不等待cuda kernel 结束，直接释放显存`
@@ -123,9 +123,9 @@ export FLAGS_fraction_of_gpu_memory_to_use=0`
 
 ----------
 
-##### 问题：load_inference_model在加载预测模型时能否用py_reader读取？
+##### 问题：`load_inference_model`在加载预测模型时能否用`py_reader`读取？
 
-+ 答复：目前`load_inference_model`加载进行的模型还不支持py_reader输入。
++ 答复：目前`load_inference_model`加载进行的模型还不支持`py_reader`输入。
 
 ----------
 

doc/paddle/install/index_en.rst

@@ -221,7 +221,7 @@ The second way to install: compile and install with source code
 ===============================================================
 
 - If you use PaddlePaddle only, we suggest you installation methods **pip** to install.
-- If you need to develop PaddlePaddle, please refer to `compile from source code <compile/fromsource.html>`_
+- If you need to develop PaddlePaddle, please refer to `compile from source code <compile/fromsource_en.html>`_
 
 ..	toctree::
 	:hidden: