From a02facd0b4f9c2d2c039f0d7dc5af8354ce0201b Mon Sep 17 00:00:00 2001 From: Santos Gallegos Date: Sat, 4 May 2019 23:33:50 -0500 Subject: Build docs locally Currently `make html` will output pages without styles or different than the online documentation. With this change the local documentation looks the same as the online documentation. --- .travis.yml | 3 ++- doc/requirements.txt | 2 ++ doc/source/conf.py | 10 +++------- 3 files changed, 7 insertions(+), 8 deletions(-) create mode 100644 doc/requirements.txt diff --git a/.travis.yml b/.travis.yml index 7939e161..206c133e 100644 --- a/.travis.yml +++ b/.travis.yml @@ -22,7 +22,8 @@ install: - git submodule update --init --recursive - git fetch --tags - pip install -r test-requirements.txt - - pip install codecov sphinx + - pip install -r doc/requirements.txt + - pip install codecov # generate some reflog as git-python tests need it (in master) - ./init-tests-after-clone.sh diff --git a/doc/requirements.txt b/doc/requirements.txt new file mode 100644 index 00000000..98e5c06a --- /dev/null +++ b/doc/requirements.txt @@ -0,0 +1,2 @@ +sphinx<2.0 +sphinx_rtd_theme diff --git a/doc/source/conf.py b/doc/source/conf.py index 2df3bbb6..96cbd667 100644 --- a/doc/source/conf.py +++ b/doc/source/conf.py @@ -30,7 +30,7 @@ sys.path.insert(0, os.path.abspath('../..')) extensions = ['sphinx.ext.autodoc', 'sphinx.ext.doctest'] # Add any paths that contain templates here, relative to this directory. -templates_path = ['.templates'] +templates_path = [] # The suffix of source filenames. source_suffix = '.rst' @@ -94,14 +94,10 @@ pygments_style = 'sphinx' # Options for HTML output # ----------------------- +html_theme = 'sphinx_rtd_theme' html_theme_options = { } -# The style sheet to use for HTML and HTML Help pages. A file of that name -# must exist either in Sphinx' static/ path, or in one of the custom paths -# given in html_static_path. -html_style = 'default.css' - # The name for this set of Sphinx documents. If None, it defaults to # " v documentation". #html_title = None @@ -121,7 +117,7 @@ html_style = 'default.css' # 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 = ['.static'] +html_static_path = [] # If not '', a 'Last updated on:' timestamp is inserted at every page bottom, # using the given strftime format. -- cgit v1.2.1