readthedocs: hack to fetch git-lfs objects

Signed-off-by: Luís Ferreira <[email protected]>

Author: ljmf00

conf.py

@@ -7,8 +7,15 @@
 # http://www.sphinx-doc.org/en/master/config
 
 import os
+import sys
 from recommonmark.parser import CommonMarkParser
 
+# PYTHONPATH = docs/source
+DOC_SOURCES_DIR = os.path.dirname(os.path.abspath(__file__))
+PROJECT_ROOT_DIR = os.path.dirname(os.path.dirname(DOC_SOURCES_DIR))
+sys.path.insert(0, DOC_SOURCES_DIR)
+print('PROJECT_ROOT_DIR', PROJECT_ROOT_DIR)
+
 # -- Project information -----------------------------------------------------
 
 project = 'Aurora Learning Platform'
@@ -74,6 +81,13 @@
 #
 on_rtd = os.environ.get('READTHEDOCS', None) == 'True'
 
+# Hack for lacking git-lfs support ReadTheDocs
+if on_rtd:
+    print('Fetching files with git_lfs')
+    from git_lfs import fetch
+    fetch(PROJECT_ROOT_DIR)
+
+
 import sphinx_rtd_theme
 html_theme = 'sphinx_rtd_theme'
 html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]

requirements.txt

@@ -1 +1,2 @@
-sphinx-tabs
+sphinx-tabs
+git-lfs