doc: improvements

doc/conf.py

@@ -16,9 +16,9 @@
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
 #
-# import os
-# import sys
-# sys.path.insert(0, os.path.abspath('.'))
+import os
+import sys
+sys.path.insert(0, os.path.abspath('exts/'))
 
 
 # -- General configuration ------------------------------------------------
@@ -34,6 +34,7 @@ extensions = ['sphinx.ext.intersphinx',
     'sphinx.ext.todo',
     'sphinx.ext.imgmath',
     'sphinx.ext.ifconfig',
+    'inpar',              
     'sphinxcontrib.bibtex']
 
 # Setting up flags

doc/exts/.gitignore

+*.pyc

doc/exts/inpar.py

+def setup(app):
+    app.add_crossref_type('inpar', 'inpar', 'single: %s')
+    app.add_crossref_type('outpar', 'outpar', 'single: %s')    
+
+    return {'version': '0.1'}   # identifies the version of our extension