Rooba
/
boltons
mirror of https://github.com/mahmoud/boltons.git
1
1
Fork 0
Code Issues Packages Projects Releases Wiki Activity

debugging RTD issue #1692

This commit is contained in:
Mahmoud Hashemi 2015-09-24 12:14:34 -07:00
parent 492f607b85
commit 0c362c5cee
1 changed files with 11 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
docs/conf.py
View File

@ -15,7 +15,7 @@
import os import os
import sys import sys
import sphinx import sphinx
from pprint import pprint
# If extensions (or modules to document with autodoc) are in another directory, # 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 # add these directories to sys.path here. If the directory is relative to the
@ -26,6 +26,8 @@ PACKAGE_PATH = os.path.abspath(CUR_PATH + '/../boltons/')
sys.path.insert(0, PROJECT_PATH) sys.path.insert(0, PROJECT_PATH)
sys.path.insert(0, PACKAGE_PATH) sys.path.insert(0, PACKAGE_PATH)
pprint(os.environ)
def get_mod_stats(): def get_mod_stats():
# TODO: docstring percentage. # TODO: docstring percentage.
@ -117,8 +119,6 @@ intersphinx_mapping = {'python': ('https://docs.python.org/2.7', None)}
# The theme to use for HTML and HTML Help pages. See the documentation for # The theme to use for HTML and HTML Help pages. See the documentation for
# a list of builtin themes. # a list of builtin themes.
from pprint import pprint
pprint(os.environ) # tmp
on_rtd = os.environ.get('READTHEDOCS', None) == 'True' on_rtd = os.environ.get('READTHEDOCS', None) == 'True'
if not on_rtd: # only import and set the theme if we're building docs locally if not on_rtd: # only import and set the theme if we're building docs locally
import sphinx_rtd_theme import sphinx_rtd_theme
@ -131,7 +131,14 @@ if not on_rtd: # only import and set the theme if we're building docs locally
#html_theme_options = {} #html_theme_options = {}
# Add any paths that contain custom themes here, relative to this directory. # Add any paths that contain custom themes here, relative to this directory.
#html_theme_path = [] # html_theme_path = []
# TEMP: see https://github.com/rtfd/readthedocs.org/issues/1692
# Add RTD Theme Path.
if 'html_theme_path' in globals():
html_theme_path.append('/home/docs/checkouts/readthedocs.org/readthedocs/templates/sphinx')
else:
html_theme_path = ['_themes', '/home/docs/checkouts/readthedocs.org/readthedocs/templates/sphinx']
# The name for this set of Sphinx documents. If None, it defaults to # The name for this set of Sphinx documents. If None, it defaults to
# "<project> v<release> documentation". # "<project> v<release> documentation".