docs(api.rst): add table of contents and internal references for bett…

…er navigation and structure

docs/api.rst

@@ -1,7 +1,16 @@
 API Reference
 =============
 
-This section provides detailed API documentation for all CamTools modules.
+- :ref:`ct.camera <ct-camera>`
+- :ref:`ct.colmap <ct-colmap>`
+- :ref:`ct.convert <ct-convert>`
+- :ref:`ct.io <ct-io>`
+- :ref:`ct.metric <ct-metric>`
+- :ref:`ct.project <ct-project>`
+- :ref:`ct.raycast <ct-raycast>`
+- :ref:`ct.render <ct-render>`
+
+.. _ct-camera:
 
 > ct.camera
 ===========
@@ -13,6 +22,8 @@ This section provides detailed API documentation for all CamTools modules.
    :undoc-members:
    :show-inheritance:
 
+.. _ct-colmap:
+
 > ct.colmap
 ===========
 
@@ -23,6 +34,8 @@ This section provides detailed API documentation for all CamTools modules.
    :undoc-members:
    :show-inheritance:
 
+.. _ct-convert:
+
 > ct.convert
 ===========
 
@@ -33,6 +46,8 @@ This section provides detailed API documentation for all CamTools modules.
    :undoc-members:
    :show-inheritance:
 
+.. _ct-io:
+
 > ct.io
 =======
 
@@ -43,6 +58,8 @@ This section provides detailed API documentation for all CamTools modules.
    :undoc-members:
    :show-inheritance:
 
+.. _ct-metric:
+
 > ct.metric
 ===========
 
@@ -53,6 +70,8 @@ This section provides detailed API documentation for all CamTools modules.
    :undoc-members:
    :show-inheritance:
 
+.. _ct-project:
+
 > ct.project
 ===========
 
@@ -63,6 +82,8 @@ This section provides detailed API documentation for all CamTools modules.
    :undoc-members:
    :show-inheritance:
 
+.. _ct-raycast:
+
 > ct.raycast
 ===========
 
@@ -73,6 +94,8 @@ This section provides detailed API documentation for all CamTools modules.
    :undoc-members:
    :show-inheritance:
 
+.. _ct-render:
+
 > ct.render
 ===========