t checkout -b test

Merge branch 'develop' of https://github.com/PaddlePaddle/docs into develop

Author: tianshuo78520a

.github/ISSUE_TEMPLATE/4_eval_distributed_PS_docs-issue.yml

@@ -1,12 +1,12 @@
-name:  📝 分布式文档——Parameter Sever快速开始体验评估 Eval Issue
-description: 第三期分布式文档——Parameter Sever快速开始体验评估报告。
+name:  📝 分布式文档——参数服务器(Parameter Sever)快速开始体验评估 Eval Issue
+description: 第六期分布式文档——参数服务器(Parameter Sever)快速开始体验评估报告。
 labels: [distributed_ps_eval]
 
 body:
 - type: markdown
   attributes:
     value: >
-      #### 此模板用于第三期分布式文档（Parameter Sever快速开始）评估工作小组成员，向飞桨团队反馈文档问题。如非工作小组成员，请使用 「📚文档」模板，感谢配合~
+      #### 此模板用于第六期分布式文档-参数服务器(Parameter Sever)快速开始评估工作小组成员，向飞桨团队反馈文档问题。如非工作小组成员，请使用 「📚文档」模板，感谢配合~
 
       #### This template is used by members of the distributed document evaluation working group to report documentation issues to the Paddle Team. If you are not a member of the working group, please use the "📚 Documentation Issue" template, thank you for your cooperation~
 
@@ -26,7 +26,7 @@ body:
 - type: markdown
   attributes:
     value: >
-      # Parameter Sever任务一 体验评估报告
+      # 参数服务器(Parameter Sever)任务一 体验评估报告
 
 
 - type: textarea
@@ -104,9 +104,9 @@ body:
 - type: textarea
   id: distributed_ps_eval5
   attributes:
-    label: 5.定义同步训练 Strategy 及 Optimizer	
+    label: 5.定义参数更新策略及优化器
     description: |
-      针对 定义同步训练 Strategy 及 Optimizer 这一环节，请回答以下内容
+      针对 定义参数更新策略及优化器 这一环节，请回答以下内容
     value: |
       - 完成情况（成功/不成功) ：
       - 遇到问题：
@@ -150,7 +150,7 @@ body:
 - type: markdown
   attributes:
     value: >
-      # Parameter Sever任务二 体验评估报告
+      # 参数服务器(Parameter Sever)任务二 体验评估报告
 
 
 - type: textarea
@@ -228,9 +228,9 @@ body:
 - type: textarea
   id: distributed_ps_eval15
   attributes:
-    label: 5.定义同步训练 Strategy 及 Optimizer	
+    label: 5.定义参数更新策略及优化器
     description: |
-      针对 定义同步训练 Strategy 及 Optimizer 这一环节，请回答以下内容
+      针对 定义参数更新策略及优化器 这一环节，请回答以下内容
     value: |
       - 完成情况（成功/不成功) ：
       - 遇到问题：

.pre-commit-config.yaml

@@ -1,8 +1,8 @@
 repos:
--   repo: https://github.com/pre-commit/mirrors-yapf.git
-    rev: v0.32.0
+-   repo: https://github.com/psf/black.git
+    rev: 22.8.0
     hooks:
-    -   id: yapf
+    -   id: black
         files: \.py$
 -   repo: https://github.com/pre-commit/pre-commit-hooks
     rev: v4.1.0

.pre-commit-hooks/convert_markdown_into_html.py

@@ -80,8 +80,8 @@ def convert_markdown_into_html(argv=None):
 
     for filename in args.filenames:
         with open(
-                re.sub(r"README", "index", re.sub(r"\.md$", ".html",
-                                                  filename)), "w") as output:
+            re.sub(r"README", "index", re.sub(r"\.md$", ".html", filename)), "w"
+        ) as output:
             output.write(HEAD)
             with open(filename) as input:
                 for line in input:

.travis.yml

@@ -26,7 +26,7 @@ PaddlePaddle's API documentation contains an introduction to the API. We welcome
 
 ### Guides
 
