Versioning Docs (pytorch#474)

* Added method to version docs

* Update .travis.yml

.travis.yml

@@ -92,13 +92,12 @@ jobs:
 
       install:
         - pip install -r docs/requirements.txt
-        # `pip install .` vs `python setup.py install` : 1st works better to produce _module/ignite with source links
-        - pip install .
+        - pip install git+https://github.com/anmolsjoshi/sphinxcontrib-versioning.git
 
       script:
-        - cd docs && make html
+        - sphinx-versioning --use-master-conf build --whitelist-branches master docs/source docs/build/html
         # Create .nojekyll file to serve correctly _static and friends
-        - touch build/html/.nojekyll
+        - touch docs/build/html/.nojekyll
       after_success: # Nothing to do
 
       # Deploy built docs when PR is merged to master

docs/source/conf.py

@@ -12,9 +12,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('../..'))
 import ignite
 import sphinx_rtd_theme
 
@@ -25,7 +25,15 @@
 author = 'Torch Contributors'
 
 # The short X.Y version
-version = 'master (' + ignite.__version__ + ' )'
+try:
+    version = os.environ['code_version']
+    if 'master' in version:
+        version = 'master (' + ignite.__version__ + ')'
+    else:
+        version = version.replace('v', '')
+except KeyError:
+    version = ignite.__version__
+
 # The full version, including alpha/beta/rc tags
 release = 'master'