modernize docbuild (#760)

* inprogress

* remove templates in favor of main theme

doc/source/api/geometry.rst

@@ -7,6 +7,5 @@ Geometry
 
 .. autosummary::
    :toctree: _autosummary
-   :template: custom-class-template.rst
 
    mapdl_geometry.Geometry

doc/source/api/math.rst

@@ -8,7 +8,6 @@ These classes are specific to the ``MapdlMath`` module:
 
 .. autosummary::
    :toctree: _autosummary
-   :template: custom-class-template.rst
 
    math.MapdlMath
    math.ApdlMathObj

doc/source/api/mesh.rst

@@ -7,6 +7,5 @@ Mesh
 
 .. autosummary::
    :toctree: _autosummary
-   :template: custom-class-template.rst
 
    mesh_grpc.MeshGrpc

doc/source/api/parameters.rst

@@ -7,6 +7,5 @@ Parameters
 
 .. autosummary::
    :toctree: _autosummary
-   :template: custom-class-template.rst
 
    parameters.Parameters

doc/source/api/pool.rst

@@ -7,6 +7,5 @@ Local MAPDL Pool
 
 .. autosummary::
    :toctree: _autosummary
-   :template: custom-class-template.rst
 
    pool.LocalMapdlPool

doc/source/api/post.rst

@@ -16,6 +16,5 @@ you can use one of the following packages:
 
 .. autosummary::
    :toctree: _autosummary
-   :template: custom-class-template.rst
 
    post.PostProcessing

doc/source/api/solution.rst

@@ -7,7 +7,6 @@ Solution
 
 .. autosummary::
    :toctree: _autosummary
-   :template: custom-class-template.rst
 
    solution.Solution
 

doc/source/api/xpl.rst

@@ -6,6 +6,5 @@ Database Explorer
 
 .. autosummary::
    :toctree: _autosummary
-   :template: custom-class-template.rst
 
    xpl.ansXpl

doc/source/conf.py

@@ -4,13 +4,10 @@
 import pyvista
 import numpy as np
 from sphinx_gallery.sorting import FileNameSortKey
+from pyansys_sphinx_theme import pyansys_logo_black
 
-import sys
-
-sys.path.append("../..")
 from ansys.mapdl.core import __version__
 
-
 # Manage errors
 pyvista.set_error_output_file("errors.txt")
 
@@ -159,11 +156,10 @@
 
 # -- Options for HTML output -------------------------------------------------
 html_theme = "pyansys_sphinx_theme"
-html_logo = os.path.join("_static", "pyansys-logo-black-cropped.png")
+html_logo = pyansys_logo_black
 html_theme_options = {
     "github_url": "https://github.com/pyansys/pymapdl",
     "show_prev_next": False,
-    "logo_link": "https://docs.pyansys.com/",  # navigate to the main page
 }
 
 # -- Options for HTMLHelp output ---------------------------------------------

doc/source/index.rst

@@ -16,16 +16,17 @@ PyMAPDL Documentation
 
 Introduction and Purpose
 ------------------------
-PyMAPDL is part of the larger PyAnsys effort to facilitate the use 
-of Ansys technologies directly from Python. Its primary package,
-``ansys-mapdl-core``, provides:
-
-- scripting of MAPDL through both Python and Ansys Parametric Design
-  Language (APDL) syntax
-- plotting of MAPDL geometry and meshes using VTK from within a Python
-  script or an interactive Jupyter notebook
-- access to MAPDL arrays as Python objects (e.g. nodes, elements,
-  solution matrices, and results)
+PyMAPDL is part of the larger `PyAnsys <https://docs.pyansys.com>`_
+effort to facilitate the use of Ansys technologies directly from
+Python. Its primary package, ``ansys-mapdl-core``, provides:
+
+- Scripting of MAPDL through both Python and Ansys Parametric Design
+  Language (APDL) syntax.
+- Plotting of MAPDL geometry and meshes using `PyVista
+  <https://docs.pyvista.org>`_ from within a Python script or an
+  interactive `Jupyter notebook <https://jupyter.org/>`_.
+- Access to MAPDL arrays as Python objects (e.g. nodes, elements,
+  solution matrices, and results).
 
 With PyMAPDL it is easier than ever to integrate the simulation capabilities 
 of the Ansys MAPDL multi-physics solver directly into novel applications 
@@ -44,9 +45,10 @@ application. It is now open source: Enjoy it! Contributions are welcome.
 
 Background
 ----------
-PyMAPDL, based on gRPC, represents an improvement over its predecessor based
-on CORBA. These technologies allow the MAPDL solver to function as a server, 
-ready to respond to connecting clients.  
+PyMAPDL, based on `gRPC <https://grpc.io/>`_, represents an
+improvement over its predecessor based on CORBA. These technologies
+allow the MAPDL solver to function as a server, ready to respond to
+connecting clients.
 
 Google remote procedure calls, or gRPC, are used to establish secure 
 connections so that a client application can directly call methods on 
@@ -95,10 +97,10 @@ stored to the logging module or can be immediately printed out with
 
 Calling MAPDL Pythonically
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
-MAPDL functions can be called directly from an ``Mapdl`` instance in a
-pythonic manner.  This is to simplify calling MAPDL, especially when
-inputs are variables within Python.  For example, the following two
-commands are equivalent:
+MAPDL functions can be called directly from an :class:`Mapdl
+<ansys.mapdl.core.mapdl._MapdlCore>` instance in a pythonic manner.  This is to
+simplify calling MAPDL, especially when inputs are variables within
+Python.  For example, the following two commands are equivalent:
 
 .. code:: python
 
@@ -110,7 +112,7 @@ example, inputting points from a numpy array:
 
 .. code:: python
 
-   # make 10 random keypoints in ANSYS
+   # make 10 random keypoints in MAPDL
    points = np.random.random((10, 3))
    for i, (x, y, z) in enumerate(points):
        mapdl.k(i + 1, x, y, z)