-This part of the content is stored in the [docs/docs/guides](https://github.com/PaddlePaddle/docs/tree/develop/docs/guides) directory, you can make your changes by submitting a PR. For more information, please refer to: [Document Contribution Guide](https://github.com/PaddlePaddle/docs/wiki/%E6%96%87%E6%A1%A3%E8%B4%A1%E7%8C%AE%E6%8C%87%E5%8D%97) .
+This part of the content is stored in the [docs/docs/guides](https://github.com/PaddlePaddle/docs/tree/develop/docs/guides) directory, you can make your changes by submitting a PR. For more information, please refer to: [Document Contribution Guide](https://github.com/PaddlePaddle/docs/wiki/%E6%96%87%E6%A1%A3%E8%B4%A1%E7%8C%AE%E6%8C%87%E5%8D%97).
 
 ### Practice
 
@@ -38,4 +38,4 @@ PaddlePaddle provides API documentation in both Chinese and English. The English
 
 ## Submit PR
 
-Any modification of PaddlePaddle documentation should be completed by submitting a PR. For more information, please refer to [Submit PR](https://www.paddlepaddle.org.cn/documentation/docs/zh/develop/guides/08_contribution/local_dev_guide.html)
+Any modification of PaddlePaddle documentation should be completed by submitting a PR. For more information, please refer to [Submit PR](https://www.paddlepaddle.org.cn/documentation/docs/zh/develop/guides/08_contribution/local_dev_guide.html).

CONTRIBUTING.md

@@ -30,12 +30,12 @@ API 文档是飞桨框架的 API 文档，包含了飞桨框架 API 的说明介
 
 ### 应用实践
 
-这部分内容分为源代码与官网文档两部分，源代码的部分以 notebook 的形式，存放在 [book/paddle2.0_docs](https://github.com/PaddlePaddle/book/tree/develop/paddle2.0_docs) 目录下，你可以提交你的 notebook 格式的源码于该目录中；在你的 notebook 文件被合入后，我们会将其转为 md 文件，存储在[docs/docs/tutorial](https://github.com/PaddlePaddle/docs/tree/develop/docs/tutorial)中，然后呈现到官网。具体信息请参考：[[Call for Contribution] Tutorials for PaddlePaddle 2.0](https://github.com/PaddlePaddle/book/issues/905).
+这部分内容分为源代码与官网文档两部分，源代码的部分以 notebook 的形式，存放在 [book/paddle2.0_docs](https://github.com/PaddlePaddle/book/tree/develop/paddle2.0_docs) 目录下，你可以提交你的 notebook 格式的源码于该目录中；在你的 notebook 文件被合入后，我们会将其转为 md 文件，存储在 [docs/docs/tutorial](https://github.com/PaddlePaddle/docs/tree/develop/docs/tutorial) 中，然后呈现到官网。具体信息请参考：[[Call for Contribution] Tutorials for PaddlePaddle 2.0](https://github.com/PaddlePaddle/book/issues/905)。
 
 ### API 文档
 
-飞桨框架同时提供中英文 API 文档。其中，英文 API 文档存于[Paddle](https://github.com/PaddlePaddle/Paddle/tree/develop/python/paddle)源代码中，绝大部分通过官网文档的源代码即可链接到，你可以在此位置对英文文档进行修改；而中文 API 文档存放在[docs/docs/api](https://github.com/PaddlePaddle/docs/tree/develop/docs/api)目录下。你可以针对文档中的任何错误与内容进行修复与完善，或者是新增你认为该文档中所需要的内容，我们非常感谢你对于 API 文档所付出的一切。具体修改方式请参考：[英文 API 文档贡献指南](https://github.com/PaddlePaddle/docs/wiki/%E8%8B%B1%E6%96%87API%E6%96%87%E6%A1%A3%E8%B4%A1%E7%8C%AE%E6%8C%87%E5%8D%97)、[中文 API 文档贡献指南](https://github.com/PaddlePaddle/docs/wiki/%E4%B8%AD%E6%96%87API%E6%96%87%E6%A1%A3%E8%B4%A1%E7%8C%AE%E6%8C%87%E5%8D%97)。
+飞桨框架同时提供中英文 API 文档。其中，英文 API 文档存于 [Paddle](https://github.com/PaddlePaddle/Paddle/tree/develop/python/paddle) 源代码中，绝大部分通过官网文档的源代码即可链接到，你可以在此位置对英文文档进行修改；而中文 API 文档存放在 [docs/docs/api](https://github.com/PaddlePaddle/docs/tree/develop/docs/api) 目录下。你可以针对文档中的任何错误与内容进行修复与完善，或者是新增你认为该文档中所需要的内容，我们非常感谢你对于 API 文档所付出的一切。具体修改方式请参考：[英文 API 文档贡献指南](https://github.com/PaddlePaddle/docs/wiki/%E8%8B%B1%E6%96%87API%E6%96%87%E6%A1%A3%E8%B4%A1%E7%8C%AE%E6%8C%87%E5%8D%97)、[中文 API 文档贡献指南](https://github.com/PaddlePaddle/docs/wiki/%E4%B8%AD%E6%96%87API%E6%96%87%E6%A1%A3%E8%B4%A1%E7%8C%AE%E6%8C%87%E5%8D%97)。
 
 ## 提交 PR
 
-你对于飞桨文档的任何修改，都应该通过提交 PR 的方式来完成，具体的方法可以参考[提交 PR](https://www.paddlepaddle.org.cn/documentation/docs/zh/develop/guides/08_contribution/local_dev_guide.html)
+你对于飞桨文档的任何修改，都应该通过提交 PR 的方式来完成，具体的方法可以参考[提交 PR](https://www.paddlepaddle.org.cn/documentation/docs/zh/develop/guides/08_contribution/local_dev_guide.html)。

CONTRIBUTING_cn.md

@@ -9,11 +9,11 @@ Note: English version API docs are generaly docstrings in [PaddlePaddle/Paddle](
 
 ## Codebase structure
 
-- [docs](docs): PaddlePaddle 2.0 & above docs source file,
-- [docs/api](docs/api): PaddlePaddle API docs
-- [docs/guides](docs/guides): PaddlePaddle guides docs
-- [docs/tutorial](docs/tutorial): PaddlePaddle tutorial docs
-- [ci_scripts](ci_scripts): docs CI scripts
+- [docs](docs): PaddlePaddle 2.0 & above docs source file.
+- [docs/api](docs/api): PaddlePaddle API docs.
+- [docs/guides](docs/guides): PaddlePaddle guides docs.
+- [docs/tutorial](docs/tutorial): PaddlePaddle tutorial docs.
+- [ci_scripts](ci_scripts): docs CI scripts.
 
 ## How to build
 

README.md

@@ -30,7 +30,7 @@ docs 是 [PaddlePaddle 官网文档](https://www.paddlepaddle.org.cn/documentati
     bash docs-build.sh -f absolute_path_docs
     ```
   - step3: preview docs
-  输出的文件会保存在 docs/output 路径下.
+  输出的文件会保存在 docs/output 路径下。
 
 ## 贡献
 

README_cn.md

@@ -28,7 +28,6 @@ pytest' >requirements && \
 RUN echo 'Pillow\n\
 numpy\n\
 gast==0.3.3\n\
-six\n\
 protobuf\n\
 urllib3\n\
 certifi\n\

ci_scripts/Dockerfile

@@ -1,6 +1,9 @@
 #!/bin/bash
 set -x
 
+OUTPUTDIR=${OUTPUTDIR:=/docs}
+VERSIONSTR=${VERSIONSTR:=develop}
+
 SCRIPT_DIR="$( cd "$( dirname "$0" )" && pwd )"
 source ${SCRIPT_DIR}/utils.sh
 
@@ -30,6 +33,13 @@ function filter_cn_api_files() {
 
 need_check_cn_doc_files="$1"
 echo $need_check_cn_doc_files
+# Check COPY-FROM is parsed into Sample Code
+echo "Run COPY-FROM parsed into Sample Code Check"
+python check_copy_from_parsed_into_sample_code.py "${OUTPUTDIR}/zh/${VERSIONSTR}/" $need_check_cn_doc_files
+if [ $? -ne 0 ];then
+    echo "ERROR: Exist COPY-FROM has not been parsed into sample code, please check COPY-FROM in the above files"
+    exit 1
+fi
 need_check_files=$(filter_cn_api_files "${need_check_cn_doc_files}")
 echo "$need_check_files"
 if [ "$need_check_files" = "" ]