Integrates sphinxcontrib.apidoc to generate low-level API docs.

ArtifexSoftware · Jan 16, 2024 · cd5d7d5 · cd5d7d5
1 parent 644f784
commit cd5d7d5
Show file tree

Hide file tree

Showing 3 changed files with 9 additions and 4 deletions.
diff --git a/doc/modules.rst → doc/api/modules.rst b/doc/modules.rst → doc/api/modules.rst
@@ -1,5 +1,5 @@
-API Documentation
-=================
+pdf2docx
+========
 
 .. toctree::
    :maxdepth: 4

diff --git a/doc/conf.py b/doc/conf.py
@@ -40,9 +40,14 @@ def get_version(fname):
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
 extensions = [
-    'sphinx.ext.autodoc'
+    'sphinxcontrib.apidoc'
 ]
 
+apidoc_module_dir = '../pdf2docx'
+apidoc_output_dir = 'api'
+apidoc_excluded_paths = []
+apidoc_separate_modules = True
+
 # Add any paths that contain templates here, relative to this directory.
 # templates_path = ['_templates']
 

diff --git a/doc/index.rst b/doc/index.rst
@@ -14,7 +14,7 @@ generate docx file with ``python-docx``.
    installation
    quickstart
    techdoc
-   modules
+   api/modules
 
 
 Indices and tables