From 2a8b44c525030b3c5d98611c4dd65ec4a95ea4d1 Mon Sep 17 00:00:00 2001 From: KP <109694228@qq.com> Date: Fri, 1 Apr 2022 14:37:23 +0800 Subject: [PATCH 1/3] Update README.md Update readme in docs. test=doc --- paddleaudio/docs/README.md | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/paddleaudio/docs/README.md b/paddleaudio/docs/README.md index 8e4fccc5..f35d1d00 100644 --- a/paddleaudio/docs/README.md +++ b/paddleaudio/docs/README.md @@ -1,14 +1,15 @@ # Build docs for PaddleAudio +Execute the following steps in **current directory**. + ## 1. Install -`pip install Sphinx` -`pip install sphinx_rtd_theme` +`pip install Sphinx sphinx_rtd_theme` ## 2. Generate API docs -Exclude `paddleaudio.utils` +Generate API docs from doc string `*py` `sphinx-apidoc -fMeT -o source ../paddleaudio ../paddleaudio/utils --templatedir source/_templates` @@ -16,3 +17,8 @@ Exclude `paddleaudio.utils` ## 3. Build `sphinx-build source _html` + + +## 4. Preview + +Open `_html/index.html` for page preview. From fd345180dd7513ea8e73e987f03bb7460e3bfe6d Mon Sep 17 00:00:00 2001 From: KP <109694228@qq.com> Date: Fri, 1 Apr 2022 14:59:41 +0800 Subject: [PATCH 2/3] Add readme. test=doc --- paddleaudio/README.md | 7 +++++++ 1 file changed, 7 insertions(+) create mode 100644 paddleaudio/README.md diff --git a/paddleaudio/README.md b/paddleaudio/README.md new file mode 100644 index 00000000..697c0173 --- /dev/null +++ b/paddleaudio/README.md @@ -0,0 +1,7 @@ +# PaddleAudio + +PaddleAudio is an audio library for PaddlePaddle. + +## Install + +`pip install .` From 585eb9aec5fd69011d9121868385574b58af8db4 Mon Sep 17 00:00:00 2001 From: KP <109694228@qq.com> Date: Fri, 1 Apr 2022 15:00:31 +0800 Subject: [PATCH 3/3] Update readme. test=doc --- paddleaudio/docs/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/paddleaudio/docs/README.md b/paddleaudio/docs/README.md index f35d1d00..20626f52 100644 --- a/paddleaudio/docs/README.md +++ b/paddleaudio/docs/README.md @@ -9,7 +9,7 @@ Execute the following steps in **current directory**. ## 2. Generate API docs -Generate API docs from doc string `*py` +Generate API docs from doc string. `sphinx-apidoc -fMeT -o source ../paddleaudio ../paddleaudio/utils --templatedir source/_templates`