Merge pull request #219 from lnis-uofu/dev

Documentation Patches on Supporting PDF builds

docs/requirements.txt

@@ -11,6 +11,9 @@ sphinxcontrib-bibtex<2.0.0
 # Package required to embed youtube video
 sphinxcontrib-yt
 
+# Package required to convert svg for pdf builder
+sphinxcontrib-svg2pdfconverter
+
 #Work-around bug "AttributeError: 'Values' object has no attribute 'character_level_inline_markup'" with docutils 0.13.1
 #See:
 #  * https://github.com/sphinx-doc/sphinx/issues/3951

docs/source/conf.py

@@ -37,6 +37,12 @@ try:
 except ImportError:
     have_sphinxcontrib_youtube = False
 
+# Import sphinxcontrib.svg2pdfconverter
+have_sphinxcontrib_svg2pdfconverter = True
+try:
+    import sphinxcontrib.svg2pdfconverter
+except ImportError:
+    have_sphinxcontrib_svg2pdfconverter = False
 
 # -- Project information -----------------------------------------------------
 

docs/source/overview/motivation.rst

@@ -1,7 +1,9 @@
 Why OpenFPGA?
 -------------
 
-.. note:: If this is the first time you learn OpenFPGA, we strongly recommend you to watch the introduction video.
+.. note:: If this is the first time you learn OpenFPGA, we strongly recommend you to watch the `introduction video <https://youtu.be/ocODUGcYGqo>`_
+   
+.. only:: html
 
   .. youtube:: ocODUGcYGqo
 

docs/source/tutorials/compile.rst

@@ -3,7 +3,9 @@
 How to Compile
 --------------
 
-.. note:: We recommend you to watch a tutorial video about how-to-compile before getting started
+.. note:: We recommend you to watch a tutorial `video <https://youtu.be/F9sMRmDewM0>`_ about how-to-compile before getting started
+
+.. only:: html
 
   .. youtube:: F9sMRmDewM0
 

docs/source/tutorials/design_flow/generate_fabric.rst

@@ -3,7 +3,9 @@
 Generate Fabric Netlists
 ------------------------
 
-.. note:: You may watch the video representation of this tutorial
+.. note:: You may watch the `video <https://youtu.be/aJ0OkZ1uh68>`_ representation of this tutorial
+
+.. only:: html
 
   .. youtube:: aJ0OkZ1uh68