Better

Author: pgleeson

examples/document.rst

@@ -18,11 +18,11 @@ Allowed field    Data Type    Description
 Allowed children
 ================
 
-===============  ====================  ==============================
-Allowed child    Data Type             Description
-===============  ====================  ==============================
-**sections**     `section <Section>`_  *The sections of the document*
-===============  ====================  ==============================
+===============  =====================  ==============================
+Allowed child    Data Type              Description
+===============  =====================  ==============================
+**sections**     `Section <#section>`_  *The sections of the document*
+===============  =====================  ==============================
 
 =======
 Section
@@ -42,11 +42,11 @@ Allowed field    Data Type    Description
 Allowed children
 ================
 
-===============  ========================  ================
-Allowed child    Data Type                 Description
-===============  ========================  ================
-**paragraphs**   `paragraph <Paragraph>`_  *The paragraphs*
-===============  ========================  ================
+===============  =========================  ================
+Allowed child    Data Type                  Description
+===============  =========================  ================
+**paragraphs**   `Paragraph <#paragraph>`_  *The paragraphs*
+===============  =========================  ================
 
 =========
 Paragraph

modelspec/BaseTypes.py

@@ -394,7 +394,7 @@ def insert_links(text, format=MARKDOWN_FORMAT):
                 if format==MARKDOWN_FORMAT:
                     text2 += '%s<a href="#%s">%s</a>' % (pre, type.lower(), type)
                 elif format==RST_FORMAT:
-                    text2 += ('%s'+rst_url_format) % (pre, type, type.lower())
+                    text2 += ('%s'+rst_url_format) % (pre, type, '#'+type.lower())
             if int(len(split) / 2.0) != len(split) / 2.0:
                 text2 += split[-1]
             return text2
@@ -454,7 +454,7 @@ def insert_links(text, format=MARKDOWN_FORMAT):
             if format == RST_FORMAT:
                 n = "**%s**" % f
                 t = "%s" % (
-                    rst_url_format % (type_, type_.lower())
+                    rst_url_format % (type_, '#'+type_.lower())
                     if referencable
                     else type_,
                 )
@@ -514,7 +514,7 @@ def insert_links(text, format=MARKDOWN_FORMAT):
             if format == RST_FORMAT:
                 n = "**%s**" % c
                 t = "%s" % (
-                    rst_url_format % (type_.lower(), type_)
+                    rst_url_format % (type_, '#'+type_.lower())
                     if referencable
                     else type_,
                 )