update

Author: cqusers

.gitignore

@@ -0,0 +1 @@
+.vscode/*

DESCRIPTION.rst

@@ -0,0 +1,3 @@
+PiSloth
+=======================
+Library for PiSloth

MANIFEST.in

@@ -0,0 +1,7 @@
+include DESCRIPTION.rst
+
+# Include the test suite (FIXME: does not work yet)
+# recursive-include tests *
+
+# If using Python 3.5 or less, then have to include package data, even though
+# it's already declared in setup.py

docs/source/dance.rst

@@ -1,9 +1,9 @@
 Dance
 =========
 
-在这个项目中，我们会播放一段音乐，并让Pisloth跟着音乐的节奏来跳一段舞。
+In this project, we will play a piece of music and let Pisloth dance to the rhythm of the music.
 
-You can open ``dancing.py`` in the folder of the ``example`` or directly copy the following code to the Python IDE to run.
+You can open ``dancing.py`` in the folder of the ``example`` with command ``sudo pyrhon3 dancing.py`` or directly copy the following code to the Python IDE to run.
 
 **Code**
 
@@ -69,23 +69,22 @@ You can open ``dancing.py`` in the folder of the ``example`` or directly copy th
 
 **How it works?**
 
-你可以通过导入下面的这个库来让pisloth播放音乐。
+You can make Pisloth play music by importing the following library.
 
 .. code:: python
 
     from robot_hat import TTS, Music
 
-播放musics目录下的背景音乐并设置音量为20。
+Play the background music in the music directory and set the volume to 20.
 
 .. code:: python
 
     music.background_music('./musics/india-Arulo.mp3')
     music.music_set_volume(20)
 
-执行函数 ``sloth.do_action(motion_name,step=1,speed=None,bpm=None)`` 让pisloth执行设定好的动作。
-这里的bpm参数会影响pisloth做动作的间隔时间，数值越大，间隔时间越短。
-当我们通过一些方法了解到一首音乐的bpm后，你可以根据这首音乐的bpm自由搭配pisloth的动作，来让它伴随不同风格的音乐跳
-不同风格的舞蹈。
+Execute the function ``sloth.do_action(motion_name,step=1,speed=None,bpm=None)`` to let Pisloth perform the actions we set.
+The bpm parameter here will affect the interval time between Pisloth's actions, the larger the value, the shorter the interval time.
+When we learn about the bpm of a piece of music through some methods, you can freely match the movement of the Pisloth according to the bpm of this music to make it dance with different styles of music.
 
-对于音乐的bmp，如果你想了解更多，可以参考:
+For music bmp, if you want to know more, you can refer to:
 https://en.wikipedia.org/wiki/Tempo

docs/source/diy_action.rst

@@ -1,7 +1,7 @@
 DIY Action
 ===============
 
-通过之前课程的学习，你是不是对pisloth有了更深的了解呢？那么接下来让我们尝试自己设计pisloth的动作吧。
+Through the previous courses, do you have a deeper understanding of Pisloth? And next let’s try to design the movement of Pisloth by ourselves.
 
 **Code**
 
@@ -26,9 +26,9 @@ DIY Action
 
 **How it works?**
 
-你可以通过 ``add_action`` 函数来自定义pisloth的动作，第一个参数是动作的名称，
-第二个参数是个二维数组，数组里的四个参数用于控制pisloth腿部的四个舵机。我们会在
-下一课进行详细介绍。
+You can customize the action of Pisloth through the ``add_action`` function, the first parameter is the name of the action,
+The second parameter is a two-dimensional array. The four parameters in the array are used to control the four servos of the Pisloth leg. 
+For how to choose the value we will introduce it in detail in the next lesson.
 
 .. code:: python
 
@@ -38,4 +38,4 @@ DIY Action
         [0,   0, 0,   0]
         ])
 
-然后用 ``do_action`` 函数让pisloth做动作查看实际效果。
+Then use the ``do_action'' function to make pisloth do the action to see the actual effect.

docs/source/diy_action2.rst

@@ -1,8 +1,8 @@
 DIY Action2
 ===============
 
-通过上一课，我们了解了如何用 ``add_action`` 函数自定义pisloth的动作。这节课我们会通过键盘直接控制pisloth腿部的四个舵机，可以让你
-对pisloth的腿部舵机有更直观的理解从而帮助你自定义一些更有趣的动作。
+Through the last lesson, we learned how to customize the action of Pisloth with the ``add_action`` function. In this lesson, we will directly control the four servos of the Pisloth leg through the keyboard, which allows you to
+have a more intuitive understanding of Pisloth's leg servos to help you customize some more interesting actions.
 
 **Code**
 
@@ -100,12 +100,9 @@ DIY Action2
 
 **How it works?**
 
-本程序分为两个部分，第一个部分读取按下的键盘的字符，第二部分是通过按下的键盘字符来控制四个舵机。
+This program is divided into two parts. The first part reads the characters of the pressed keyboard, and the second part controls the four servos by pressing the characters of the keyboard.
 
-``left_up_angle`` , ``left_down_angle`` , ``right_up_angle`` , 
-``right_down_angle`` 分别对应着函数 ``add_action`` 二维数组参数
-里面的四个值。我们通过按下预先设定好的键盘字符，来增加或减少这四个值从而控制
-pisloth腿部四个舵机的转动方向和幅度。
+``left_up_angle``, ``left_down_angle``, ``right_up_angle``, ``right_down_angle`` corresponds to the four values ​​in the parameters of the function ``add_action``. We increase or decrease these four values ​​by pressing the preset keyboard characters to control the rotation direction and amplitude of the four servos on the pisloth leg.
 
 .. code:: python
 

docs/source/dont_touch_me.rst

@@ -1,7 +1,7 @@
 Don\'t Touch Me
 ==================
 
-在这个项目中，我们会让Pisloth表达自己的小情绪，当你试着触摸Pisloth时，它会生气的说不要碰我，然后退后离开你。
+In this project, we will let Pisloth express his little emotions. When you try to touch Pisloth, He will be on his guard and get back from you.
 
 **Code**
 
@@ -43,7 +43,7 @@ Don\'t Touch Me
 
 **How it works?**
 
-实例化各种要用到的音乐类、pisloth以及红外感应模块的类
+Instantiate various classes of music, pislot and infrared sensor modules to be used.
 
 .. code:: python
 
@@ -53,7 +53,7 @@ Don\'t Touch Me
     sloth.set_offset([0,0,0,0])
     sonar = Ultrasonic(Pin("D0") ,Pin("D1"))
 
-红外感应模块读取你的手与pisloth的距离，设置判断条件，当这个距离小于或等于alert_distance时，pisloth会播放音频文件并做出backward和stand动作。
+The ultrasonic module reads the distance between your hand and the Pisloth and sets the judgment condition. When the distance is less than or equal to alert_distance, Pisloth will play the audio file and do ``backward`` and ``stand`` actions.
 
 .. code:: python
 

docs/source/emotional_pisloth.rst

@@ -1,8 +1,8 @@
 Emotional PiSloth
 =======================
 
-在这个项目，我们会让pisloth变得更加生动，我们会让它表现出更多人类的感情动作，
-当然学完这课后，你也可以自己设计更多的感情动作出来。
+In this project, we will make the Pisloth more vivid, and we will make it show more human emotions,
+of course, after learning this lesson, you can also design more emotional actions yourself.
 
 **Code**
 
@@ -133,7 +133,7 @@ Emotional PiSloth
 
 **How it works?**
 
-Pisloth播放sign.wav并执行 ``hook`` 动作表示confuse.
+Pisloth plays ``sign.wav`` and executes the ``hook'' action to indicate confuse.
 
 .. code:: python
 
@@ -144,7 +144,7 @@ Pisloth播放sign.wav并执行 ``hook`` 动作表示confuse.
             print(e)
         sloth.do_action('hook', 1, 100)  
 
-Pisloth播放happy2.wav并循环3次执行 ``hook`` 和 ``stand``  动作表示happy.
+Pisloth plays ``happy2.wav`` and executes the ``hook`` and ``stand'' actions 3 times to indicate happy.
 
 .. code:: python
 
@@ -157,7 +157,7 @@ Pisloth播放happy2.wav并循环3次执行 ``hook`` 和 ``stand``  动作表示h
             sloth.do_action('hook', 1, 100)
             sloth.do_action('stand', 1, 100)
 
-Pisloth播放warning.wav并执行 ``hook`` , ``stand`` , ``walk backward boldly`` 动作表示fear.
+Pisloth plays warning.wav and executes ``hook``, ``stand``, ``walk backward boldly`` actions to indicate fear.
 
 .. code:: python
 
@@ -175,7 +175,7 @@ Pisloth播放warning.wav并执行 ``hook`` , ``stand`` , ``walk backward boldly`
         sloth.do_action('walk backward boldly', 1, 100)
         sloth.do_action('stand', 1, 100)
 
-Pisloth播放depress.wav并执行 ``big swing`` 动作表示sad.
+Pisloth plays ``depress.wav`` and performs the ``big swing'' action to indicate sad.
 
 .. code:: python
 
@@ -186,7 +186,7 @@ Pisloth播放depress.wav并执行 ``big swing`` 动作表示sad.
             print(e)
         sloth.do_action('big swing', 1, 100)  
 
-Pisloth播放error.wav并执行 ``walk backward boldly`` 和 ``stand`` 动作表示angry.
+Pisloth plays ``error.wav`` and performs the ``walk backward boldly`` and ``stand`` actions to indicate angry.
 
 .. code:: python
 
@@ -198,7 +198,7 @@ Pisloth播放error.wav并执行 ``walk backward boldly`` 和 ``stand`` 动作表
         sloth.do_action('walk backward boldly', 1, 100)  
         sloth.do_action('stand', 1, 100)
 
-Pisloth播放depress2.wav并执行 ``fall left`` 动作表示fail.
+Pisloth plays ``depress2.wav`` and executes the ``fall left`` action to indicate a fall.
 
 .. code:: python
 
@@ -210,9 +210,10 @@ Pisloth播放depress2.wav并执行 ``fall left`` 动作表示fail.
         sloth.do_action('fall left', 1, 100)  
 
 .. note::
-    这个动作会让pisloth摔倒，注意别让它从桌子上落下摔坏。
+    This action will make the Pisloth fall, be careful not to let it fall off the table and break it.
 
-Pisloth播放talk3.wav,talk2.wav并执行 ``close`` , ``stand`` 动作表示shy.
+
+Pisloth plays ``talk3.wav``, ``talk2.wav`` and executes ``close``, ``stand'' action means shy.
 
 .. code:: python
 

docs/source/ezblock/conf.py

@@ -0,0 +1,62 @@
+# Configuration file for the Sphinx documentation builder.
+#
+# This file only contains a selection of the most common options. For a full
+# list see the documentation:
+# https://www.sphinx-doc.org/en/master/usage/configuration.html
+
+# -- Path setup --------------------------------------------------------------
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+#
+# import os
+# import sys
+# sys.path.insert(0, os.path.abspath('.'))
+import sphinx_rtd_theme
+
+html_theme = 'sphinx_rtd_theme'
+# -- Project information -----------------------------------------------------
+
+project = 'pisloth'
+copyright = '2021, sunfounder'
+author = 'sunfounder'
+
+
+# -- General configuration ---------------------------------------------------
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+]
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ['_templates']
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+# This pattern also affects html_static_path and html_extra_path.
+exclude_patterns = []
+
+
+# -- Options for HTML output -------------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+#
+html_theme = 'sphinx_rtd_theme'
+html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
+
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+html_static_path = ['_static']
+
+html_js_files = [
+    'https://ezblock.cc/readDocFile/topHead.js',
+]
+html_css_files = [
+    'https://ezblock.cc/readDocFile/topHead.css',
+]

docs/source/ezblock/dance_ez.rst

@@ -0,0 +1,32 @@
+Dance
+=========
+
+In this project, we would play a piece of music and make Pisloth dance to the rhythm of the music.
+
+Cute Pisloth and good music can put you in a good mood.
+
+**TIPS**
+
+.. image:: img/dance.png
+  :width: 400
+
+This block can play some music that we have preset.
+
+.. image:: img/dance2.png
+  :width: 400
+
+And then you can adjust the volume with this block.
+
+.. image:: img/dance4.png
+  :width: 250
+
+You may want to use repeat which can help you repeatedly execute the same statement and reduce code size.
+
+
+**EXAMPLE**
+
+.. image:: img/dance6.png
+
+.. image:: img/dance7.png
+
+.. image:: img/dance8.png