112 lines
3.0 KiB
Python
112 lines
3.0 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']
|