Included exhale to make prettier C++ API.

.gitignore

@@ -26,3 +26,4 @@ venv*
 .vscode/**
 _build
 _templates
+API_CC

doc/development/api.rst → doc/api.rst

@@ -1,5 +1,5 @@
-API
-===
+Python API
+==========
 
 .. toctree::
    :maxdepth: 2

doc/conf.py

@@ -99,15 +99,36 @@ def setup(app):
     "sphinx_rtd_theme",
     'myst_parser',
     'sphinx.ext.autosummary',
-    'breathe'
+    'breathe',
+    'exhale'
 ]
 
-breathe_domain_by_extension = {
-        "h" : "cpp",
-}
+# breathe_domain_by_extension = {
+#         "h" : "cpp",
+# }
 breathe_projects = {"myproject": "_build/xml/"}
 breathe_default_project = "myproject"
 
+exhale_args = {
+   "containmentFolder":     "./API_CC",
+    "rootFileName":          "api_cc.rst",
+    "rootFileTitle":         "C++ API",
+    "doxygenStripFromPath":  "..",
+    # Suggested optional arguments
+    # "createTreeView":        True,
+    # TIP: if using the sphinx-bootstrap-theme, you need
+    # "treeViewIsBootstrap": True,
+    # "exhaleExecutesDoxygen": True,
+    # "exhaleDoxygenStdin":    "INPUT = ../include"
+}
+
+# Tell sphinx what the primary language being documented is.
+primary_domain = 'cpp'
+
+# Tell sphinx what the pygments highlight language should be.
+highlight_language = 'cpp'
+
+# 
 myst_heading_anchors = 4
 
 # Add any paths that contain templates here, relative to this directory.

doc/development/index.md

@@ -1,5 +1,5 @@
 # Developer Guide
 
-- [API](api.rst)
-- [API of C++](api_cc.rst)
+- [Python API](../api.rst)
+- [C++ API](../API_CC/api_cc.rst)
 - [Coding Conventions](coding-conventions.rst)

setup.py

@@ -107,7 +107,7 @@
     cmake_minimum_required_version="3.0",
     extras_require={
         "test": ["dpdata>=0.1.9", "ase", "pytest", "pytest-cov", "pytest-sugar"],
-        "docs": ["sphinx", "recommonmark", "sphinx_rtd_theme", "sphinx_markdown_tables", "myst-parser", "breathe"],
+        "docs": ["sphinx", "recommonmark", "sphinx_rtd_theme", "sphinx_markdown_tables", "myst-parser", "breathe", "exhale"],
         **extras_require,
     },
     entry_points={"console_scripts": ["dp = deepmd.entrypoints.main:main"]},