docs: fix wrong markdown links

Signed-off-by: Alessandro Comodi <[email protected]>

Author: acomodi

doc/requirements.txt

@@ -13,7 +13,7 @@ recommonmark
 sphinx-markdown-tables
 
 # Handle markdown cross-references
-git+https://github.com/SymbiFlow/sphinxcontrib-markdown-symlinks@bd0869b817568dce268bcdc3dc3dc7a7bd40c392
+git+https://github.com/SymbiFlow/sphinxcontrib-markdown-symlinks
 
 #Handle references in bibtex format
 #

doc/src/conf.py

@@ -82,14 +82,9 @@
 # Add any paths that contain templates here, relative to this directory.
 templates_path = []
 
-# Support rendering Markdown docs
-source_parsers = {
-    ".md": "markdown_code_symlinks.LinkParser",
-}
-
 # The suffix(es) of source filenames.
 # You can specify multiple suffix as a list of string:
-source_suffix = [".rst", ".md"]
+source_suffix = [".rst"]
 
 # The encoding of source files.
 # source_encoding = 'utf-8-sig'
@@ -379,6 +374,21 @@
             assert os.path.exists(prjdir) == True, "Regenerate doxygen XML for {}".format(prjname)
 
 
+def recommonmark_setup(app):
+    """Initialize Sphinx extension."""
+    import sphinx
+
+    if sphinx.version_info >= (1, 8):
+        app.add_source_suffix(".md", "markdown")
+        app.add_source_parser(LinkParser)
+
+    return {"version": recommonmark.__version__, "parallel_read_safe": True}
+
+
+# Override recommonmark setup
+recommonmark.setup = recommonmark_setup
+
+
 def setup(app):
     github_code_repo = "https://github.com/verilog-to-routing/vtr-verilog-to-routing/"
     github_code_branch = "blob/master/"