Updates to docs generation

Author: pgleeson

examples/document.md

@@ -38,7 +38,7 @@ A model for documents
 </table>
 
 ## Section
-A model of a section of the document. Will contain a <a href="#paragraph">Paragraph</a> or two
+A model of a section of the <a href="#document">Document</a>. Will contain one <a href="#paragraph">Paragraph</a> or more
 
 ### Allowed parameters
 <table>

examples/document.py

@@ -21,7 +21,7 @@ class Paragraph(Base):
 @modelspec.define
 class Section(Base):
     """
-    A model of a section of the document. Will contain a _Paragraph_ or two
+    A model of a section of the :class:`Document`. Will contain one :class:`Paragraph` or more
 
     Args:
         id: The id of the section

examples/document.rst

@@ -24,7 +24,7 @@ Allowed child    Data Type              Description
 =======
 Section
 =======
-A model of a section of the document. Will contain a Paragraph or two
+A model of a section of the <a href="#document">Document</a>. Will contain one <a href="#paragraph">Paragraph</a> or more
 
 **Allowed parameters**
 

src/modelspec/base_types.py

@@ -524,6 +524,35 @@ def _cls_generate_documentation(cls, format: str = MARKDOWN_FORMAT):
         rst_url_format = "`%s <%s>`_"
 
         def insert_links(text, format=MARKDOWN_FORMAT):
+
+            code_ref = ":code:`"
+            # print("    > Converting: %s" % text)
+            text2 = text
+            while code_ref in text2:
+                ind = text2.index(code_ref)
+                ind2 = text2.index("`", ind + len(code_ref) + 1)
+                pre = text2[0:ind]
+                ref = text2[ind + len(code_ref) : ind2]
+                post = text2[ind2 + 1 :]
+                text2 = f"{pre}<b>{ref}</b>{post}"
+            # print("    > Converted to: %s" % text2)
+            text = text2
+
+            class_ref = ":class:`"
+            # print("    > Converting: %s" % text)
+            text2 = text
+            while class_ref in text2:
+                ind = text2.index(class_ref)
+                ind2 = text2.index("`", ind + len(class_ref) + 1)
+                pre = text2[0:ind]
+                ref = text2[ind + len(class_ref) : ind2]
+                if ref[0] == "~":
+                    ref = ref[1:]
+                post = text2[ind2 + 1 :]
+                text2 = f'{pre}<a href="#{ref.lower()}">{ref}</a>{post}'
+            # print("    > Converted to: %s" % text2)
+            text = text2
+
             if "_" not in text:
                 return text
             if '"' in text: