Fix tags and headers in sphinx-doc output (#11)

* Fix tags and headers in sphinx-doc output

* Move documentation action to correct path

README.rst

@@ -50,6 +50,7 @@ build from source to install the package.
    # Install to your python environment!
    python -m pip install .
 
+.. _quickstartexample:
 
 Quickstart Example
 ==================
@@ -91,10 +92,11 @@ Quickstart Example
    * - Isometric
      - Dimetric
      - Trimetric
-   * - .. image:: _static/iso.svg
-     - .. image:: _static/dim.svg
-     - .. image:: _static/tri.svg
+   * - .. image:: doc/source/_static/iso.svg
+     - .. image:: doc/source/_static/dim.svg
+     - .. image:: doc/source/_static/tri.svg
 
+.. _usageexample:
 
 Usage Example
 =============
@@ -166,4 +168,4 @@ In addition to convenience methods, `svg3d` allows full control over the viewpor
 
 Running the code above generates the following image:
 
-.. image:: _static/cube-wireframe.svg
+.. image:: doc/source/_static/cube-wireframe.svg

doc/source/index.rst

@@ -23,7 +23,9 @@
 
 .. include:: ../../README.rst
     :start-after: .. _imheader:
-    :end-before: Usage Example
+    :end-before: .. _quickstartexample:
+
+.. include:: quickstart.rst
 
 .. toctree::
    :maxdepth: 2

doc/source/quickstart.rst

@@ -1,6 +1,13 @@
-Quickstart Example
-==================
-
 .. include:: ../../README.rst
-    :start-after: Quickstart Example
-    :end-before: Usage Example
+    :start-after: .. _quickstartexample:
+    :end-before: .. list-table::
+
+.. list-table::
+   :header-rows: 1
+
+   * - Isometric
+     - Dimetric
+     - Trimetric
+   * - .. image:: _static/iso.svg
+     - .. image:: _static/dim.svg
+     - .. image:: _static/tri.svg

doc/source/usage-example.rst

@@ -1,5 +1,5 @@
-Usage Example
-==================
-
 .. include:: ../../README.rst
-    :start-after: Usage Example
+    :start-after: .. _usageexample:
+    :end-before: Running the code above generates the following image
+
+.. image:: _static/cube-wireframe.svg