88 lines
2.9 KiB
Python
88 lines
2.9 KiB
Python
# -*- coding: utf-8 -*-
|
|
# pylint: disable=invalid-name
|
|
# pylint: disable=redefined-builtin
|
|
# pylint: disable=protected-access
|
|
# pylint: disable=unused-argument
|
|
|
|
import os
|
|
from path import path
|
|
import sys
|
|
import mock
|
|
|
|
MOCK_MODULES = ['lxml', 'requests', 'xblock', 'fields', 'xblock.fields',
|
|
'frament', 'xblock.fragment', 'webob', 'multidict', 'webob.multidict', 'core',
|
|
'xblock.core', 'runtime', 'xblock.runtime', 'sortedcontainers', 'contracts',
|
|
'plugin', 'xblock.plugin', 'opaque_keys.edx.asides', 'asides',
|
|
'dogstats_wrapper', 'fs', 'fs.errors', 'edxmako', 'edxmako.shortcuts',
|
|
'shortcuts', 'crum', 'opaque_keys.edx.locator', 'LibraryLocator', 'Location']
|
|
|
|
for mod_name in MOCK_MODULES:
|
|
sys.modules[mod_name] = mock.Mock()
|
|
|
|
on_rtd = os.environ.get('READTHEDOCS', None) == 'True'
|
|
|
|
sys.path.append('../../../../')
|
|
|
|
from docs.shared.conf import *
|
|
|
|
|
|
# Add any paths that contain templates here, relative to this directory.
|
|
#templates_path.append('source/_templates')
|
|
|
|
|
|
# Add any paths that contain custom static files (such as style sheets) here,
|
|
# relative to this directory. They are copied after the builtin static files,
|
|
# so a file named "default.css" will overwrite the builtin "default.css".
|
|
#html_static_path.append('source/_static')
|
|
|
|
if not on_rtd: # only import and set the theme if we're building docs locally
|
|
import sphinx_rtd_theme
|
|
html_theme = 'sphinx_rtd_theme'
|
|
html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
|
|
|
|
|
|
# If extensions (or modules to document with autodoc) are in another directory,
|
|
# 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.
|
|
root = path('../../../..').abspath()
|
|
sys.path.insert(0, root)
|
|
sys.path.append(root / "common/lib/xmodule")
|
|
sys.path.append(root / "lms/djangoapps")
|
|
sys.path.append(root / "lms/djangoapps/mobile_api")
|
|
sys.path.append(root / "lms/djangoapps/mobile_api/course_info")
|
|
sys.path.append(root / "lms/djangoapps/mobile_api/users")
|
|
sys.path.append(root / "lms/djangoapps/mobile_api/video_outlines")
|
|
|
|
sys.path.insert(
|
|
0,
|
|
os.path.abspath(
|
|
os.path.normpath(
|
|
os.path.dirname(__file__) + '/../../../'
|
|
)
|
|
)
|
|
)
|
|
sys.path.append('.')
|
|
|
|
# django configuration - careful here
|
|
if on_rtd:
|
|
os.environ['DJANGO_SETTINGS_MODULE'] = 'lms'
|
|
else:
|
|
os.environ['DJANGO_SETTINGS_MODULE'] = 'lms'
|
|
|
|
|
|
# -- General configuration -----------------------------------------------------
|
|
|
|
# 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.autodoc', 'sphinx.ext.doctest', 'sphinx.ext.intersphinx',
|
|
'sphinx.ext.todo', 'sphinx.ext.coverage', 'sphinx.ext.pngmath',
|
|
'sphinx.ext.mathjax', 'sphinx.ext.viewcode', 'sphinxcontrib.napoleon']
|
|
|
|
project = u'edX Platform API Version 0.5 Alpha'
|
|
copyright = u'2015, edX'
|
|
|
|
exclude_patterns = ['build', 'links.rst']
|
|
|
|
|