fine tune the doc setup

Author: refraction-ray

check_all.sh

@@ -9,5 +9,5 @@ pylint tensorcircuit tests
 echo "pytest check"
 pytest -n 4 --cov=tensorcircuit -vv -W ignore::DeprecationWarning
 echo "sphinx check"
-cd docs && make html
+cd docs && sphinx-build source build/html
 echo "all checks passed, congratulates! 💐"

docs/source/contribution.rst

@@ -146,7 +146,7 @@ We use `sphnix <https://www.sphinx-doc.org/en/master/>`__ to manage the document
 
 The source files for docs are .rst file in docs/source.
 
-For English docs, ``make html`` in docs dir is enough. The html version of the docs are in docs/build/html.
+For English docs, ``sphinx-build source build/html`` in docs dir is enough. The html version of the docs are in docs/build/html.
 
 **i18n:**
 

docs/source/generate_rst.py

@@ -1,4 +1,6 @@
-import os, glob, shutil
+import os
+import glob
+import shutil
 from os.path import join as pj
 
 

docs/source/index.rst

@@ -2,21 +2,19 @@ Guide to tensorcircuit
 ==================================
 
 .. toctree::
-    :maxdepth: 2
 
-    quickstart.rst
-    advance.rst
-    infras.rst
-    contribution.rst
-    
+   quickstart.rst
+   advance.rst
+   infras.rst
+   contribution.rst
+
 
 API References
 =======================
 
 .. toctree::
-    :maxdepth: 4
 
-    modules.rst
+   modules.rst
 
 
 Indices and tables