docs: Use custom template for api reference landing page

Author: femarchi

doc/source/_templates/index.rst

@@ -0,0 +1,12 @@
+API Reference
+=============
+
+This section contains PyRocky API endpoints, their capabilities, and how to interact with them
+programmatically [#f1]_.
+
+.. toctree::
+   :titlesonly:
+
+   /api/ansys/rocky/core/index
+
+.. [#f1] Created with `sphinx-autoapi <https://github.com/readthedocs/sphinx-autoapi>`_

doc/source/conf.py

@@ -2,11 +2,9 @@
 
 from datetime import datetime
 import os
-from pathlib import Path
 
 from ansys_sphinx_theme import (
     ansys_favicon,
-    get_autoapi_templates_dir_relative_path,
     get_version_match,
 )
 from ansys_sphinx_theme import pyansys_logo_black as logo
@@ -126,15 +124,13 @@
     "undoc-members",
     "show-inheritance",
     "show-module-summary",
-    "special-members",
+    # "special-members",  # exclude dunder methods
 ]
-autoapi_template_dir = get_autoapi_templates_dir_relative_path(Path(__file__))
+autoapi_template_dir = "_templates"
 suppress_warnings = ["autoapi.python_import_resolution"]
 autoapi_python_use_implicit_namespaces = True
 autoapi_keep_files = True
 autoapi_render_in_single_page = ["class", "enum", "exception"]
 
 # PyAnsys tags configuration
-html_context = {
-    "pyansys_tags": ['Fluids']
-}
+html_context = {"pyansys_tags": ["Fluids"]}