Merge pull request #1128 from PaddlePaddle/Jackwaterveg-patch-2

[Install_cn]Create install_cn.md

docs/source/install_cn.md

@@ -0,0 +1,244 @@
+# 安装方法
+
+`PaddleSpeech`有三种安装方法。根据安装的难易程度，这三种方法可以分为 **简单**, **中等** 和 **困难**.
+
+| 方式 | 功能                                                         | 支持系统            |
+| :--- | :----------------------------------------------------------- | :------------------ |
+| 简单 | (1) 使用PaddleSpeech的命令行功能. <br> (2) 在 Aistudio上体验PaddleSpeech. | Linux, Mac，Windows |
+| 中等 | 支持PaddleSpeech主要功能，比如使用已有examples中的模型和使用PaddleSpeech来训练自己的模型. | Linux               |
+| 困难 | 支持PaddleSpeech的各项功能，包含训练语言模型,使用强制对齐等。并且你更能成为一名开发者！ | Ubuntu              |
+
+## 先决条件
+
+- Python >= 3.7
+- 最新版本的PaddlePaddle (请看 [安装向导] (https://www.paddlepaddle.org.cn/documentation/docs/en/beginners_guide/index_en.html))
+- C++ 编译环境
+- 提示: 对于Linux和Max，请不要使用`sh`代替安装文档中的`bash`
+
+## 简单： 获取基本功能(支持Linux，Mac和Windows)
+
+- 如果你是一个刚刚接触`PaddleSpeech`的新人并且想要很方便地体验一下该项目。我们建议你 体验一下[AI Studio](https://aistudio.baidu.com/aistudio/index)。我们在AI Studio上面建立了一个让你一步一步运行体验来使用`PaddleSpeech`的教程。
+- 如果你想使用`PaddleSpeech`的命令行功能，你需要跟随下面的步骤来安装`PaddleSpeech`。如果你想了解更多关于使用`PaddleSpeech`命令行功能的信息，你可以参考 [cli](https://github.com/PaddlePaddle/PaddleSpeech/tree/develop/paddlespeech/cli)。
+
+### 安装Conda
+
+Conda是一个包管理的环境。你可以前往[minicoda](https://docs.conda.io/en/latest/miniconda.html) 去下载并安装conda（请下载py>=3.7的版本）。
+然后你需要安装`paddlespeech`的conda依赖:
+
+```bash
+conda install -y -c conda-forge sox libsndfile bzip2
+```
+
+### 安装C++ 编译环境
+
+(如果你系统上已经安装了C++编译环境，请忽略这一步。)
+
+#### Windows
+
+对于Windows系统，需要安装`Visual Studio`来完成C++编译环境的安装。
+
+#### Mac
+
+```bash
+brew install gcc
+```
+
+#### Linux
+
+```bash
+#  centos
+sudo yum install gcc gcc-c++
+```
+
+```bash
+# ubuntu
+sudo apt install build-essential
+```
+
+```bash
+# Others
+conda install -y -c gcc_linux-64=8.4.0 gxx_linux-64=8.4.0
+```
+
+### 安装 PaddleSpeech
+
+你可以使用如下命令：
+
+```bash
+pip install paddlepaddle paddlespeech
+```
+
+## 中等： 获取主要功能（支持Linux）
+
+如果你想要使用`paddlespeech`的主要功能。你需要完成4个步骤
+
+### 安装Conda
+
+Conda是一个包管理的环境。你可以前往[minicoda](https://docs.conda.io/en/latest/miniconda.html) 去下载并安装conda（请下载py>=3.7的版本）。你可以尝试自己安装，或者使用以下的命令：
+
+```bash
+# download the miniconda
+wget https://repo.continuum.io/miniconda/Miniconda3-latest-Linux-x86_64.sh
+# install the miniconda
+bash Miniconda3-latest-Linux-x86_64.sh -b
+# conda init
+$HOME/miniconda3/bin/conda init
+# activate the conda
+bash
+```
+
+然后你可以创建一个conda的虚拟环境：
+
+```bash
+conda create -y -p tools/venv python=3.7
+```
+
+激活conda虚拟环境：
+
+```bash
+conda activate tools/venv
+```
+
+安装`paddlespeech`的conda依赖：
+
+```bash
+conda install -y -c conda-forge sox libsndfile swig bzip2
+```
+
+### 安装C++ 编译环境
+
+(如果你系统上已经安装了C++编译环境，请忽略这一步。)
+你可以使用如下的步骤来安装C++的编译环境`gcc` and `gxx`：
+
+```bash
+#  centos
+sudo yum install gcc gcc-c++
+```
+
+```bash
+# ubuntu
+sudo apt install build-essential
+```
+
+```bash
+# Others
+conda install -y -c gcc_linux-64=8.4.0 gxx_linux-64=8.4.0
+```
+
+（提示： 如果你想使用**困难**方式完成安装，请不要使用最后一条命令）
+
+### 安装 PaddlePaddle
+
+你可以根据系统配置选择PaddlePaddle版本，例如系统使用CUDA 10.2, CuDNN7.5 ，你可以安装paddlepaddle-gpu 2.2.0：
+
+```bash
+python3 -m pip install paddlepaddle-gpu==2.2.0
+```
+
+### 安装 PaddleSpeech
+
+你需要使用`git clone`的方式下载并安装 `paddlespeech`，这样你才可以使用`paddlespeech`中已有的examples：
+
+```bash
+https://github.com/PaddlePaddle/PaddleSpeech.git
+cd PaddleSpeech
+pip install .
+```
+
+## 困难： 获取所有功能（支持 Ubuntu）
+
+### 先决条件
+
+- Ubuntu >= 16.04
+- 选择 1： 使用`Ubuntu` docker。
+- 选择 2： 使用`Ubuntu` ，并且拥有root权限。
+
+为了避免各种环境配置问题，我们非常推荐你使用docker容器。如果你不想使用docker，但是可以使用拥有root权限的Ubuntu系统，你也可以完成**困难**方式的安装。
+
+### 选择1： 使用Docker容器（推荐）
+
+Docker 是一种开源工具，用于在和系统本身环境相隔离的环境中构建、发布和运行各类应用程序。你可以访问[hub.docker.com](https://hub.docker.com)来下载各种版本的docker，目前已经有适用于`PaddleSpeech`的docker提供在了该网站上。Docker镜像需要使用Nvidia GPU，所以你也需要提前安装好[nvidia-docker](https://github.com/NVIDIA/nvidia-docker) 。
+你需要完成几个步骤来启动docker：
+
+- 下载docker镜像:
+  例如，拉取paddle2.2.0镜像：
+
+```bash
+nvidia-docker pull registry.baidubce.com/paddlepaddle/paddle:2.2.0-gpu-cuda10.2-cudnn7
+```
+
+- 克隆 `PaddleSpeech` 仓库
+
+```bash
+git clone https://github.com/PaddlePaddle/PaddleSpeech.git
+```
+
+- 启动docker镜像
+
+```bash
+sudo nvidia-docker run --net=host --ipc=host --rm -it -v $(pwd)/PaddleSpeech:/PaddleSpeech registry.baidubce.com/paddlepaddle/paddle:2.2.0-gpu-cuda10.2-cudnn7 /bin/bash
+```
+
+- 进入PaddleSpeech目录
+
+```bash
+cd /PaddleSpeech
+```
+
+完成这些以后，你就可以在docker容器中执行训练、推理和超参fine-tune
+
+### 选择2： 使用有root权限的Ubuntu
+
+- 使用apt安装`build-essential`
+
+```bash
+sudo apt install build-essential
+```
+
+- 克隆 `PaddleSpeech` 仓库
+
+```bash
+git clone https://github.com/PaddlePaddle/PaddleSpeech.git
+# 进入PaddleSpeech目录
+cd PaddleSpeech
+```
+
+### 安装Conda
+
+```bash
+# 下载并安装miniconda
+pushd tools
+bash extras/install_miniconda.sh
+popd
+# 使用"bash" 命令激活Conda环境
+bash
+# 创建Conda虚拟环境
+conda create -y -p tools/venv python=3.7
+# 激活Conda虚拟环境:
+conda activate tools/venv
+# 安装Conda包
+conda install -y -c conda-forge sox libsndfile swig bzip2 libflac bc
+```
+
+### 安装PaddlePaddle
+
+请确认你系统是否有GPU，并且使用了正确版本的paddlepaddle。例如系统使用CUDA 10.2, CuDNN7.5 ，你可以安装paddlepaddle-gpu 2.2.0：
+
+```bash
+python3 -m pip install paddlepaddle-gpu==2.2.0
+```
+
+### 用开发者模式安装PaddleSpeech
+
+```bash
+pip install -e .[develop]
+```
+
+### 安装Kaldi（可选）
+
+```bash
+pushd tools
+bash extras/install_openblas.sh
+bash extras/install_kaldi.sh
+popd
+```