From d9ff9bf28dbc5771ad47f3cad5c4a980299d60c6 Mon Sep 17 00:00:00 2001
From: Robert Winkler <rwinkler@antmicro.com>
Date: Mon, 24 Feb 2020 15:33:13 +0100
Subject: [PATCH] Add missing extensions and exclude patterns

This commit adds missing sphinx extensions and
additional exclude patterns to reduce the number of warnings

Signed-off-by: Robert Winkler <rwinkler@antmicro.com>
---
 requirements.txt |  5 ++++-
 source/conf.py   | 24 +++++++++++++++++++++---
 2 files changed, 25 insertions(+), 4 deletions(-)

diff --git a/requirements.txt b/requirements.txt
index 287110a..ced20bf 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,6 +1,9 @@
 Sphinx==2.4.0
 git+http://github.com/SymbiFlow/sphinx_materialdesign_theme.git@master#egg=sphinx_symbiflow_theme
-sphinx-markdown-tables
+sphinx-markdown-tables==0.0.12
 breathe==4.13.1
 symbolator==1.0.2
 sphinxcontrib-images==0.9.1
+recommonmark==0.6.0
+sphinxcontrib-bibtex==0.4.2
+sphinxcontrib-domaintools==0.2
diff --git a/source/conf.py b/source/conf.py
index 8d112ce..80c58bb 100644
--- a/source/conf.py
+++ b/source/conf.py
@@ -20,14 +20,23 @@ import sys, os
 # If your documentation needs a minimal Sphinx version, state it here.
 needs_sphinx = '1.6'
 
+# For VTR documentation support
+sys.path.append(os.path.abspath('./vtr-verilog-to-routing/doc/_exts'))
+
 # Add any Sphinx extension module names here, as strings. They can be extensions
 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
 extensions = [
     'sphinx.ext.todo',
+    'sphinx.ext.autodoc',
     'sphinx.ext.imgmath',  # breathe
     'breathe',
     'symbolator_sphinx',
-    'sphinxcontrib.images'
+    'sphinxcontrib.images',
+    'sphinxcontrib.bibtex',
+    'sdcdomain',
+    'archdomain',
+    'rrgraphdomain',
+    'recommonmark'
 ]
 
 numfig = True
@@ -36,7 +45,7 @@ numfig = True
 templates_path = ['_templates']
 
 # The suffix of source filenames.
-source_suffix = '.rst'
+source_suffix = ['.rst', '.md']
 
 # The encoding of source files.
 #source_encoding = 'utf-8-sig'
@@ -71,7 +80,16 @@ today_fmt = '%Y-%m-%d'
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
-exclude_patterns = []
+exclude_patterns = [
+    'symbiflow-arch-defs/*',
+    'symbiflow-arch-defs/third_party/**',
+    'prjtrellis/third_party/**',
+    'prjxray/third_party/**',
+    'prjxray/docs/db_dev_process/fuzzers/index/**',
+    'prjxray/docs/db_dev_process/minitests/index/**',
+    'vtr-verilog-to-routing/libs/EXTERNAL/**.md',
+    'vtr-verilog-to-routing/.github/**',
+]
 
 # The reST default role (used for this markup: `text`) to use for all documents.
 #default_role = None