From 15231f0c71e5ce932041ca4761dd15e39c779dc9 Mon Sep 17 00:00:00 2001 From: yangyaming Date: Sat, 3 Mar 2018 20:27:54 +0800 Subject: [PATCH 1/2] Refine the doc for build_and_install. --- doc/build_and_install/index_cn.rst | 55 ++++++++++++++++++++++-------- 1 file changed, 40 insertions(+), 15 deletions(-) diff --git a/doc/build_and_install/index_cn.rst b/doc/build_and_install/index_cn.rst index c0b60f55895f1..f6611330acef3 100644 --- a/doc/build_and_install/index_cn.rst +++ b/doc/build_and_install/index_cn.rst @@ -3,30 +3,55 @@ .. _install_steps: -安装流程 -++++++++ +PaddlePaddle针对不同的用户群体提供了多种安装方式。 -PaddlePaddle提供pip和Docker的安装方式: +专注深度学习模型开发 +----------------- + +PaddlePaddle提供了多种python wheel包,可通过pip一键安装: + +.. toctree:: + :maxdepth: 1 + + pip_install_cn.rst + +这是最便捷的安装方式,请根据机器配置和系统选择对应的安装包。 + +关注底层框架 +---------- + +PaddlePaddle提供了基于Docker的安装方式,请参照以下教程: + +.. toctree:: + :maxdepth: 1 + + docker_install_cn.rst + +我们推荐在Docker中运行PaddlePaddle,该方式具有以下优势: + +- 无需单独安装第三方依赖 +- 方便分享运行时环境,易于问题的复现 + +对于有定制化二进制文件需求的用户,我们同样提供了从源码编译安装PaddlePaddle的方法: .. toctree:: :maxdepth: 1 - pip_install_cn.rst - docker_install_cn.rst + build_from_source_cn.rst + + +.. warning:: -编译流程 -++++++++ + 需要提醒的是,这种安装方式会涉及到一些第三方库的下载、编译及安装,安装过程较长。 -.. warning:: - 建议直接使用上述安装流程,方便快速安装。只有在遇到需要独立定制的二进制时才需要编译。 +常见问题汇总 +----------- -.. toctree:: - :maxdepth: 1 +如果在安装过程中遇到了问题,请先尝试在下面的页面寻找答案: - build_from_source_cn.rst +:ref:`faq/build_and_install/index_cn.rst` -常见问题解答 -++++++++++ +如果问题没有得到解决,欢迎向PaddlePaddle社区反馈问题: -`常见问题解答 `_ +`创建issue `_ From 649f9c19638e377fa165aa3c9d257702c99422be Mon Sep 17 00:00:00 2001 From: yangyaming Date: Mon, 5 Mar 2018 13:48:12 +0800 Subject: [PATCH 2/2] Refine the document for build_and_install. --- doc/build_and_install/index_cn.rst | 9 ++++----- doc/faq/build_and_install/index_cn.rst | 2 ++ 2 files changed, 6 insertions(+), 5 deletions(-) diff --git a/doc/build_and_install/index_cn.rst b/doc/build_and_install/index_cn.rst index f6611330acef3..e079bb661f3a5 100644 --- a/doc/build_and_install/index_cn.rst +++ b/doc/build_and_install/index_cn.rst @@ -35,14 +35,13 @@ PaddlePaddle提供了基于Docker的安装方式,请参照以下教程: 对于有定制化二进制文件需求的用户,我们同样提供了从源码编译安装PaddlePaddle的方法: .. toctree:: - :maxdepth: 1 - - build_from_source_cn.rst + :maxdepth: 1 + build_from_source_cn.rst .. warning:: - 需要提醒的是,这种安装方式会涉及到一些第三方库的下载、编译及安装,安装过程较长。 + 需要提醒的是,这种安装方式会涉及到一些第三方库的下载、编译及安装,整个安装过程耗时较长。 常见问题汇总 @@ -50,7 +49,7 @@ PaddlePaddle提供了基于Docker的安装方式,请参照以下教程: 如果在安装过程中遇到了问题,请先尝试在下面的页面寻找答案: -:ref:`faq/build_and_install/index_cn.rst` +:ref:`常见问题解答 ` 如果问题没有得到解决,欢迎向PaddlePaddle社区反馈问题: diff --git a/doc/faq/build_and_install/index_cn.rst b/doc/faq/build_and_install/index_cn.rst index 31d2252eb5f5f..7c7e896d187e4 100644 --- a/doc/faq/build_and_install/index_cn.rst +++ b/doc/faq/build_and_install/index_cn.rst @@ -1,3 +1,5 @@ +.. _install_faq: + ################### 编译安装与单元测试 ###################