docs: fix RTD timeout issue

doc/conf.py

@@ -32,36 +32,9 @@
 copyright = "2017-%d, DeepModeling" % date.today().year
 author = "DeepModeling"
 
-
-def run_apidoc(_):
-    import sys
-
-    from sphinx.ext.apidoc import (
-        main,
-    )
-
-    sys.path.append(os.path.join(os.path.dirname(__file__), ".."))
-    cur_dir = os.path.abspath(os.path.dirname(__file__))
-    module = os.path.join(cur_dir, "..")
-    main(
-        [
-            "-M",
-            "--tocfile",
-            "api_py",
-            "-H",
-            "Python API",
-            "-o",
-            os.path.join(cur_dir, "api_py"),
-            module,
-            "source/*",
-            "--force",
-        ]
-    )
-
-
-def setup(app):
-    # Add hook for building doxygen xml when needed
-    app.connect("builder-inited", run_apidoc)
+extensions = ["autoapi.extension"]
+autoapi_dirs = ["../deepmd"]
+autoapi_add_toctree_entry = False
 
 
 # -- General configuration ---------------------------------------------------
@@ -94,6 +67,7 @@
     "exhale",
     "sphinxcontrib.bibtex",
     "sphinx_design",
+    "autoapi.extension",
 ]
 
 # breathe_domain_by_extension = {

doc/index.rst

@@ -69,7 +69,7 @@ DeePMD-kit is a package written in Python/C++, designed to minimize the effort r
    development/type-embedding
    development/coding-conventions
    development/cicd
-   api_py/api_py
+   autoapi/deepmd/index
    api_op
    API_CC/api_cc
    api_c/api_c

pyproject.toml

@@ -92,6 +92,7 @@ docs = [
     "sphinx-argparse",
     "pygments-lammps",
     "sphinxcontrib-bibtex",
+    "sphinx-autoapi",
 ]
 lmp = [
     "lammps~=2023.8.2.3.0",